Promotion Steps Reference
Below is an overview of the available promotion steps that can be used in Promotion Templates and Promotion Tasks.
Showing 59 of 59 steps
Git9
Clones a remote Git repository and checks out specified revisions to working trees at specified paths.
Deletes the entire contents of a specified Git working tree.
Commits all changes in a working tree to its checked out branch.
Pushes the committed changes in a specified working tree to a specified branch in the remote repository.
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.
Opens a pull request in a specified remote repository using specified source and target branches.
Waits for a specified open pull request to be merged or closed.
Merges an open pull request.
Creates a new tag for the latest committed changes.
Helm & Kustomize4
Updates the kustomization.yaml file in a specified directory to reflect a different revision of a container image.
Renders manifests from a specified directory containing a kustomization.yaml file to a specified file or to many files in a specified directory.
Updates the dependencies section of a specified Helm chart's Chart.yaml file.
Renders a specified Helm chart to one or more files in a specified directory.
Structured Data7
Updates the values of specified keys in any YAML file.
Parses a YAML file and extracts values based on specified expressions.
Merges multiple YAML files into a single file.
Updates the values of specified keys in any JSON file.
Parses a JSON file and extracts values based on specified expressions.
Updates the values of specified keys in any TOML file.
Parses a TOML file and extracts values based on specified expressions.
Files5
Copies files or the contents of entire directories from one specified location to another.
Writes literal or rendered content to a file.
Deletes a file or directory.
Archives a directory or file into a tar (or gzipped tar) file at a specified location.
Extracts the contents of a tar (or gzipped tar) file to a specified location.
Argo CD2
Flow Control & Metadata4
HTTP & Artifacts5
Makes an HTTP/S request to enable basic integration with a wide variety of external services.
Downloads files from HTTP/S URLs to enable integration with external file repositories and CDNs.
Downloads OCI artifacts from a registry and extracts layer content to a specified file.
Pushes OCI artifacts to a registry, either by copying/retagging between registries or by uploading a local archive.
Manages evidence creation, verification, and deletion for artifacts in JFrog Artifactory.
Approvals & Notifications4
Pauses a promotion until the required number of users approve, or one rejects, through the Kargo UI.
Pauses a promotion to collect structured input from a user through a form rendered in the Kargo UI.
Send a message to a specified destination, such as Slack or email, during the promotion process.
Records a custom, auditable event during a promotion, surfaced in the Akuity Platform audit log.
GitHub9
Creates a new GitHub issue and stores the issue number in Freight metadata for use across promotion stages.
Adds a comment to an existing GitHub issue or pull request and returns the comment ID for later updates or deletion.
Replaces the body of an existing GitHub issue or pull request comment.
Deletes a comment from a GitHub issue or pull request, typically used in failure cleanup steps.
Updates the title, body, state, labels, or assignees of an existing GitHub issue.
Fetches a single GitHub issue by number, or searches issues in a repository using a query string.
Blocks a promotion stage until an expression evaluated against a GitHub issue succeeds, or fails the step immediately if a failure expression matches.
Dispatches GitHub Actions workflows using the workflow_dispatch event.
Waits for GitHub Actions workflow runs to complete with optional status validation.
Terraform & OpenTofu4
Updates attribute values in HCL files to modify OpenTofu configuration.
Executes an OpenTofu plan operation to preview infrastructure changes.
Applies an OpenTofu configuration or saved plan to create, update, or delete infrastructure.
Retrieves outputs from OpenTofu state for use in subsequent steps.
Change Management6
Integrates with Jira to manage issues, comments, and track promotion workflows.
Creates a ServiceNow record, such as a change request or incident, and outputs its number and sys_id.
Updates fields on an existing ServiceNow record.
Queries a ServiceNow table and outputs the first matching record.
Waits for a field on a ServiceNow record to reach a specified value before the promotion continues.
Deletes a ServiceNow record.