プール定義
pool
キーワードは、パイプラインのジョブに使用するプールを指定します。
pool
の指定には、ジョブの実行戦略に関する情報も保持されています。
この定義を参照する定義: pipeline、 stages.stage、 jobs.job、 jobs.deployment、 preDeployHook、 deployHook、 routeTrafficHook、 postRouteTrafficHook、 onFailureHook、 onSuccessHook
実装
実装 | 説明 |
---|---|
pool: string | 名前でプライベート プールを指定します。 |
pool: name, demands, vmImage | 要求と Microsoft でホストされるプールを使用するための完全な構文。 |
実装 | 説明 |
---|---|
pool: string | 名前でプライベート プールを指定します。 |
pool: name, demands | パイプラインのジョブに使用するプール。 |
注釈
Azure DevOps Server 2019 では、YAML のジョブ レベルと、パイプライン設定 UI のパイプライン レベルで、プールを指定できます。 Azure DevOps Server 2019.1 では、暗黙的なジョブが 1 つある場合は、YAML のパイプライン レベルでもプールを指定できます。
パイプライン、ステージ、またはジョブのレベルでプールを指定できます。
階層の最下位レベルで指定されたプールが、ジョブの実行に使われます。
pool: string
パイプラインのジョブに使用する名前でプライベート プールを指定します。
pool: string # Specify a private pool by name.
pool
文字列。
名前でプライベート プールを指定します。
注釈
この構文を使用して、名前でプライベート プールを指定します。
注意
プール名にスペースがある場合は、 のように pool: 'My pool'
プール名を一重引用符で囲みます。
例
要求なしでプライベート プールを使うには:
pool: MyPool
pool: name, demands, vmImage
要求と Microsoft でホストされるプールを使用するための完全な構文。
pool:
name: string # Name of a pool.
demands: string | [ string ] # Demands (for a private pool).
vmImage: string # Name of the VM image you want to use; valid only in the Microsoft-hosted pool.
プロパティ
name
文字列。
プールの名前。
demands
pool.demands。
要求 (プライベート プールの場合)。
vmImage
文字列。
使用する VM イメージの名前。は、Microsoft がホストするプールでのみ有効です。
pool: name, demands
パイプラインのジョブに使用するプール。
pool:
name: string # Name of a pool.
demands: string | [ string ] # Demands (for a private pool).
プロパティ
name
文字列。
プールの名前。
demands
pool.demands。
要求 (プライベート プールの場合)。
注釈
プロパティを使用して Microsoft でホストされるプールを vmImage
指定します。
セルフホステッド エージェント プール名にスペースが含まれている場合は、プール名を 一重引用符 (例: name: 'My pool'
) で囲みます。
例
Microsoft ホステッド プールを使うには、名前を省略し、使用できるホステッド イメージのいずれかを指定します。
pool:
vmImage: ubuntu-latest
完全な構文を使用して、プライベート プールの要求を指定できます。
YAML ビルド パイプラインに 1 つの要求を追加するには、pool
セクションに demands:
行を追加します。
pool:
name: Default
demands: SpecialSoftware # exists check for SpecialSoftware
または、複数の要求を追加する必要がある場合は、1 行に 1 つ追加します。
pool:
name: MyPool
demands:
- myCustomCapability # exists check for myCustomCapability
- Agent.Version -equals 2.144.0 # equals check for Agent.Version 2.144.0
機能の存在 (exists) の確認と、機能内の特定の文字列 (equals) の確認は、要求でサポートされているたった 2 つの操作です。
Exists 操作
存在する操作では、特定の名前の機能が存在するかどうかを確認します。 大文字と小文字は区別されません。
pool:
name: MyPool
demands: myCustomCapability # exists check for myCustomCapability
Equals 演算
equals 操作は機能の存在をチェックし、存在する場合は、指定された値でその値をチェックします。 機能が存在しない場合、または値が一致しない場合、操作は false と評価されます。 比較では大文字と小文字は区別されません。
pool:
name: MyPool
demands: Agent.Version -equals 2.144.0 # equals check for Agent.Version 2.144.0
システム機能としてのエージェント変数
セルフホステッド エージェントには、エージェント変数と同様の名前を持つ次のシステム機能がありますが、これらは変数ではなく、要求に存在するか等しいかを確認するときに変数構文を必要としません。
- Agent.Name
- Agent.Version
- Agent.ComputerName
- Agent.HomeDirectory
- Agent.OS
- Agent.OSArchitecture
- Agent.OSVersion (Windows エージェントのみ)
詳細については、「要求の指定」を参照してください。