集區定義

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

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

實作

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

備註

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

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

集區：字串

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

pool: string # Specify a private pool by name.

pool 字串。

依名稱指定私人集區。

備註

使用此語法可依名稱指定私人集區。

注意

如果您的集區名稱中有空格，請用單引號括住集區名稱，例如 pool: 'My pool' 。

範例

若要使用私用集區，但不需要：

pool: MyPool

集區：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 組建管線，請將該 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

檢查功能是否存在 (存在) ，而且檢查功能中的特定字串 (是否等於) 是唯一兩個支援的需求作業。

存在作業

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

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 代理程式)

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

另請參閱

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