Spacelift
PrivacyT&Cs
  • 👋Hello, Spacelift!
  • 🚀Getting Started
  • 🌠Main concepts
    • Stack
      • Creating a stack
      • Stack settings
      • Organizing stacks
      • Stack locking
      • Drift detection
    • Configuration
      • Environment
      • Context
      • Runtime configuration
        • YAML reference
    • Run
      • Task
      • Proposed run (preview)
      • Tracked run (deployment)
      • Module test case
      • User-Provided Metadata
      • Run Promotion
      • Pull Request Comments
    • Policy
      • Login policy
      • Access policy
      • Approval policy
      • Initialization policy
      • Plan policy
      • Push policy
      • Task policy
      • Trigger policy
    • Resources
    • Worker pools
    • VCS Agent Pools
  • 🛰️Platforms
    • Terraform
      • Module registry
      • External modules
      • Provider
      • State management
      • Terragrunt
      • Version management
      • Handling .tfvars
      • CLI Configuration
      • Cost Estimation
      • Resource Sanitization
      • Storing Complex Variables
      • Debugging Guide
    • Pulumi
      • Getting started
        • C#
        • Go
        • JavaScript
        • Python
      • State management
      • Version management
    • CloudFormation
      • Getting Started
      • Reference
      • Integrating with SAM
      • Integrating with the serverless framework
    • Kubernetes
      • Getting Started
      • Authenticating
      • Custom Resources
      • Helm
      • Kustomize
  • ⚙️Integrations
    • Audit trail
    • Cloud Integrations
      • Amazon Web Services (AWS)
      • Microsoft Azure
      • Google Cloud Platform (GCP)
    • Source Control
      • GitHub
      • GitLab
      • Azure DevOps
      • Bitbucket Cloud
      • Bitbucket Datacenter/Server
    • Docker
    • GraphQL API
    • Single sign-on
      • GitLab OIDC Setup Guide
      • Okta OIDC Setup Guide
      • OneLogin OIDC Setup Guide
      • Azure AD OIDC Setup Guide
      • AWS IAM Identity SAML 2.0 Setup Guide
    • Slack
    • Webhooks
  • 📖Product
    • Privacy
    • Security
    • Support
      • Statement of Support
    • Disaster Continuity
    • Billing
      • Stripe
      • AWS Marketplace
    • Terms and conditions
    • Refund Policy
  • Cookie Policy
Powered by GitBook
On this page
  • What is Run Promotion?
  • Using Run Promotion

Was this helpful?

  1. Main concepts
  2. Run

Run Promotion

Describes the process of promoting proposed runs into tracked runs on Spacelift.

PreviousUser-Provided MetadataNextPull Request Comments

Last updated 3 years ago

Was this helpful?

What is Run Promotion?

As a quick summary of the differences between the two types of runs: runs only display changes to be made, while runs apply (deploy) the proposed changes.

Promoting a proposed run is triggering a tracked run for the same Git commit.

Using Run Promotion

Pre-Requisites

1) For a run to be promote-able, the proposed run must point to a commit that is newer than the stack's current commit.

2) To promote a run, you first need to ensure that you have Allow run promotion enabled in the stack settings of your stack(s) in which you'd like to promote runs.

Stack Settings > Behavior > Advanced Options > Allow Run Promotion

Promote from Proposed Run View

Assuming you've enabled Run Promotion within the stack settings, and the commit to be promoted is newer than the stack's current commit. On a given proposed run, you will then see the "Promote" button as seen in the screenshot below. You simply need to click this button to promote the proposed run into a tracked run.

Promote from a Pull Request

For Spacelift users utilizing GitHub, a similar feature is available directly from the GitHub Pull Request. Assuming the same criteria is met as mentioned previously: 1) The commit to be promoted is newer than the stack's current commit 2) Run Promotion is enabled on the stack - Then, you will see a Deploy button available within the Checks tab of the pull request. This button will promote your proposed run into a tracked run.

🌠
proposed
tracked
Enable the Allow run promotion feature within the Spacelift Stack's Settings.
Promote a proposed run within Spacelift using the Promote button.
Promote a run from a GitHub Pull Request using the Deploy button.