Skip to main content

ビルドの優先順位

概要

Bitriseではビルドの優先順位を設定できます。-100から100の間の値を設定することで、キューに入っているビルドを実行する順序を決定できます。

デフォルトでは、ビルドは単純な時系列で実行されます。つまり、最初にトリガーされたビルドが最初に実行されます。ただし、ビルドの優先度を設定できるので、重要なビルドをキューの一番上にすばやく移動できます

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

次の優先順位を設定できます。

  • パイプラインとワークフロー。個々のワークフロー、またはパイプラインに優先順位を割り当てることができます。パイプラインに優先度を割り当てると、そのパイプラインを構成するすべてのワークフローに同じ優先度が割り当てられます

  • トリガー:各トリガー条件に優先順位を付けることができます。

  • 手動ビルド:UIまたはBitrise APIでビルドを開始する場合、キュー内での位置を決定する優先度を設定できます。

ビルドを手動で開始するときの優先度の設定

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

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

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

  2. メインプロジェクトページで、をクリックします。 ビルド開始。

  3. 選択してください [詳細] オプション。

    manual-build-priority.png

  4. 見つけて 優先順位 フィールドを入力し、-100～100 の間の整数値を設定します。デフォルト値は 0 です

ビルドトリガーの優先度の設定

ビルドトリガーの優先順位は、ワークフローエディターの GUI と構成 YAML ファイルで設定できます。トリガーの優先度はパイプラインとワークフローの優先度よりも優先されます

ワークフローエディター

コンフィギュレーション YAML

  1. ワークフローエディターを開きます。

  2. 必要なワークフローまたはパイプラインを選択します。

  3. に移動 トリガー タブ。

  4. 新しいトリガーを作成するか、既存のトリガーを編集して、 優先度 入力。

    trigger-priority.png

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

  1. 設定 YAML ファイルを開きます。

  2. パイプラインまたはワークフローでトリガーを検索します。

  3. を追加 優先度 -100～100 の整数値の入力:数値が大きいほど優先度が高くなります。デフォルト値は 0 です

    workflows:
  primary:
    steps:
    - activate-ssh-key: {}
    - git-clone: {}
    - deploy-to-bitrise-io: {}
    triggers:
      push:
      - branch: main
        priority: 10

パイプラインとワークフローの優先度の設定

優先順位は、-100から100の間の値を設定することで設定できます 優先度 任意のワークフローまたはパイプラインのプロパティ。デフォルト値は 0 です。

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

パイプライン優先度の設定

ワークフローエディター

コンフィギュレーション YAML

  1. ワークフローエディターを開きます。

  2. 左側で [] を選択します。 パイプライン。

  3. 必要なパイプラインを選択し、をクリックします [プロパティ]。

    pipeline-priority.png

  4. の中に 優先度 入力フィールドには、-100から100までの整数を入力してください。デフォルト値は 0 です

  1. 設定 YAML ファイルを開きます。

  2. 必要なパイプラインを見つけて追加してください priority -100から100までの整数値で入力してください。

    お持ちでない場合 priority 入力を設定すると、パイプラインのデフォルトの優先度は0になります。

    pipelines:
  best-pipeline:
    priority: 10

ワークフロー優先度の設定

ワークフローエディター

コンフィギュレーション YAML

  1. ワークフローエディターを開きます。

  2. 左側で [] を選択します。 ワークフロー。

  3. ドロップダウンメニューから必要なワークフローを選択し、 [プロパティ] 右側のタブ。

    workflow-priority.png

  4. の中に 優先度 入力フィールドには、-100から100までの整数を入力してください。デフォルト値は 0 です

  1. 設定 YAML ファイルを開きます。

  2. 必要なワークフローを見つけて追加してください priority -100から100までの整数値で入力してください。

    お持ちでない場合 priority 入力を設定すると、ワークフローの優先度はデフォルトで 0 になります。

    workflows:
  best-workflow:
    priority: 10

優先度設定の優先順位

次の優先度レベルを設定できます。

  • パイプラインとワークフロー。

  • トリガー。

  • 手動でトリガーされたビルド。

これらの優先順位は矛盾する可能性があります。たとえば、test というワークフローがあるとします。優先度は 10 です。このワークフローにはトリガーも設定されています。コードが開発ブランチにプッシュされるとトリガーされます。このトリガーの優先度は 15 です。

このようなシナリオでは、Bitriseは優先順位に従ってビルドの優先順位を決定します。

  1. 手動による上書き:手動でビルドを開始すると、他のすべての優先度設定が上書きされます。

  2. トリガー固有の優先度設定:トリガーの優先度設定は、トリガーされるパイプラインまたはワークフローの優先度設定よりも優先されます。

  3. パイプラインレベルの優先順位設定:パイプラインの優先順位は、パイプラインと同じ優先度が割り当てられている構成要素であるワークフローの優先度設定よりも優先されます。

  4. ワークフローレベルの設定:他の構成要素に優先度設定が指定されていない場合、ワークフローの優先順位によって全体的なビルドの優先順位が決まります。

例1

さまざまなレベルで優先順位を設定する方法を示すスニペットの例を次に示します。

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


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

この例では:

  • ワークフロー A をスタンドアロンビルドとして実行する場合、優先度は 0 (デフォルトの優先度値) になります。

  • ワークフロー B をスタンドアロンビルドとして実行する場合 (たとえば、コードがにプッシュされた場合) development ブランチ) の場合、優先度は 4 です。

  • コードがにプッシュされた場合 release ブランチ、ワークフロー B は優先度 2 でトリガーされます。

  • パイプライン P がトリガーされた場合、A と B の両方のワークフローが優先度 3 で実行されます。


このセクションの内容: