TeamCity On-Premises 2026.2 Help

入門

このガイドでは、TeamCity CLI のインストール、TeamCity サーバーでの認証、最初のコマンドの実行について説明します。

TeamCity CLI のインストール

前提条件

TeamCity CLI の接続先として、実行中の TeamCity サーバー (バージョン 2020.1 以降) が必要です。 一部の機能では、より新しい TeamCity バージョン (たとえば、2024.04 以降) が必要になる場合があります。 追加のランタイム依存関係は不要です - CLI はスタンドアロンバイナリとして配布済みです。

インストール

Homebrew (推奨)：

brew install jetbrains/utils/teamcity

最新バージョンに更新するには:

brew upgrade teamcity

インストールスクリプト：

curl -fsSL https://jb.gg/tc/install | bash

スクリプトはオペレーティングシステムとアーキテクチャを自動的に検出し、 teamcity バイナリを PATH 上のディレクトリにインストールします。

インストールスクリプト (すべてのディストリビューション)：

curl -fsSL https://jb.gg/tc/install | bash

スクリプトはオペレーティングシステムとアーキテクチャを自動的に検出し、 teamcity バイナリを PATH 上のディレクトリにインストールします。

ディストリビューション別のパッケージ：

curl -fsSLO https://github.com/JetBrains/teamcity-cli/releases/latest/download/teamcity_linux_amd64.deb sudo dpkg -i teamcity_linux_amd64.deb
sudo rpm -i https://github.com/JetBrains/teamcity-cli/releases/latest/download/teamcity_linux_amd64.rpm
curl -fsSLO https://github.com/JetBrains/teamcity-cli/releases/latest/download/teamcity_linux_amd64.pkg.tar.zst sudo pacman -U teamcity_linux_amd64.pkg.tar.zst

Winget (推奨)：

winget install JetBrains.TeamCityCLI

PowerShell (インストールスクリプト)：

irm https://jb.gg/tc/install.ps1 | iex

CMD (インストールスクリプト)：

curl -fsSL https://jb.gg/tc/install.cmd -o install.cmd && install.cmd && del install.cmd

Chocolatey：

choco install teamcitycli

Scoop：

scoop bucket add jetbrains https://github.com/JetBrains/scoop-utils scoop install teamcity

npm (クロスプラットフォーム)：

npm install -g @jetbrains/teamcity-cli

ソースからビルド (上級者向け)

Go install：

go install github.com/JetBrains/teamcity-cli/tc@latest

クローンしてビルド：

git clone https://github.com/JetBrains/teamcity-cli.git cd teamcity-cli go build -o teamcity ./tc

インストールの確認

インストール後、CLI が利用可能であることを確認します。

teamcity --version

サーバーで認証する

  1. ログインコマンドを実行します。

    teamcity auth login

  2. プロンプトが表示されたら、サーバーの URL を入力してください。 サーバーでブラウザーベースのログイン (PKCE) が利用できる場合 (TeamCity 2026.1 以降)、CLI はブラウザーを開いてアクセスを自動的に承認します。 それ以外の場合 (2026.1 より古い TeamCity サーバー)、TeamCity ユーザープロファイルページで新しいアクセストークンを手動で発行する必要があります。

  3. ログインを確認します:

    teamcity auth status

トークンは、利用可能な場合、システムキーリング (macOS キーチェーン、GNOME キーリング、または Windows 資格情報マネージャー) に保存されます。

アクセストークンによるログインをご希望の場合は、 teamcity auth login --no-browser を実行してください。 すでにトークンをお持ちの場合は、 teamcity auth login --server https://teamcity.example.com --token <token> を使用してください。

ゲストアクセス

サーバーでゲストアクセスが有効になっている場合は、トークンなしでログインできます。

teamcity auth login --guest

ゲストアクセスでは、サーバーへの読み取り専用アクセスが提供されます。

Authentication status and guest login

用語を理解する

TeamCity CLI では、TeamCity の概念に短縮名を使用します。 これらのマッピングを知っておくと、コマンドの操作が容易になります。

実行

単一のビルド実行。 TeamCity ウェブインターフェースの ビルド に相当します。 実行 ID は数値です。

teamcity run list
ジョブ

ビルド構成 - ビルドの実行方法を定義する手順の設定です。 ジョブ ID は MyProject_Build のようになります。

teamcity job list
プロジェクト

ジョブのコレクションです。 プロジェクトはネストして階層構造を形成できます。 プロジェクト ID は MyProject のようになります。

teamcity project list

階層は次のとおりです: プロジェクト は ジョブ を含み、各ジョブは 実行 を生成し、各実行は エージェント で実行されます。

最近のビルドを一覧表示する

teamcity run list

結果を絞り込むにはフィルターを追加します:

# Builds from a specific job teamcity run list --job MyProject_Build # Only failures from the last 24 hours teamcity run list --status failure --since 24h # Builds on a specific branch teamcity run list --branch main --limit 10
Listing and filtering runs

ジョブ ID を見つける

多くのコマンドはジョブ ID を必要とします。 利用可能なジョブを参照するには、 teamcity job list を使用してください。

# List all jobs teamcity job list # Filter by project teamcity job list --project MyProject
Finding job IDs

ビルドを開始する

ジョブ ID を指定して新しいビルドをトリガーします。

teamcity run start MyProject_Build

ビルドをリアルタイムで追跡するには、 --watch を追加します。

teamcity run start MyProject_Build --branch main --watch

--watch フラグは、ビルドが完了するまで更新されるライブ進行状況ビューを表示します。

Starting a build with --watch

ビルドログを表示する

特定のビルドからのログ出力を表示します。

teamcity run log 12345

または、ジョブの最新ログを取得します。

teamcity run log --job MyProject_Build
Viewing build logs in the pager

失敗を調査する

ビルドが失敗した場合は、次のワークフローを使用して根本原因をすばやく見つけます。

  1. 失敗したビルドを見つけます。

    teamcity run list --status failure

  2. 障害診断 (問題、フルスタックトレースを含む失敗したテスト) を表示します。

    teamcity run log 12345 --failed

  3. 個々のテストの失敗をインスペクションします。

    teamcity run tests 12345 --failed
Viewing failed test results

ビルドキューを確認する

実行を待機しているビルドを確認します。

teamcity queue list

ビルドエージェントを表示する

登録されているすべてのビルドエージェントとそのステータスを一覧表示します。

teamcity agent list

接続されたエージェントのみを表示するフィルター:

teamcity agent list --connected
Listing build agents

ブラウザーで開く

ほとんどのビューコマンドは、ブラウザーで対応するページを開く --web フラグをサポートしています。

teamcity run view 12345 --web teamcity job view MyProject_Build --web teamcity project view MyProject --web

次のステップ

シェル補完

Bash、Zsh、Fish、PowerShell のタブ補完を設定します - 構成 を参照してください。

認証

マルチサーバー設定や CI/CD の使用箇所を含む 認証メソッド について詳しく見る。

実行の管理

ビルド管理 についてさらに詳しく学びます - アーティファクト、個人ビルド、ピン留め、タグ付けなど。

エイリアス

よく使うコマンド用に カスタムショートカット を設定します。

スクリプト作成

スクリプト作成と自動化用に JSON 出力 を設定します。

コマンドリファレンス

利用可能なすべてのコマンドとフラグについて、完全な コマンドリファレンス を閲覧します。

2026 年 9 月 11 日
TeamCity コマンドラインインターフェース認証