池定义

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

引用此定义的定义：管道、stage.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

池：名称、需求、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 代理）

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

另请参阅

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