集區定義

pool關鍵詞會指定要用於管線作業的集區。 規格 pool 也會保存作業執行策略的相關信息。

參考此定義的定義： pipeline、 stage.stage、 jobs.job、 jobs.deployment、 preDeployHook、 deployHook、 routeTrafficHook、 postRouteTrafficHook、 onFailureHook、 onSuccessHook

實施

實施	說明
集區：字串	依名稱指定私人集區。
pool：name、demands、vmImage	使用需求和Microsoft裝載集區的完整語法。

備註

您可以在管線、階段或作業層級指定集區。

在階層中最低層級指定的集區會用來執行作業。

集區：字串

依名稱指定用於管線作業的私人集區。

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裝載集區，請省略名稱並指定其中一個可用的 託管映射：

pool:
  vmImage: ubuntu-latest

您可以使用完整語法來指定私人集區的需求。

若要將單一需求新增至 YAML 建置管線，請將這 demands: 一行新增至 pool 區段。

pool:
  name: Default
  demands: SpecialSoftware # exists check for SpecialSoftware

或者，如果您需要新增多個需求，請為每個行新增一個。

pool:
  name: MyPool
  demands:
  - myCustomCapability   # exists check for myCustomCapability
  - Agent.Version -equals 2.144.0 # equals check for Agent.Version 2.144.0

檢查功能是否存在（exists）和檢查功能中的特定字串（等於）是唯一兩個支援的需求作業。

存在作業

存在作業會檢查是否有具有特定名稱的功能。 比較不區分大小寫。

pool:
  name: MyPool
  demands: myCustomCapability # exists check for myCustomCapability

等於作業

等於作業會檢查功能是否存在，如果存在，則會使用指定的值檢查其值。 如果功能不存在或值不相符，則作業會評估為 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 代理程式）

如需詳細資訊，請參閱 指定需求。

另請參閱

• 指定需求
• 深入了解 條件 和 逾時。