プールの定義

pool キーワードは、パイプラインのジョブに使用する プール を指定します。 pool 仕様には、ジョブの実行戦略に関する情報も保持されます。

この定義を参照する定義: パイプライン、stages.stage、jobs.job、jobs.deployment、preDeployHook、deployHook、routeTrafficHook、postRouteTrafficHook、onFailureHook、onSuccessHook

実装

実装	説明
プール: 文字列	名前でプライベート プールを指定します。
プール: 名前、要求、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 文字列。
プールの名前。

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

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

注釈

vmImage プロパティを使用して、Microsoft がホストするプールを指定します。

セルフホステッド エージェント プール名にスペースがある場合は、プール名を一重引用符で囲みます (例: name: 'My pool')。

例示

Microsoft でホストされるプールを使用するには、名前を省略し、使用可能な ホストされているイメージの 1 つ指定します。

pool:
  vmImage: ubuntu-latest

完全な構文を使用して、プライベート プールの要求を指定できます。

YAML ビルド パイプラインに 1 つの需要を追加するには、demands: 行を pool セクションに追加します。

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

機能の存在 (存在) の確認と、機能 (等しい) 内の特定の文字列のチェックは、要求に対してサポートされる唯一の 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 エージェントのみ)

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

こちらもご覧ください

• 要求 を指定する
• 条件の と タイムアウトの詳細については、を参照してください。