グローバル オプション
bitbucket-pipelines.yml の options セクションでは、ステップの最大実行時間や Pipelines Docker コンテナーに割り当てられるリソースなど、リポジトリのすべてのパイプラインに対して、いくつかのグローバル オプションを設定できます。その他のオプションはグローバルに設定できますが、Git クローン オプション、Docker イメージ オプション、キャッシュとサービスのコンテナー オプションなど、bitbucket-pipelines.yml に専用のセクションを保持します。
パイプラインのグローバル オプション
以下のグローバル オプションは、options プロパティで設定されています。
オプション
すべてのパイプラインに適用するグローバル設定を含みます。
プロパティ — options
必須 — いいえ
Data type — Block of new-line separated key-value pairs (YAML spec - Block Mapping)
指定可能な親プロパティ — YAML ルート (options は必ず最上位のプロパティとなります)
Allowed child properties — Requires one or more of the max-time, docker, size, and runtime properties.
例 — options オプションを使用して、パイプラインのグローバル オプションを設定する
Docker
The global docker option adds a Docker service to all steps in the pipeline. This Docker service can be used to run Docker commands within any pipeline step. For information on using Docker in a Bitbucket Pipeline see Run Docker commands in Bitbucket Pipelines.
プロパティ — docker
必須 — いいえ
データ タイプ — ブール値
指定可能な値 — true または false
既定値 — false
Allowed parent properties — options
例 — docker を使用して、Docker コマンドをすべてのパイプライン ステップで有効にする
例 — services を使用して、単一ステップで Docker コマンドを有効にする
最長時間
max-time オプションは、タイムアウトする前にステップを実行できる最大時間 (分単位) を設定します。max-time オプションは、グローバル options プロパティと個々のパイプライン ステップの両方で設定できます。パイプライン ステップの既定の最大時間は 120 分です。
プロパティ — max-time
必須 — いいえ
データ タイプ — 整数
指定可能な値 — 1 ~ 720 の正の整数
既定値 — 120
Allowed parent properties — options and step
例 — max-time オプションを使用して、パイプラインの各ステップに指定可能な最大時間を設定する
例 — max-time オプションを使用して、パイプラインの個別のステップに指定可能な最大時間を設定する
サイズ
size オプションは、Bitbucket Cloud インフラストラクチャまたは Linux Docker セルフホストランナーで実行する場合、ステップまたはパイプライン全体に追加のリソースを割り当てます。
このオプションは、ホストマシン上で利用可能なすべてのリソースを使用する Windows PowerShell、macOS シェル、Linux シェルランナーなどのシェルベースのランナーには影響しません。
デフォルトでは、Bitbucket Cloud インフラストラクチャまたは Linux Docker セルフホスト ランナー上で実行されるステップは、ボリュームをマウントするために、4GB のメモリ、4 つの CPU (他のタスクと共有される場合があります)、step あたり 64 GB のディスク容量にアクセスできます。2x のサイズを指定すると、step またはパイプラインの空きメモリは 2 倍になります。割り当てられたメモリは step の script と step. の services の両方で共有されることに注意してください。
4x を超える size オプションを選択すると、追加の CPU リソースとディスク容量も確保されます。step に 4x 以上の size が割り当てられていると、該当する数の CPU への専用アクセスが保証され、ボリュームをマウントするためのより多くのディスク容量が得られます。
4x ステップは 1x ステップのビルド時間の 4 倍を、2x ステップは 1x ステップのビルド時間の 2 倍を使用します。注意: ビルド時間を増やすと、パイプライン ビルドの現在のコストも増加する可能性があります。
サイズに基づくリソース割り当て
サイズ | CPU | メモリ | ボリューム サイズ |
|---|---|---|---|
1x | 2 | 4 | 64 ギガバイト |
2x | 4 | 8 | 64 ギガバイト |
4x | 8 | 16 | 256 ギガバイト |
8x | 16 | 32 | 256 ギガバイト |
16x | 32 | 64 | 256 ギガバイト |
24 倍 | 48 | 96 | 256 ギガバイト |
32x | 64 | 128 | 256 ギガバイト |
プロパティ — size
必須 — いいえ
データ タイプ — 文字列
指定可能な値 — 次のいずれか:
1x,2x,4x,8x,16x,24xor32xfor pipeline steps run on Bitbucket Cloud.
4x, 8x, 16x, 24x, and 32x pipelines size options are only available for builds running on a paid Bitbucket Cloud plan (Standard or Premium).
既定値 — 1x
Allowed parent properties — options and step
例 — size オプションを使用して、すべてのパイプライン ステップで利用可能なメモリを増やす
例 — size オプションを使用して、パイプライン ステップで利用可能なメモリを増やす
ランタイム
ステップに適用されるランタイム設定です。
プロパティ — runtime
必須 — いいえ
Data type — Block of new-line separated key-value pairs (YAML spec - Block Mapping)
指定可能な親プロパティ — options と step
指定可能な子プロパティ — cloud (必須)
例 - ランタイムを使用して、4x、8x、および 16x のすべてのステップで atlassian-ip-ranges を、すべてのステップで arm を有効にする
例 - ランタイムを使用して、特定のステップで atlassian-ip-ranges と arm を有効にする
クラウド ランタイム設定
クラウド ステップに適用されるランタイム設定です。
プロパティ — cloud
必須 — いいえ
Data type — Block of new-line separated key-value pairs (YAML spec - Block Mapping)
指定可能な親プロパティ — runtime
指定可能な子プロパティ — atlassian-ip-ranges (オプション)、arch (オプション)
クラウド ランタイム設定用のアトラシアン IP 範囲
This option indicates whether to use the default aws-ip-ranges or the atlassian-ip-ranges when executing your step for ingress/egress traffic.
プロパティ — atlassian-ip-ranges
必須 — いいえ
データ タイプ — ブール値
指定可能な値 — true または false
既定値 — false
指定可能な親プロパティ — cloud
クラウド ランタイム設定のアーキテクチャ
このオプションは、ステップを実行するときに使用するアーキテクチャを制御します
プロパティ — arch
必須 — いいえ
データ タイプ — 文字列
指定可能な値 — arm または x86
既定値 — x86
指定可能な親プロパティ — cloud
arm オプションは、Bitbucket Cloud の Standard または Premium プランで実行されているビルドでのみ利用できます。
エクスポート - Bitbucket Premium のみ
パイプライン定義を同じワークスペース内の他のリポジトリと共有するかどうかを指定します。
プロパティ — export
必須 — いいえ
データ タイプ — ブール値
指定可能な値 — true または false
既定値 — false
指定可能な親プロパティ — YAML ルート (export は必ず最上位のプロパティとなります)
例 — エクスポート オプションで definitions セクションの pipelines をエクスポートする
Check out the Share Pipelines configuration help document for more information.
この内容はお役に立ちましたか?