Configuring release automation

Abstract

You can specify events in the release management process that triggers a selected Workflow or Pipeline. For example, you can create an automation that triggers a Workflow whenever an App Store review is cancelled.

Standard plan only

This feature is only available on the Standard plan. It is not available on a Basic plan.

Env Vars from Release Management

Release Management passes over certain Environment Variables to your builds at the Release candidate stage and later at the Release stage: Table 4, “Environment Variables passed to the builds from Release Management”. You can use these Env Vars in your builds triggered by automations.

To configure a release automation:

Configuring automations for a release

You can configure automations separately for each individual release:

Open your release.
Select Configuration on the left navigation bar.
Go to the Automation tab.
Click Add automation.
Under the Event field, select a release management event that will trigger the Workflow or Pipeline.
Set the automation type to either Workflow or Pipeline.
Click Add automation.

Configuring automations as a release preset

You can configure automations as a release preset. These automation settings will be applied to every new release afterwards.

Open Release Management and select your connected app.
Select Presets from the left navigation menu.
Find to the Automation section and open it.
Click Add automation.
Under the Event field, select a release management event that will trigger the Workflow or Pipeline.
Set the automation type to either Workflow or Pipeline.
Click Add automation.

Automation events

Table 1. RM events for iOS apps

Stage	Event	Event description
Release candidate	Release candidate set	This event is triggered each time there is a new release candidate is selected in the Release candidate stage. This can happen automatically (a new build generated a new IPA) or manually (the release manager locks a specific artifact on the Release candidate stage).
TestFlight upload	Upload and processing finished	This event is triggered when TestFlight processing is finished for an uploaded IPA. First we upload the IPA to TestFlight, then the TestFlight processing starts. When the processing finishes, we trigger the event.
	Approved by TestFlight App Review	This event is triggered when Apple approves the beta app review that is required for sharing the app with external beta testers.
	Rejected by TestFlight App Review	This event is triggered when Apple rejects the beta app review that is required for sharing the app with external beta testers.
Approvals	Release approved	This event is triggered when all tasks are approved at the Approval stage. It will not be triggered for each approval, only when all tasks are done.
App Store review	Release sent for review	This event happens when the store review submission starts. (Release Manager clicks on the submit button, and Apple accepts it)
App Store review	Status of review submission changed	This event is triggered each time there is a change in the status of the review submission. (Approved, rejected, canceled)
Release	Release started	This event is triggered after the submission was accepted, and the release rollout started (so the new version becomes available in App Store Connect)
Release	Release finished	This event is triggered when the release in Release Management completes.

Table 2. RM events for Android apps

Stage	Event	Event description
Release candidate	Release candidate set	This event is triggered each time there is a new release candidate is selected in the Release Candidate stage. This can happen automatically (a new build generated a new AAB) or manually (the release manager locks a specific artifact on the Release candidate stage).
Google Play upload	Upload and processing finished	This event is triggered after the AAB is uploaded to Google Play console and is available in the App bundle explorer.
Google Play upload	Release on testing track	This event is triggered after the release candidate is released on a Google Play testing track.
Approvals	Release approved	This event is triggered when all tasks are approved at the Approval stage. It will not be triggered for each approval, only when all tasks are done.
Release	Release started	This event is triggered when a release is started. It can be a full release or a staged rollout. For a staged rollout, it only happens once, at the first rollout.
	Release finished	This event is triggered when release is completed in Release Management.
	Rollout percentage changed	This event is triggered if the rollout percentage changes from any percentage other than 0%. For example, if the rollout percentage goes from 10% to 20%. It is NOT triggered when the first rollout happens.

In this section: