池定义

pool 关键字指定要用于管道作业的池。 pool 规范还包含有关作业的运行策略的信息。

引用此定义的定义： pipeline、 stage.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 托管的池中有效。

注解

使用 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 操作

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

有关详细信息，请参阅 指定需求。

另请参阅

• 指定需求
• 详细了解条件和超时。