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