Initially setting up Octopus to interact with your Argo CD instance(s) can be complex, and the best way to accomplish your desired outcomes may not be immediate obvious.
The following explores how best to use Octopus for various Argo CD Application shapes.
Global Constraints
There are a number of use cases which Octopus cannot support due to data access.
- Octopus will not update “pinned”
TargetRevisionsin yourApplication.yaml- Octopus will only update content in the repositories referenced by your application- If your application specifies a constant
TargetRevision, Octopus will treat it as a branch - and fail to push back to your repository.
- If your application specifies a constant
- Octopus cannot update the content of Helm Sources as they typically references a chart from a Helm Repository or OCI feed which is static content.
- However, if your application is represented as a helm chart in a directory, Octopus can interact with the directory content via the applications repository
- Octopus can currently only create Pull Requests for GitHub-based repositories. Please let us know which other providers you would like to see supported.
Update Argo Manifest Step
| Argo Source Type | Repository Content | Behavior |
|---|---|---|
| Directory | Kubernetes Yaml | ✅ Will successfully inject Octopus variables to the yaml |
| Directory | Kubernetes Yaml | ✅ Will successfully inject Octopus variables to the yaml |
| Directory | Helm Chart | ✅ Will successfully inject variables to any file in the repository’s path |
| Directory | Kustomize | ✅ Will successfully inject variables to any file in the repository’s path |
| Multiple Source | Any | ❌ Not currently supported - work coming to update specifically referenced sources |
| Helm | Helm Chart | ❌ Not currently supported - work coming to update referenced values.yaml files |
Update Argo Image Tags
| Argo Source Type | Repository Content | Behavior |
|---|---|---|
| Directory | Kubernetes Yaml | ✅ Will update image-tag fields without requiring additional annotations |
| Directory | Kustomize | ✅ Will replace image tag values in the kustomize file |
| Directory | Helm Chart w/internal values.yaml | ✅ Will update image-tag fields, requires helm-annotations to identify image-fields in values file |
| Multiple Directories | Helm Chart w/referenced values.yaml | ✅ Will update image-tag fields, requires multiple helm annotations |
Help us continuously improve
Please let us know if you have any feedback about this page.
Page updated on Monday, September 15, 2025