Run promotion

Proposed runs only display changes to be made, while tracked runs apply (deploy) the proposed changes.

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

Prerequisites

1. The proposed run must point to a commit that is newer than the stack's current commit.
2. Allow run promotion is enabled in the stack settings of the stack(s) in which you'd like to promote runs.
3. User has the promote run role.

Enabling run promotion

1. Navigate to Ship Infra > Stacks.
2. Click the three dots beside the stack and select Settings.
3. Click Behavior.
4. Enable the Allow run promotion slider.

Promote from proposed run view

Assuming all prerequisites are met, you will see a Promote button on a proposed run. Click it to promote the proposed run into a tracked run.

Promote from a pull request

For Spacelift users using GitHub, a similar feature is available directly from the GitHub pull request. Assuming the prerequisites are met, you will see a Deploy button within the Checks tab of the pull request. This button will promote your proposed run into a tracked run.