Overview

Octopus offers two in-built steps which are able to modify a mapped Argo CD application in different ways:

  1. Update Argo CD Application Image Tags
  2. Update Argo CD Application Manifests

Update Argo CD Application Image Tags

This step is responsible for identifying images referenced by an application, and updating their image-tags to the value defined in the Octopus Deployment.

For ‘Basic Yaml’ and ‘Kustomize’ based Argo CD Applications, the behavior for performing the update relies on the known structure of the kubernetes/kustomize yaml to ensure the correct fields are updated.

However, for Helm-based Argo CD Applications, where image-tags are specified within the values.yaml file, additional information is required to explicitly define which fields in the values represent an image reference.

See Helm annotations for more information and examples.

You can read more about this step here.

Update Argo CD Application Manifests

This step is responsible for populating an Argo CD Application’s Git repository with content generated by populating user-provided templates with Octopus Variables.

You can read more about this step here.

Help us continuously improve

Please let us know if you have any feedback about this page.

Send feedback

Page updated on Monday, September 15, 2025