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
ビルドを手動で開始するときに優先度を設定できます。優先度は、ビルドの開始時に他のビルドがキューに入っている場合にのみ有効になります。
ビルドを手動で開始するときに設定した優先度は、他のすべての優先度よりも優先されます。
-
Bitrise CIを開き、プロジェクトを選択します。
-
プロジェクトのメインページで、Start buildをクリックします。
-
Advancedオプションを選択します。

-
Priorityフィールドを見つけ、-100 から 100 までの整数値を設定します。default valueは 0 です。
ビルドトリガーの優先度の設定Click to copy link
ビルドトリガーの優先度は、Workflow Editorの GUI と、の設定YAMLファイルで設定できます。トリガーの優先度は、PipelineおよびWorkflowの優先度よりも優先されます。
- Workflow Editor
- Configuration YAML
-
Workflow Editorを開きます。
-
必要なWorkflow or Pipelineを選択します。
-
Triggersタブに移動します。
-
新しいトリガーを作成するか、既存のトリガーを編集して、Priority入力を見つけます。

-
-100 から 100 までの整数値を設定します。数値が大きいほど優先度が高くなります。default valueは 0 です。
-
設定YAMLファイルを開きます。
-
PipelineまたはWorkflowでトリガーを見つけます。
-
-100 から 100 までの整数値を指定して、priority 入力を追加します。数値が大きいほど優先度が高くなります。default valueは 0 です。
workflows:primary:steps:- activate-ssh-key: {}- git-clone: {}- deploy-to-bitrise-io: {}triggers:push:- branch: mainpriority: 10
PipelinesとWorkflowsの優先度の設定Click to copy link
任意のWorkflowまたはPipelineの Priority プロパティに -100 から 100 までの値を設定することで、優先度を設定できます。default valueは 0 です。
Pipelineの優先度は、Workflowの優先度よりも優先されます。パイプラインがトリガーされて優先度が割り当てられると、その構成要素であるすべてのワークフローが同じ優先度でトリガーされます。
Pipelineの優先度の設定Click to copy link
- Workflow Editor
- Configuration YAML
-
Workflow Editorを開きます。
-
左側で Pipelines を選択します。
-
必要なPipelineを選択し、Propertiesをクリックします。
-
Propertiesタブを選択します。

-
Priority入力フィールドに、-100 から 100 までの整数を指定します。default valueは 0 です。
-
Configuration YAMLファイルを開きます。
-
必要なPipelineを見つけ、-100 から 100 までの整数値を指定して
priority入力を追加します。priority入力を設定しない場合、Pipelineのデフォルトの優先度は 0 になります。pipelines:best-pipeline:priority: 10
Workflowの優先度の設定Click to copy link
- Workflow Editor
- Configuration YAML
-
Workflow Editorを開きます。
-
左側で Workflows を選択します。
-
ドロップダウンメニューから必要なWorkflowを選択し、右側の Properties タブを選択します。

-
Priority入力フィールドに、-100 から 100 までの整数を指定します。default valueは 0 です。
-
Configuration YAMLファイルを開きます。
-
必要なWorkflowを見つけ、-100 から 100 までの整数値を指定して
priority入力を追加します。priority入力を設定しない場合、Workflowのデフォルトの優先度は 0 になります。workflows:best-workflow:priority: 10
優先度設定の優先順位Click to copy link
優先度は次の対象に設定できます。
- PipelinesとWorkflows
- トリガー
- 手動でトリガーされたビルド
これらの優先度は競合する場合があります。たとえば、test という名前のWorkflowがあり、その優先度が 10 だとします。このWorkflowには、development ブランチにコードがプッシュされるとトリガーされるトリガーも設定されており、このトリガーの優先度は 15 です。
このような場合、Bitriseは次の優先順位に従ってbuild priorityを決定します。
- 手動による上書き: ビルドを手動で開始すると、他のすべての優先度設定よりも優先されます。
- トリガー固有の優先度設定: トリガーの優先度設定は、そのトリガーが起動するPipelinesまたはWorkflowsの優先度設定よりも優先されます。
- Pipelineレベルの優先度設定: Pipelineの優先度は、その構成要素であるWorkflowsの優先度設定よりも優先され、それらはすべてPipelineと同じ優先度になります。
- 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 で実行されます。