新项目YAML构建流水线无BUILD代理池使用权限，如何授权？

问题根源 #

尽管新项目的YAML配置和旧项目一致，但流水线的代理池权限是独立管控的，新项目的流水线默认未获得BUILD代理池的使用权限。

授权操作步骤 #

• 打开项目的设置界面，找到「管道」分类下的代理池选项
• 选中报错里的BUILD代理池，进入其详情页
• 切换到安全标签
• 在权限管理区域，添加流水线所属的项目团队（或流水线对应的服务账户）
• 为添加的主体勾选使用权限，保存配置

补充排查点 #

• 若授权后仍报错，检查是否是组织级代理池的权限限制，此时需要进入组织级设置的代理池页面，重复上述授权步骤
• 确认流水线的运行身份（如服务账户）是否在授权的用户/组范围内

内容的提问来源于stack exchange，提问作者nielsen