指定需求

Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019 |TFS 2018

注意

在 Microsoft Team Foundation Server (TFS) 2018 和更低版本中,生成和发布管道被称为“定义”,运行被称为“生成”,服务连接被称为“服务终结点”,阶段被称为“环境”,而作业被称为“阶段” 。

使用需求来确保管道所需的功能在运行管道的代理上存在。 需求由任务自动断言,或由你手动断言。

注意

需求和功能旨在与自承载代理一起使用,以便作业可以与满足作业要求的代理匹配。 使用 Microsoft 托管的代理时,为符合作业要求的代理选择映像,因此,尽管可以将功能添加到 Microsoft 托管的代理,但不需要将功能与 Microsoft 托管的代理配合使用。

任务要求

除非代理满足一个或多个要求,否则某些任务不会运行。 例如, Visual Studio 生成 任务要求 msbuild 在代理上安装 和 visualstudio

手动输入的代理要求

可能需要使用具有特殊功能的自承载代理。 例如,管道可能需要在池中的Default代理上使用 SpecialSoftware。 或者,如果同一池中有多个具有不同操作系统的代理,则可能有一个需要 Linux 代理的管道。

若要向 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

注意

检查是否存在功能 (是否存在) 和检查功能中的特定字符串 (等于) 是满足需求的唯一支持的两个操作。

有关详细信息和示例,请参阅 YAML 架构 - 需求

AZURE DEVOPS SERVER 2019 及更高版本支持 YAML 管道。

注册具有 该功能的每个代理。

  1. 在 Web 浏览器中,导航到“代理池”:

    1. 选择 “Azure DevOps组织设置”。

      选择“组织设置”。

    2. 选择 “代理池”。

      选择“代理池”选项卡。

    1. 选择 “Azure DevOps“集合设置”。

      选择“集合设置”。

    2. 选择 “代理池”。

      选择“代理池”。

    1. 选择 “Azure DevOps“集合设置”。

      集合设置,2019 年。

    2. 选择 “代理池”。

      选择“代理池,2019”。

    1. 导航到项目,然后选择 “设置 ” (齿轮图标) >“代理队列”。

      选择“设置”、“代理队列”,2018 年。

    2. 选择 “管理池”。

      选择“管理池,2018”。

  2. 导航到代理的“功能”选项卡:

    1. 从“ 代理池 ”选项卡中,选择所需的代理池。

      在“代理池”中,选择所需的代理池。

    2. 选择“ 代理 ”,然后选择所需的代理。

      选择“代理”,然后选择代理。

    3. 选择“ 功能 ”选项卡。

      选择“功能”选项卡。

      注意

      Microsoft 托管的代理不显示系统功能。 有关 Microsoft 托管代理上安装的软件的列表,请参阅 使用 Microsoft 托管的代理

    1. 从“ 代理池 ”选项卡中,选择所需的池。

      选择所需的池。

    2. 选择“ 代理 ”,然后选择所需的代理。

      选择“代理”,然后选择所需的代理。

    3. 选择“ 功能 ”选项卡。

      “代理功能”选项卡。

    1. 从“ 代理池 ”选项卡中,选择所需的池。

      选择所需的选项卡 2019。

    2. 选择“ 代理 ”,然后选择所需的代理。

      选择所需的代理 2019。

    3. 选择“ 功能 ”选项卡。

      选择“功能”选项卡,2019 年。

    选择所需的代理,然后选择“ 功能 ”选项卡。

    “代理功能”选项卡,2018 年。

  3. 添加类似于以下条目的内容:

第一个框 第二个框
SpecialSoftware C:\Program Files (x86) \SpecialSoftware

提示

对于经典非 YAML 生成定义,在手动将生成排队时,可以更改该运行的要求。