TeamCity On-Premises 2026.2 Help

TeamCity エージェントのインストール

TeamCity ビルドエージェントをインストールする前に、必ず システム要件をお読みください。

便利なインストールオプションを選択してください。

Windows 実行可能ファイルからインストール

  1. TeamCity で エージェント ページを開きます。

  2. ビルドエージェントのインストール をクリックし、 Windows インストーラーを選択してインストーラーをダウンロードします。

  3. エージェントマシンで agentInstaller.exe を実行し、インストール手順に従います。

エージェントサービスの実行に使用されるユーザーアカウントに適切な 権限があることを確認してください。

ZIP ファイルからインストール

このオプションを使用すると、エージェントをエージェントマシンにコピーできるアーカイブとしてダウンロードできます。

利用可能なエージェントディストリビューション

完全なエージェントディストリビューション物をダウンロードするか、最小限のエージェントディストリビューション物をダウンロードするかを選択できます。

  • 最小限のエージェントディストリビューション は、プラグインのない通常のビルドエージェントです。 最小限のエージェントは、最初の起動時に必要なすべてのプラグインをダウンロードします。

  • 完全なエージェントディストリビューション 、サーバー上で現在有効になっているすべてのプラグインの関連バージョンが含まれます。 これにより、完全なディストリビューションアーカイブのサイズは大きくなりますが、最初のエージェント実行にかかる時間が大幅に短縮されます。

エージェントイメージの作成にスクリプトを使用する場合 (クラウドプロファイルなど)、完全なエージェントをお勧めします。 完全なエージェントを備えたすべてのクラウドインスタンスは、起動した瞬間からサーバーと同期され、すぐにビルドを実行できます。

完全なエージェントのディストリビューションには、次の 2 つのバリエーションもあります。

  • Java 開発キットを含まない通常のエージェントのディストリビューション。 このバリエーションをダウンロードしてインストールする場合は、エージェントマシンに必要な JDK バージョンがインストールされていること (サポートされている Java バージョン を参照)、および JRE_HOME または JAVA_HOME 環境変数が正しいインストールを指していることを確認してください。

  • OS 固有の JDK がバンドルされたディストリビューション。 これらのディストリビューションを使用すると、エージェントとそれに必要な JDK を一度にインストールできます。 これらのディストリビューションをダウンロードするには、 管理 | エージェント JDK ページで必要な JDK バージョンを追加し、TeamCity が関連するエージェントディストリビューションをビルドするまで待ちます。

    エージェント JDK の追加

    TeamCity エージェントがサポートする Java バージョンについては、 サポートされているプラットフォームと環境ドキュメントの記事を参照してください。

ZIP ファイルからエージェントをインストールする方法

  1. TeamCity で エージェント ページを開き、サイドナビゲーションバーで 概要 を選択します。

  2. エージェントのインストール ボタンをクリックし、必要な オプションを選択します。

    エージェントの ZIP ディストリビューションダウンロードオプション

    最小限の ZIP ファイルディストリビューション オプションを選択すると、OS に依存しない最小限のアーカイブのダウンロードが開始されます。

    完全なディストリビューション オプションを選択した場合は、利用可能なエージェントアーカイブをバンドルされた JDK の有無の 2 つのカテゴリにグループ化する エージェントディストリビューション ページにリダイレクトされます。

    完全なエージェントディストリビューションページ

    JDK がバンドルされていないエージェントは、通常のアーカイブおよび Docker イメージ(英語)として利用できます。

  3. ダウンロードしたアーカイブを解凍します。

  4. <インストールパス>\conf ディレクトリを開き、 buildAgent.dist.properties ファイルの名前を ビルドエージェント.プロパティ に変更します。

  5. ビルドエージェント.プロパティ ファイルを編集して、TeamCity サーバー URL (HTTPS を推奨します。 こちらの注記を参照してください) とエージェントのお名前を指定します。 エージェント構成の詳細については、 この記事を参照してください。

Linux では、 bin/agent.sh シェルスクリプトに実行権限を与える必要がある場合があります。

Windows では、エージェントの手動起動を使用する代わりに、 ビルドエージェントの Windows サービスをインストールすることをお勧めします。

エージェントプッシュによるインストール

TeamCity は、ビルドエージェントをリモートホストにインストールできるエージェントプッシュ機能を提供します。 サーバーホストプラットフォームとビルドエージェントのターゲットのサポートされている組み合わせ:

  • Unix ベースの TeamCity サーバーからは、ビルドエージェントを Unix ホストにのみ (SSH 経由で) インストールできます。

  • Windows ベースの TeamCity サーバーからは、ビルドエージェントを Unix ホスト (SSH 経由) または Windows ホスト (psexec 経由) にインストールできます。

リモートホスト要件

リモートホストにはいくつかの要件があります。

プラットフォーム

前提条件

Linux

  • インストールされた JDK または JRE (サポートされている Java バージョン を参照)。 JVM は、 JAVA_HOME または JRE_HOME グローバル環境変数を介してアクセス可能であるか、(ユーザーの .bashrc ファイルなどで指定されるのではなく) グローバルパス内にある必要があります。

  • unzip ユーティリティ。

  • wget または curl のいずれか。

Windows

  • インストールされた JDK または JRE (サポートされている Java バージョン を参照)。

  • Sysinternals psexec.exe は TeamCity サーバーにインストールされ、パスでアクセス可能である必要があります。 管理 | ツール にインストールできます。 PsExec は、リモート Windows ホストに追加の要件を適用することに注意してください。 次の前提条件が満たされていることを確認してください。

    • リモートホスト上の 管理シェア(英語)が有効化され、アクセス可能です。

    • リモートサービスは機能します（MMCsnap インはマシンに接続できます）。

    • リモートレジストリは機能します（regedit は services.msc を介してマシンに接続できます）。

    • サーバーとワークステーションのサービスが実行されています（services.msc で確認してください）。

    • 従来のネットワーク認証が有効になります。

次のコマンドで接続をテストできます。

net use \\target\Admin$ /user:Administrator dir \\target\Admin$

インストール

エージェントプッシュ ページにアクセスするには、ユーザーは ビルドエージェントマシンの管理権限を持っている必要があることに注意してください。

  1. TeamCity UI で エージェント | エージェントプッシュ を開き、 エージェントのインストール をクリックします。
    複数のターゲットホストに同じ設定を使用する場合は、これらの設定で プリセットを作成 し、別のリモートホストにエージェントをインストールするたびに使用できます。

  2. エージェントをインストールするダイアログで、保存したプリセットを選択するか、「カスタム設定の使用 」を選択して、ターゲットホストプラットフォームを指定し、対応する設定を構成します。 SSH 経由の Linux システムへのエージェントプッシュは、 SSH ポートパラメーターとして指定されたカスタムポート (デフォルトは 22) をサポートします。 プリセットで指定されたポートは、実際のエージェントのインストール中にホスト名 (たとえば、 hostname.domain:2222) で上書きできます。

  3. Sysinternals psexec.exe をダウンロードする必要がある場合があります。その場合、対応する警告と、ダウンロードできる 管理 | ツール へのリンクが表示されます。

2026 年 9 月 11 日
TeamCity エージェントのインストールと起動エージェントインストールの構成