プール定義

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: 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 文字列。
プールの名前。

demandspool.demands。
要求 (プライベート プールの場合)。

vmImage 文字列。
使用する VM イメージの名前。は、Microsoft がホストするプールでのみ有効です。

注釈

プロパティを使用して 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 エージェントのみ)

詳細については、「要求の指定」を参照してください。

こちらもご覧ください

• 要求の指定
• 条件とタイムアウトの詳細を理解してください。