Update Argo CD Application Manifests

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

Generate manifests from templates using Octopus variables and commit new or updated manifests 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.

Template source

Octopus.Action.Script.ScriptSource

Where the manifest templates are sourced from.

Allowed values: GitRepository, Package

Example: GitRepository

Git repository

Octopus.Action.GitRepository.Source

Which Git repository supplies the templates when sourcing from Git.

Allowed values: Project, External

File path filters

Octopus.Action.GitRepository.FilePathFilters

Glob/path filter(s) selecting the template files within the Git repository.

Example: k8s/manifests

Input path

Octopus.Action.ArgoCD.InputPath

Path within the source containing the manifest templates to process.

Example: k8s/manifests

Purge output folder

Octopus.Action.ArgoCD.PurgeOutputFolder

If true, purge the output folder before generating manifests.

Allowed values: True, False

Commit method

Octopus.Action.ArgoCD.CommitMethod

How the generated 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: Updated Manifests with Release: #{Octopus.Release.Number}

Verification method

Octopus.Action.ArgoCD.StepVerification.Method

How the step verifies the change after committing to Git.

Allowed values: CommitCreated, PullRequestMerged, ArgoCDApplicationHealthy, ArgoCDApplicationExists

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-manifests" {
    name = "Update ArgoCD Manifests"

    action {
        action_type = "Octopus.ArgoCDUpdateManifests"
        is_disabled = true
        properties = {
            Octopus.Action.ArgoCD.CommitMessageSummary = "Updated Manifests with Release: #{Octopus.Release.Number}"
            Octopus.Action.ArgoCD.CommitMethod = "DirectCommit"
            Octopus.Action.ArgoCD.InputPath = "k8s/manifests"
            Octopus.Action.ArgoCD.StepVerification.Method = "ArgoCDApplicationHealthy"
            Octopus.Action.ArgoCD.Sync.Mode = "AllEnvironments"
            Octopus.Action.GitRepository.FilePathFilters = "k8s/manifests"
            Octopus.Action.GitRepository.Source = "Project"
            Octopus.Action.Script.ScriptSource = "GitRepository"
        }
        worker_pool = "default-worker-pool"
    }
}

Page updated on Wednesday, July 22, 2026