Builds and branches

Runway fetches up to two different kinds of builds:
Release Candidate (or RC, sometimes referred to as staging)
production (optional)
Runway will always fetch RC/staging builds. Runway will optionally fetch production builds if app/CI settings are defined such that production builds are different than RC/staging.
A build is defined by two things: the workflow that produces it, and the branch it is built from:
<workflow> + <branch> = build
So, in addition to fetching RC/staging builds, Runway will fetch production builds if there’s a distinct workflow for production or if a distinct branch is used for production (distinct == different than the branch defined for RC/staging builds).
Workflow
Value set in CI settings. Runway supports up to two different CI workflows:
RC/staging workflow (required/primary)
Release workflow (optional)
Branch
Runway assumes all builds are built from the app’s release branch(es), unless optional values are set in Integration settings:
RC/staging branch override
Deploy branch override
If an RC/staging branch override value is set, RC/staging builds are fetched using that branch instead of the release branch.
If a deploy branch override value is set, production builds will be fetched, and they will use that branch.
Examples
Release branch: release-branch
1.
RC/staging workflow: deploy
Release workflow: (none)
Staging branch override: (none)
Deploy branch override: (none)
RC/staging build = deploy + release-branch
Prod build = (none)
2.
RC/staging workflow: deploy
Release workflow: deploy-prod
Staging branch override: (none)
Deploy branch override: (none)
Staging build = deploy + release-branch
Prod build = deploy-prod + release-branch
3.
RC/staging workflow: deploy
Release workflow: (none)
Staging branch override: itunes-dist
Deploy branch override: (none)
Staging build = deploy + itunes-dist
Prod build = (none)
4.
RC/staging workflow: deploy
Release workflow: (none)
Staging branch override: (none)
Deploy branch override: itunes-dist
Staging build = deploy + release-branch
Prod build = deploy + itunes-dist
5.
RC/staging workflow: deploy
Release workflow: deploy-prod
Staging branch override: (none)
Deploy branch override: itunes-dist
Staging build = deploy + release-branch
Prod build = deploy-prod + itunes-dist
6.
RC/staging workflow: deploy-rc
Release workflow: deploy-prod
Staging branch override: development
Deploy branch override: (none)
Staging build = deploy-rc + development
Prod build = deploy-prod + release-branch

Branching strategies

Next - Getting started

Preparing your first release

Last modified 6mo ago

Copy link

Contents

Examples