ID为61的代理池未找到：项目集合管理员为何看不到部署池？

一、"No agent pool found with identifier 61" 报错及权限差异原因 #

报错根源 #

日志显示部署组"Web Servers"（ID23）关联的部署池ID是61，但你的账号无法访问该池，导致代理配置时无法定位池资源，触发报错。

权限差异原因 #

作为项目集合管理员却看不到部署池，核心原因是部署池的权限被单独限制，常见场景：

• 部署池取消了"继承权限"，集合管理员的默认权限未覆盖到该池。
• 池的安全设置中，你的账号被移除了"查看池"权限，或未被明确赋予该权限。
• DevOps权限缓存未更新，可尝试刷新页面、清除浏览器缓存或重新登录后再检查。

解决步骤 #

1. 让能看到池61的同事进入集合设置→代理池→部署池→找到池61→进入"安全"选项卡。
2. 检查权限继承状态：若未开启继承，添加你的账号到权限列表，至少赋予"查看池"权限；若已开启继承，确认集合管理员组是否拥有"查看池"权限。
3. 权限配置完成后，重新运行代理配置脚本，或重启部署代理服务。

二、部署代理、部署池与部署组核心指南 #

1. 三者关联逻辑 #

• 部署池：集合级别的代理资源容器，管理一组可跨项目共享的部署代理，每个池对应唯一ID。
• 部署组：项目级的逻辑分组，绑定一个部署池，从池中选取代理并按标签（如"WebServer"）分类，供项目发布管道调用。
• 部署代理：运行在目标服务器上的服务，必须注册到某个部署池，才能被关联的部署组调用执行部署任务。
  简单链路：部署代理注册到部署池 → 项目创建部署组绑定该池 → 发布管道通过部署组调用代理执行部署。

2. 部署池与构建池的差异 #

3. 核心管理操作 #

部署池管理

• 创建：集合设置→代理池→部署池→新建，设置名称和描述。
• 权限配置：进入目标池的"安全"页，分配以下核心权限：
  • 查看池：允许查看池及代理列表
  • 管理代理：允许注册、移除代理，修改代理配置
  • 管理池：允许修改池的基本信息和权限规则
• 代理注册：在目标服务器下载代理包，运行配置脚本时指定部署池名称/ID，完成注册。

部署组管理

• 创建：项目→部署→部署组→新建，选择关联的部署池，设置组名称和代理标签（用于筛选特定代理）。
• 代理分组：通过标签将部署池中的代理分类到不同部署组，比如给Web服务器代理打"Web"标签，数据库服务器打"DB"标签。
• 权限控制：在部署组"安全"页配置权限，限制哪些用户/组可以使用该组执行部署。

部署代理管理

• 安装：从DevOps下载对应系统的代理包，解压后运行config.cmd（Windows）或config.sh（Linux），按提示输入DevOps地址、PAT令牌、部署池信息。
• 后台运行：Windows执行svc install注册为系统服务；Linux通过systemd配置服务，确保代理持续在线。
• 故障排查：查看代理安装目录下的_diag文件夹中的日志，或在DevOps部署池页面查看代理状态（在线/离线）。

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