Update Argo CD Application Image Tags

Octopus.ArgoCDUpdateImageTags exported 2026-07-22 by Octopus Deploy belongs to ‘Kubernetes’ category.

Update image tags in your manifests and commit the changes to Git for Argo CD to deploy.

Parameters

When this step is included in a project’s deployment process, the parameters below can be set.

Container image

Octopus.Action.Package.PackageId (required)

The container image whose tag is updated in the target manifests.

Example: myorg/my-app

Container registry

Octopus.Action.Package.FeedId (required)

The container registry (feed) the image is resolved from.

Example: octopus-server-built-in

Download on worker/target

Octopus.Action.Package.DownloadOnTentacle

If true, the package is acquired by the worker/target rather than by the Octopus Server.

Allowed values: True, False

Default: False

Commit method

Octopus.Action.ArgoCD.CommitMethod

How the updated manifests are written back to Git.

Allowed values: DirectCommit, PullRequest, PerEnvironment

Commit message summary

Octopus.Action.ArgoCD.CommitMessageSummary

Summary line of the Git commit Octopus creates.

Example: Octopus Deploy updated image versions

Commit message description

Octopus.Action.ArgoCD.CommitMessageDescription

Optional extended body appended to the Git commit message.

Verification method

Octopus.Action.ArgoCD.StepVerification.Method

How the step verifies the change after committing to Git.

Allowed values: CommitCreated, PullRequestMerged, ArgoCDApplicationHealthy, ArgoCDApplicationExists

Verification timeout

Octopus.Action.ArgoCD.StepVerification.Timeout

Optional timeout for the verification method, as a duration (e.g. 00:10<00>).

Sync mode

Octopus.Action.ArgoCD.Sync.Mode

Whether Octopus triggers an Argo CD sync after committing, and across which environments.

Allowed values: Disabled, AllEnvironments, PerEnvironment

Step configuration using OCL

Example in Octopus Configuration Language (OCL):

step "update-argocd-image-tags" {
    name = "Update ArgoCD Image Tags"

    action {
        action_type = "Octopus.ArgoCDUpdateImageTags"
        properties = {
            Octopus.Action.ArgoCD.CommitMessageSummary = "Octopus Deploy updated image versions"
            Octopus.Action.ArgoCD.CommitMethod = "DirectCommit"
            Octopus.Action.ArgoCD.StepVerification.Method = "ArgoCDApplicationHealthy"
            Octopus.Action.ArgoCD.Sync.Mode = "AllEnvironments"
            Octopus.Action.Package.DownloadOnTentacle = "False"
            Octopus.Action.Package.FeedId = "octopus-server-built-in"
            Octopus.Action.Package.PackageId = "myorg/my-app"
        }
        worker_pool = "default-worker-pool"

        packages {
            acquisition_location = "Server"
            feed = "octopus-server-built-in"
            package_id = "myorg/my-app"
        }
    }
}

Page updated on Wednesday, July 22, 2026