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
エージェントagent 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 対応