mcpField
T
teamcity-cli

teamcity-cli

github.com/cline云与 DevOps39776 次安装15 周前更新
代码仓库

关于 teamcity-cli

用于操作 TeamCity 构建、作业、项目、代理和流水线的命令行技能。它结合命令指南、工作流程与注意事项，支持排查失败并管理流水线变更。

主要功能

  1. 01管理构建运行与作业
  2. 02检查日志、测试和构建链
  3. 03下载运行产物
  4. 04管理项目、代理与队列
  5. 05验证和管理流水线

适用场景

  1. 01诊断构建失败
  2. 02沿构建链追踪故障
  3. 03启动并监控验证构建
  4. 04推送前验证流水线变更

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/cline/skills --skill teamcity-cli

安装后在 Claude Code 中输入/teamcity-cli确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

_agents/
babysit-build.md
references/
commands.md
output.md
workflows.md

详细介绍

TeamCity CLI (teamcity)

快速开始

teamcity auth status                    # Check authentication
teamcity run list --status failure      # Find failed builds
teamcity run log <id> --failed --raw    # Full failure diagnostics

不要猜测标志或语法。 请使用命令参考或 teamcity <command> --help。构建称为运行（teamcity run）；构建配置称为作业（teamcity job）。切勿使用 --count，请使用 --limit（或 -n）。

注意事项

  • 复合构建的日志为空——请深入查看子构建以找出实际故障。
  • 构建链自下而上失败——失败层级最深的依赖项就是根本原因。请使用 teamcity run tree <id>。
  • --local-changes 不包含 Kotlin DSL——运行前请先推送 .teamcity/ 更改。
  • 仅设置 TEAMCITY_URL 会绕过已保存的身份验证——请同时设置 TEAMCITY_URL 和 TEAMCITY_TOKEN，或两者都不设置。
  • 日志：使用 --raw 并导出到临时文件。构建：启动构建时使用 --watch。
  • VCS 触发器不一定已配置——推送修复后，可能需要手动启动构建。
  • pipeline push 不会进行验证——请务必先运行 teamcity pipeline validate。
  • GitHub VCS 根目录：请使用 GitHub App 连接。 切勿通过 --auth password 粘贴 PAT。请参阅工作流。

核心命令

类别命令
身份验证auth login、logout、status
构建run list、view、start、watch、log、cancel、restart、tests、changes、tree
构件run artifacts、run download
元数据run pin/unpin、run tag/untag、run comment
作业job list、view、create、tree、pause/resume、step list/view/add/delete、param list/get/set/delete、settings list/get/set
项目project list、view、create、tree、param、token put/get、settings export/status
VCS/连接project vcs list/view/create/delete、project connection list/create/authorize/delete
队列queue list、approve、remove、top
Agentagent list、view、enable/disable、authorize/deauthorize、exec、term、reboot、move
池pool list、view、link/unlink
流水线pipeline list、view、create、validate、pull、push、schema、delete
APIteamcity api <endpoint> — 原始 REST 访问
链接teamcity link — 通过 teamcity.toml 绑定仓库

快速工作流

每项的详细说明请参阅工作流。

  • 调查故障：run list --status failure → run log <id> --failed --raw → run tests <id> --failed
  • 调试构建链：run tree <id> → 深入查看失败层级最深的子构建
  • 修复并验证：编辑 → 推送 → run start --watch（个人构建请使用 --local-changes）
  • 流水线生命周期：pipeline pull <id> → 编辑 → pipeline validate → pipeline push <id>；使用 pipeline schema 获取服务器提供的实际架构
  • GitHub VCS：connection create github-app → connection authorize → 在仓库上安装 App → vcs create --auth token --connection-id <id>
  • Docker 注册表：echo $TOKEN | connection create docker -p <id> --name X --url https://ghcr.io --username U --stdin

参考资料

评论

支持 Markdown