メインコンテンツまでスキップ

1つのトリガーでの並列ビルドの開始

単一のトリガーで並列ビルドを開始するためのBuild Pipelinesの使用

クレジットベースのアカウントをお持ちで、単一のトリガーで複数のタスクを並列実行する予定がある場合は、Build Pipelinesの使用をお勧めします。詳しくはBuild Pipelinesをご覧ください。

同時実行数が2つ以上ある場合、またはクレジットベースのアカウントをお持ちの場合は、複数のビルドを同時に実行できます。作業をできるだけ簡単にするため、これらのビルドは単一のトリガーで自動的に開始できます。その仕組みを見ていきましょう。

この例では、1つのアプリのWorkflowsを3つ同時に実行するように設定しています。これらのWorkflowsをTrigger、Building、Testingと呼ぶことにします。Triggerという名前のワークフローはプルリクエストによってトリガーされ、その後このワークフローがBuildingとTestingをトリガーし、これらは同時に実行されます。

すべてのワークフローは、個別のクリーンな仮想マシン上で実行されます。また、異なるタイプのスタックで実行することもできます。Workflowのスタックを選択するには、アプリのWorkflow Editorに移動し、Stackタブを選択します。

いずれかのビルドが失敗した場合、そのビルドは失敗したビルドと見なされます。ビルドがWebhookによってトリガーされた場合、Bitriseは概要ビルド結果をGitプロバイダーに送信します。並列ビルドのいずれかが失敗した場合は、失敗ステータスが報告されます。

「子」ビルドに対するレポートなし

Bitriseは、他のすべてのビルドをトリガーした元の「親」ビルドについてのみ、Gitステータスレポートを送信します。「子」ビルドは、Gitプロバイダーにステータスレポートを送り返しません。

たとえば、ビルドAがビルドBとビルドCをトリガーする場合、Aが完了した時点でステータスレポートが送信されます。ただし、ビルドBとビルドCについては個別のステータスレポートは送信されません。

必要なもの:

  • パーソナルアクセストークン。
  • トークンを保存するシークレット環境変数。
  • Bitrise Start Build Step。
  • Bitrise Wait for Build Step。
CI上のBitrise Start Build Step

Bitrise Start Build Stepは、現在実行中のビルドのパラメーター(アプリスラッグ、ビルドスラッグ、ビルド番号など)を使用してBitrise APIを呼び出すため、ローカルでは使用できません。

bitrise.yml例

bitrise.ymlファイルはWorkflow Editorのbitrise.ymlタブで編集することも、ローカルで編集することもできます。以下の例はBitrise UIを中心に説明していますが、YAML形式を使用する場合は、こちらの例をご覧ください。

  1. ユーザー用のPersonal Access Tokenを作成します。

    Profile Settingsに移動し、左側のSecurityオプションを選択します。Generate newボタンをクリックします。

    Starting_parallel_builds_with_a_single_trigger.png

    トークンのコピー

    トークンが生成されたら、必ずコピーしてください。再度表示することはできません。

  2. アプリのWorkflow EditorのSecretsタブでシークレット環境変数を作成し、そのトークンを値として追加します。

    Starting_parallel_builds_with_a_single_trigger.png

    シークレットのキーには任意の名前を使用できます。$ACCESS_TOKENのようなシンプルなものをお勧めします。

  3. Trigger WorkflowにBitrise Start Build Stepを追加します。

    Bitrise Start Build Stepは、開始するすべてのビルドに環境変数$SOURCE_BITRISE_BUILD_NUMBERを設定する点に注意してください。Stepによってトリガーされた各ビルドはそれぞれ独自のビルド番号を持ちますが、ソースビルド番号はすべて同じになります。

  4. StepのBitrise Access Tokenインプットに、パーソナルアクセストークンを保存しているシークレット環境変数を追加します。Select secret variableボタンをクリックし、作成したキーを選択します。

    Starting_parallel_builds_with_a_single_trigger.png

  5. StepのWorkflowsインプットを見つけ、そこにBuildingとTestingを追加します。

    Starting_parallel_builds_with_a_single_trigger.png

  6. Trigger Workflowの最後のStepとしてBitrise Wait for Build Stepを追加します。

    ビルドステータスの確認

    Stepは、Stepで定義されたビルドのステータスを確認します。ビルドはBuild slugsインプットで定義されており、このスラッグはBitrise Start Build Stepの出力です。スラッグで定義されたビルドが実行されている間、Stepはそれが実行されているビルドを保持します。Stepに含まれるビルドのいずれかが失敗した場合、そのビルドは失敗します。

  7. StepのBitrise Access Tokenインプットに、パーソナルアクセストークンを保存しているシークレット環境変数を追加します。Select secret variableボタンをクリックし、作成したキーを選択します。

    Starting_parallel_builds_with_a_single_trigger.png

これで完了です。Triggerワークフローをトリガーすると、WorkflowのBitrise Start Build Stepが、同時に実行される2つのビルドをさらにトリガーします。これら2つのビルドが成功すると、Bitrise Wait for Build Stepによって最初のビルドが完了します。ビルドが成功したかどうかに関わらず、Gitホスティングプロバイダーには単一のステータスレポートが送信されます。

bitrise.ymlの例Click to copy link​

Trigger:
steps:
- build-router-start@0:
inputs:
- workflows: |-
Building
Testing
- access_token: "$BITRISE_API_KEY"
- build-router-wait@0:
inputs:
- access_token: "$BITRISE_API_KEY"