配置 Agent 要求

为确保您的构建永远不会被分配给无法运行它的代理，TeamCity 分析所有构建配置，并列出不适合配置的构建例程的代理作为不兼容的。

例如，如果您的步骤之一 在容器内运行，TeamCity 将会通过 container.agent 存在 要求，过滤掉那些未安装 Docker 或 Podman 的代理。 或者，如果您的步骤之一引用了构建参数（例如，一个 命令行 脚本打印 %my.custom.param% 的值），TeamCity 则使用相同的 exists 操作符来识别未报告此参数的代理。

您可以在 TeamCity UI 和 Kotlin DSL 两者中添加自定义代理要求。

TeamCity 用户界面 Kotlin DSL 请导航至构建配置设置（管理 | <您的配置>），然后切换到 代理要求 标签。 这个页面显示哪些代理当前有资格基于其执行的建筑常规来运行您的构建配置。 点击 添加新的需求 按钮。 选择一个参数，一个条件，并输入一个值来创建新的表达式。 由于 TeamCity 扫描了代理报告的参数，因此在您输入参数名称和值时，它会显示出建议。 点击 Save。 您的兼容和不兼容代理的列表将会进行更新。 如果 TeamCity 无法找到满足您的新条件的代理，相应的警告将显示在需求旁边。 运行此类构建配置将使构建在队列中等待，状态显示为“没有空闲的兼容代理可以运行此构建”。 要临时禁用或永久移除一个要求，点击Edit旁边的下拉菜单按钮。 请注意，隐式要求不能被移除或禁用，因为它们直接是由这个配置中进行的构建行为所需要的。 tip 在制定代理需求之前，您可以检查不同代理对给定参数返回的值。 为了做到这一点，请导航至 Agents | Parameters Report 并输入所需的参数名称。 将新的表达式添加到您的构建配置的 要求 块中。 object MyBuildConfig : BuildType({ requirements { exists("DotNetCoreSDK5.0_Path") startsWith("teamcity.agent.jvm.os.name", "Windows") } }) 参见：需求 | Kotlin DSL 文档

如果在 Build Configuration Template（构建配置模板） 中声明了代理需求，那么基于此模板的所有配置也会同样受到该需求的影响。 这些配置的 Agent 要求 页面将这些要求标记为“继承”。

项目管理员可以编辑、禁用和移除继承的需求，除非它们是 强制性设置模板的一部分。

当定义了多个要求时，它们会被隐式地通过布尔值 AND 连接起来。 例如，以下一组条件要求同时存在 env.JDK_17_0 参数和 env.JDK_21_0 参数：

requirements {
    exists("env.JDK_17_0")
    exists("env.JDK_21_0")
}

目前没有可用的机制来用布尔 OR 将需求连接起来。