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
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 |
| Multiple Directory | * | 🟡 Will write the same content to both sources, in respective paths |
| 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 | Helm Chart w/values.yaml | ✅ Will update image-tag fields, will require helm-annotations to identify image-fields in values file |
| Multiple Directories | Helm Char w/referenced values.yaml | ✅ Will update image-tag fields, will require 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