Promotion Steps Reference
Below is an overview of the available promotion steps that can be used in Promotion Templates and Promotion Tasks.
Custom steps
Execute command in user-provided image
argocd-update
Updates one or more Argo CD `Application` resources in various ways.
argocd-wait
Waits for one or more Argo CD Application resources to reach desired conditions.
compose-output
Composes output from one or more steps into new output.
copy
Copies files or the contents of entire directories from one specified location to another.
delete
Deletes a file or directory.
fail
Fails the promotion.
gha-dispatch-workflow
Dispatches GitHub Actions workflows using the workflow_dispatch event.
gha-wait-for-workflow
Waits for GitHub Actions workflow runs to complete with optional status validation.
git-clear
Deletes the entire contents of a specified Git working tree.
git-clone
Clones a remote Git repository and checks out specified revisions to working trees at specified paths.
git-commit
Commits all changes in a working tree to its checked out branch.
git-merge-pr
Merges an open pull request.
git-open-pr
Opens a pull request in a specified remote repository using specified source and target branches.
git-push
Pushes the committed changes in a specified working tree to a specified branch in the remote repository.
git-tag
Creates a new tag for the latest committed changes.
git-wait-for-pr
Waits for a specified open pull request to be merged or closed.
github-push
Pushes committed changes to a GitHub repository using the GitHub API, enabling the possibility of verified commits without associating a signing key with a user account.
hcl-update
Updates attribute values in HCL files to modify OpenTofu configuration.
helm-template
Renders a specified Helm chart to one or more files in a specified directory.
helm-update-chart
Updates the `dependencies` section of a specified Helm chart's `Chart.yaml` file.
http-download
Downloads files from HTTP/S URLs to enable integration with external file repositories and CDNs.
http
Makes an HTTP/S request to enable basic integration with a wide variety of external services.
jfrog-evidence
Manages evidence creation, verification, and deletion for artifacts in JFrog Artifactory.
jira
Integrates with Jira to manage issues, comments, and track promotion workflows.
json-parse
Parses a JSON file and extracts values based on specified expressions.
json-update
Updates the values of specified keys in any JSON file.
kustomize-build
Renders manifests from a specified directory containing a `kustomization.yaml` file to a specified file or to many files in a specified directory.
kustomize-set-image
Updates the `kustomization.yaml` file in a specified directory to reflect a different revision of a container image.
oci-download
Downloads OCI artifacts from a registry and extracts layer content to a specified file.
oci-push
Copies or retags OCI artifacts (container images, Helm charts) between registries.
send-message
Send a message to a specified destination, such as Slack or email, during the promotion process.
set-freight-alias
Updates the alias of a Freight resource.
set-metadata
Updates metadata on Stage or Freight resources during the promotion process.
snow-create
Integrates with ServiceNow to manage Change Requests, Incidents, Problems, etc., and track promotion workflows.
snow-delete
Integrates with ServiceNow to manage Change Requests, Incidents, Problems, etc., and track promotion workflows.
snow-query-for-records
Integrates with ServiceNow to manage Change Requests, Incidents, Problems, etc., and track promotion workflows.
snow-update
Integrates with ServiceNow to manage Change Requests, Incidents, Problems, etc., and track promotion workflows.
snow-wait-for-condition
Integrates with ServiceNow to manage Change Requests, Incidents, Problems, etc., and track promotion workflows.
tf-apply
Applies an OpenTofu configuration or saved plan to create, update, or delete infrastructure.
tf-output
Retrieves outputs from OpenTofu state for use in subsequent steps.
tf-plan
Executes an OpenTofu plan operation to preview infrastructure changes.
toml-parse
Parses a TOML file and extracts values based on specified expressions.
toml-update
Updates the values of specified keys in any TOML file.
untar
Extracts the contents of a tar (or gzipped tar) file to a specified location.
yaml-merge
Merges multiple YAML files into a single file.
yaml-parse
Parses a YAML file and extracts values based on specified expressions.
yaml-update
Updates the values of specified keys in any YAML file.