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

Build priority

デフォルトでは、ビルドは単純な時系列順に実行されます。最初にトリガーされたビルドが最初に実行されます。ただし、build priorityを設定すると、重要なビルドをキューの先頭に優先的に移動できます。

-100 から 100 までの数値で優先度を割り当てることができます。値が大きいほど、ビルドの優先度が高くなります。優先度の高いビルドは、優先度の低いビルドよりも先に実行されます。デフォルトでは、すべてのビルドの優先度は 0 です。

優先度は次の対象に設定できます。

  • PipelinesとWorkflows: 個々の Worklows、さらにはPipelinesにも優先度を割り当てられます。Pipelineに優先度を割り当てると、その構成要素であるWorkflowsすべてに同じ優先度が割り当てられます
  • トリガー: 各トリガー条件に優先度を設定できます。
  • 手動ビルド: UI、Bitrise API、またはBitrise CLIからビルドを開始するときに、キュー内での位置を決める優先度を設定できます。
提供状況

build priority機能は、Teams、Pro、Enterprise プランのWorkspacesでのみ利用できます。これらのプランをご利用でなく、この機能にご興味がある場合は、お問い合わせください。

ビルドを手動で開始するときの優先度の設定Click to copy link​

ビルドを手動で開始するときに優先度を設定できます。優先度は、ビルドの開始時に他のビルドがキューに入っている場合にのみ有効になります。

ビルドを手動で開始するときに設定した優先度は、他のすべての優先度よりも優先されます。

  1. Bitrise CIを開き、プロジェクトを選択します。

  2. プロジェクトのメインページで、Start buildをクリックします。

  3. Advancedオプションを選択します。

    manual-build-priority.png

  4. Priorityフィールドを見つけ、-100 から 100 までの整数値を設定します。default valueは 0 です。

ビルドトリガーの優先度の設定Click to copy link​

ビルドトリガーの優先度は、Workflow Editorの GUI と、の設定YAMLファイルで設定できます。トリガーの優先度は、PipelineおよびWorkflowの優先度よりも優先されます。

  1. Workflow Editorを開きます。

  2. 必要なWorkflow or Pipelineを選択します。

  3. Triggersタブに移動します。

  4. 新しいトリガーを作成するか、既存のトリガーを編集して、Priority入力を見つけます。

    trigger-priority.png

  5. -100 から 100 までの整数値を設定します。数値が大きいほど優先度が高くなります。default valueは 0 です。

PipelinesとWorkflowsの優先度の設定Click to copy link​

任意のWorkflowまたはPipelineの Priority プロパティに -100 から 100 までの値を設定することで、優先度を設定できます。default valueは 0 です。

Pipelineの優先度は、Workflowの優先度よりも優先されます。パイプラインがトリガーされて優先度が割り当てられると、その構成要素であるすべてのワークフローが同じ優先度でトリガーされます。

Pipelineの優先度の設定Click to copy link​

  1. Workflow Editorを開きます。

  2. 左側で Pipelines を選択します。

  3. 必要なPipelineを選択し、Propertiesをクリックします。

  4. Propertiesタブを選択します。

    pipeline-priority.png

  5. Priority入力フィールドに、-100 から 100 までの整数を指定します。default valueは 0 です。

Workflowの優先度の設定Click to copy link​

  1. Workflow Editorを開きます。

  2. 左側で Workflows を選択します。

  3. ドロップダウンメニューから必要なWorkflowを選択し、右側の Properties タブを選択します。

    workflow-priority.png

  4. Priority入力フィールドに、-100 から 100 までの整数を指定します。default valueは 0 です。

優先度設定の優先順位Click to copy link​

優先度は次の対象に設定できます。

  • PipelinesとWorkflows
  • トリガー
  • 手動でトリガーされたビルド

これらの優先度は競合する場合があります。たとえば、test という名前のWorkflowがあり、その優先度が 10 だとします。このWorkflowには、development ブランチにコードがプッシュされるとトリガーされるトリガーも設定されており、このトリガーの優先度は 15 です。

このような場合、Bitriseは次の優先順位に従ってbuild priorityを決定します。

  1. 手動による上書き: ビルドを手動で開始すると、他のすべての優先度設定よりも優先されます。
  2. トリガー固有の優先度設定: トリガーの優先度設定は、そのトリガーが起動するPipelinesまたはWorkflowsの優先度設定よりも優先されます。
  3. Pipelineレベルの優先度設定: Pipelineの優先度は、その構成要素であるWorkflowsの優先度設定よりも優先され、それらはすべてPipelineと同じ優先度になります。
  4. Workflowレベルの設定: 他の構成要素に優先度が設定されていない場合、Workflowの優先度が全体のbuild priorityを決定します。

次のスニペットは、さまざまなレベルで優先度を設定する例です。

workflows:
A:
steps: []
B:
steps: []
priority: 4
triggers:
push:
- branch: release
priority: 2
- branch: development

pipelines:
P:
priority: 3
workflows:
A: {}
B: {}

この例では次のようになります。

  • Workflow A が単独のビルドとして実行される場合、優先度は 0 (デフォルトの優先度の値) です。
  • Workflow B が単独のビルドとして実行される場合 (たとえば、developmentブランチにコードがプッシュされた場合)、優先度は 4 です。
  • releaseブランチにコードがプッシュされると、Workflow B が優先度 2 でトリガーされます。
  • Pipeline P がトリガーされると、A と B の両方のWorkflowsが優先度 3 で実行されます。