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

ビルド用スタックの設定

ビルドスタックは、ビルドの実行に使用する仮想マシンのバージョンを示します。すべてのビルドに対してスタックを設定することも、Workflowごとにスタックを設定することもできます。

APIを使用したマシンタイプの変更

1人のユーザーまたはWorkspaceが所有するすべてのアプリのbuild machineタイプを、APIを使用して変更することもできます: すべてのアプリのマシンタイプを一括で変更する。

Workflow Editorでのスタックの設定Click to copy link​

ビルドスタックを設定する最も簡単な方法は、Workflow Editorで設定することです。デフォルトスタックと、Workflowごとのスタックの両方を設定できます。

デフォルトスタックの設定Click to copy link​

プロジェクトのデフォルトスタックは、Workflowに特定のスタックを設定していない場合に使用されるスタックです。

プロジェクトタイプ

アプリの Settings タブでプロジェクトタイプを、選択したデフォルトスタックと互換性のないタイプに変更すると、スタックは自動的に互換性のあるスタックに変更されます。

  1. Bitrise にアクセスして Log in、左側の Bitrise CI を選択し、プロジェクトを選択します。

  2. メインページの Workflows ボタンをクリックします。

  3. 左側のメニューで Stacks & Machines を選択します。

  4. Default stack & machine セクションでドロップダウンメニューを開き、必要なスタックを選択します。

  5. 右上の Save changes をクリックします。

Workflowごとのスタックの設定Click to copy link​

Workflowにスタックを設定すると、デフォルトスタックに関係なく、そのWorkflowは常にそのスタックで実行されます。

  1. Bitrise にアクセスして Log in、左側の Bitrise CI を選択し、プロジェクトを選択します。

  2. メインページの Workflows ボタンをクリックします。

  3. 左側のメニューで Stacks & Machines を選択します。

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

    Stacks & MachinesページのWorkflowsタブ

  5. 必要なWorkflowを見つけて、スタックを選択します。

  6. 右上の Save changes をクリックします。

Workflow Editorでのマシンタイプの設定Click to copy link​

ビルドで使用するマシンタイプをWorkflow Editorで定義できます。利用可能なマシンタイプは、使用するスタックの種類によって異なります: Build machineタイプ。

マシンタイプを設定するには、次の手順を実行します。

  1. Bitrise にアクセスして Log in、左側の Bitrise CI を選択し、プロジェクトを選択します。

  2. メインページの Workflows ボタンをクリックします。

  3. 左側のメニューで Stacks & Machines を選択します。

  4. Default stack & machine セクションで、マシンタイプセレクターからマシンタイプを選択します。

    Default stack & machineセクションのマシンタイプセレクター

  5. 必要に応じて、Workflowごとのスタックが設定されているWorkflowに対して、Workflowごとのマシンタイプを選択します。

Configuration YAMLでのスタックの設定Click to copy link​

プロジェクトの Configuration YAMLで、デフォルトスタックとWorkflowごとのタスクの両方を設定できます。適切なstack IDとともに meta フィールドを使用します。

meta:      
bitrise.io:       
stack: <stack-id>

これは、bitrise.yml ファイルをアプリのリポジトリに保存している場合に特に便利です。

Stack ID

stack IDは、各スタックレポートの上部に記載されています: Bitriseスタックレポート。または、Workflow Editorでスタックを設定し、bitrise.yml タブの meta フィールドでIDを確認することもできます。Bitrise CLIを使用すると、bitrise stack listがWorkspaceで利用可能なスタックのIDを出力します: stack IDの確認を参照してください。

スタックレポートには、そのスタックで利用可能なすべてのプリインストールツールも表示されます。

最新の Stable スタックの使用Click to copy link​

新しいスタックが Stable になるたびに(たとえば、新しいXcodeバージョンがリリースされたときに)stack IDを手動で更新したくない場合は、バージョン固有のstack IDの代わりに latest-stable エイリアスを使用してください。

  • macOS: osx-xcode-latest-stable
  • Linux: ubuntu-latest-stable
meta:
bitrise.io:
stack: osx-xcode-latest-stable

これらのIDは常にプラットフォームの現在の Stable スタックに解決されるため、configuration YAMLを変更しなくても、ビルドは引き続きそのスタックで実行されます。Workflow Editorのスタックドロップダウンの Stacks & Machines からも選択できます。

注記

この設定では、Stable スタックが切り替わるたびに、基盤となるXcodeまたは Ubuntu のバージョンが変わる可能性があります。再現可能なビルド環境が必要な場合は、代わりにバージョン固有のstack IDを使用してください。

Configuration YAMLでのデフォルトスタックの設定Click to copy link​

プロジェクトのデフォルトスタックは、Workflowに特定のスタックを設定していない場合に使用されるスタックです。

  1. プロジェクトの Configuration YAMLを開きます。

  2. workflowsプロパティの外側、または Configuration YAMLの末尾に meta エントリを追加します。

    meta:      
    bitrise.io:       
    stack:

    インデントは2段階にしてください。

  3. stack IDを追加します。

    stack IDはスタックレポートページで確認できます。.log拡張子を除いたファイル名がstack IDです。

    meta:      
    bitrise.io:       
    stack: <stack-id>

Configuration YAMLでのWorkflowごとのスタックの設定Click to copy link​

Workflowにスタックを設定すると、デフォルトスタックに関係なく、そのWorkflowは常にそのスタックで実行されます。

  1. プロジェクトの Configuration YAMLを開きます。

  2. workflowsプロパティを見つけ、その中から必要なWorkflowの名前を探します。

  3. Workflow自体の下に meta エントリを追加します。

    workflows:
    deploy:
    meta:      
    bitrise.io:       
    stack:
  4. stack IDを追加します。

    stack IDは、各スタックレポートページの上部に記載されています。

    workflows:
    deploy:
    meta:      
    bitrise.io:       
    stack: <stack-id>

Configuration YAMLでのマシンタイプの設定Click to copy link​

プロジェクトの Configuration YAMLで、ビルドで使用するマシンタイプを定義することもできます。マシンタイプとは、ビルドで使用されるハードウェアリソースを指します。たとえば、Elite マシンは Standard マシンよりも多くの CPU コアと利用可能な RAM を備えています。

Configuration YAML ファイルでマシンタイプを設定するには、meta エントリで machine_type_id 属性を使用する必要があります。

利用可能なマシンID

利用可能なマシンタイプIDは次のページで確認できます: Build machineタイプ。

  1. プロジェクトの Configuration YAML ファイルを開きます。

  2. workflowsプロパティを見つけ、その中から必要なWorkflowの名前を探します。

  3. meta エントリを追加します。

    # setting an 8-core Gen2 machine for an Xcode stack as the default machine type of the app:
    meta:
    bitrise.io:
    machine_type_id: g2.8core
    # setting a 12-core Gen2 machine as a Workflow-specific machine type
    workflows:
    deploy:
    meta:
    bitrise.io:
    machine_type_id: <machine-id>

Build machineタイプClick to copy link​

Bitriseでは、仕様の異なる複数のbuild machinesを提供しています。必要に応じて選択できます。

各マシンタイプでアプリのビルドに費やした時間は、Insights で確認できます:Bitrise CI metrics。

サブスクリプションプランごとのマシンの利用可否

すべてのマシンがすべてのサブスクリプションプランで利用できるわけではありません。ご利用のプランで使えるマシンについては、料金ページをご確認ください。

マシンタイプはリソースクラスに分類されます。同じリソースクラスには、おおむね同程度の性能を持つ複数のマシンタイプが含まれます。Bitriseはリソースクラスの中からマシンタイプを自動的に割り当てるため、同じ日でもビルドが異なるマシンタイプで実行される場合があります。

ヒント

マシンタイプ ID を使用して、configuration YAMLでマシンタイプを設定します。

OSとリソースクラスハードウェアタイプスペックマシンタイプ ID
macOS MediumM2 Pro Medium• 4 CPU @3.49GHz
• 6 GB RAM
g2.mac.medium
macOS MediumM4 Medium• 5 CPU @4.4 GHz
• 6 GB RAM
g2.mac.medium
macOS LargeM2 Pro Large• 6 CPU @3.49GHz
• 14 GB RAM
g2.mac.large
macOS LargeM4 Large• 5 CPU @4.4 GHz
• 14 GB RAM
g2.mac.large
macOS X LargeM2 Pro X Large• 12 CPU @3.49GHz
• 28 GB RAM
g2.mac.x-large
macOS X LargeM4 X Large• 10 CPU @4.4 GHz
• 28 GB RAM
g2.mac.x-large
macOS 4LargeM4 Pro Large• 7 CPU @4.52GHz
• 27 GB RAM
g2.mac.4large
macOS 4X LargeM4 Pro X Large• 14 CPU @4.52GHz
• 54 GB RAM
g2.mac.4x-large
Linux Medium• 4 vCPU @3.1 GHz
• 16 GB RAM
standard
Linux Large• 8 vCPU @3.1 GHz
• 32 GB RAM
elite
Linux X Large• 16 vCPU @3.1 GHz
• 64 GB RAM
elite-xl
Linux SmallAMD EPYC Zen 4/5• 2 vCPU
• 8 GB RAM
g2.linux.2small
Linux MAMD EPYC Zen 4/5• 4 vCPU @3.7 GHz
• 16 GB RAM
g2.linux.medium
Linux 2MAMD EPYC Zen 4/5• 6 vCPU @3.7 GHz
• 24 GB RAM
g2.linux.2medium
Linux LAMD EPYC Zen 4/5• 8 vCPU @3.7 GHz
• 32 GB RAM
g2.linux.large
Linux 4LAMD EPYC Zen 4/5• 14 vCPU @3.7 GHz
• 56 GB RAM
g2.linux.4large
Linux XLAMD EPYC Zen 4/5• 16 vCPU @3.7 GHz
• 64 GB RAM
g2.linux.x-large
Linux 3XLAMD EPYC Zen 4/5• 24 vCPU @3.7 GHz
• 96 GB RAM
g2.linux.3x-large
Linux 5XLAMD EPYC Zen 4/5• 32 vCPU @3.7 GHz
• 128 GB RAM
g2.linux.5x-large
Linux 7XLAMD EPYC Zen 4/5• 48 vCPU @3.7 GHz
• 192 GB RAM
g2.linux.7x-large
注記

一部の macOS リソースクラスでは、2種類のハードウェアタイプが同じマシンタイプ ID で記載されています。どちらの世代にも同じ ID が使われ、Bitriseが各ビルドで利用可能なハードウェアを自動的に選択します。