teamcity-cli 是做什么的？
来自 cline/skills 的 Agent 技能 'teamcity-cli'。
此技能为 AI Agent 提供与 TeamCity CI/CD 服务器交互的能力。通过使用此技能，Agent 可以执行常见的构建操作，例如触发新构建、检查构建状态、查看构建日志和查询构建配置。
功能
- 触发构建：
- 支持指定构建类型 ID 和分支。
- 可传递自定义构建参数。
- 检查构建队列状态。
- 获取构建详情（包括日志和错误信息）。
- 列出可用的构建配置。
使用方法
Agent 可以通过调用预定义的 CLI 命令来执行操作。所有命令均通过 TeamCity REST API 进行通信。
先决条件
- 需要配置 TeamCity 服务器 URL 和认证令牌。
- 确保 Agent 具有访问相应项目和构建配置的权限。
示例命令
# 触发构建
teamcity-cli trigger-build --build-type-id MyBuildConfig --branch main --parameters "key=value"
# 检查构建队列
teamcity-cli list-queue
# 获取构建状态
teamcity-cli get-build-status --build-id 12345
# 查看构建日志
teamcity-cli get-build-log --build-id 12345
# 列出构建配置
teamcity-cli list-build-configs --project MyProject
配置
可以通过环境变量或配置文件进行设置：
TEAMCITY_SERVER_URL: TeamCity 服务器的地址。TEAMCITY_AUTH_TOKEN: 用于 API 调用的 Bearer 令牌或基本认证凭据。
平台支持
- TeamCity 2022.x 及以上版本。
- 支持所有主流操作系统，Agent 可在其上运行 CLI 工具。
注意
- 请确保令牌仅具有执行所需操作的最低权限。
- 对于大型构建日志，建议使用分页或限制输出大小以避免性能问题。