共用方式為


集區定義

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

參考此定義的定義: pipelinejobs.job

實作

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

備註

在 Azure DevOps Server 2019 中,您可以在 YAML 的作業層級和管線設定 UI 的管線層級指定集區。 在 Azure DevOps Server 2019.1 中,如果您有單一隱含作業,您也可以在 YAML 中的管線層級指定集區。

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

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

集區:字串

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

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 裝載的集區中才有效。

集區:名稱、需求

要用於管線作業的集區。

pool:
  name: string # Name of a pool.
  demands: string | [ string ] # Demands (for a private pool).

屬性

name 字串。
集區的名稱。

demandspool.demands
私人集區) 的需求 (。

備註

使用 屬性指定 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 代理程式)

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

另請參閱