TeamCity エージェントをインストールする
TeamCity ビルドエージェントをインストールする前に、必ずシステム要件を参照してください。
便利なインストールオプションを選択してください。
Windows でインストーラーを使用する
任意のプラットフォームで ZIP ファイルから手動でインストールする
公式 TeamCity エージェントイメージ(英語)に基づいてコンテナーを準備する
Windows 実行可能ファイルからインストール
TeamCity でエージェントページを開きます。
ビルドエージェントをインストールするをクリックし、Windows インストーラーを選択してインストーラーをダウンロードします。
エージェントマシンで
agentInstaller.exeを実行し、インストール手順に従います。
エージェントサービスの実行に使用されるユーザーアカウントに適切な権限があることを確認してください。
ZIP ファイルからインストール
このオプションを使用すると、エージェントをエージェントマシンにコピーできるアーカイブとしてダウンロードできます。
利用可能なエージェントのディストリビューション
完全なエージェントディストリビューション物をダウンロードするか、最小限のエージェントディストリビューション物をダウンロードするかを選択できます。
最小限のエージェントディストリビューションは、プラグインのない通常のビルドエージェントです。最小限のエージェントは、最初の起動時に必要なすべてのプラグインをダウンロードします。
完全なエージェントディストリビューションには、サーバー上で現在有効になっているすべてのプラグインの関連バージョンが含まれます。これにより、完全なディストリビューションアーカイブのサイズは大きくなりますが、最初のエージェント実行にかかる時間が大幅に短縮されます。
エージェントイメージの作成にスクリプトを使用する場合 ( クラウドプロファイルなど)、完全なエージェントをお勧めします。完全なエージェントを備えたすべてのクラウドインスタンスは、起動した瞬間からサーバーと同期され、すぐにビルドを実行できます。
完全なエージェントのディストリビューションには、次の 2 つのバリエーションもあります。
Java 開発キットを含まない通常のエージェントのディストリビューション。このバリエーションをダウンロードしてインストールする場合は、エージェントマシンに必要な JDK バージョンがインストールされていること ( サポートされている Java バージョンを参照)、および
JRE_HOMEまたはJAVA_HOME環境変数が正しいインストールを指していることを確認してください。OS 固有の JDK がバンドルされたディストリビューション。これらのディストリビューションを使用すると、エージェントとそれに必要な JDK を一度にインストールできます。これらのディストリビューションをダウンロードするには、必要な JDK バージョンを管理 | エージェント JDK ページに追加し、TeamCity が関連するエージェントディストリビューションを構築するまで待ちます。
TeamCity エージェントがサポートする Java バージョンについては、サポートされているプラットフォームと環境ドキュメントの記事を参照してください。
ZIP ファイルからエージェントをインストールする方法
TeamCity でエージェントページを開き、サイドナビゲーションバーで概要を選択します。
エージェントをインストールするボタンをクリックし、必要なオプションを選択します。
最小限の ZIP ファイルディストリビューションオプションを選択すると、OS に依存しない最小限のアーカイブのダウンロードが開始されます。
完全な配布オプションを選択した場合は、利用可能なエージェントアーカイブをバンドルされた JDK の有無の 2 つのカテゴリにグループ化するエージェントのディストリビューションページにリダイレクトされます。
JDK がバンドルされていないエージェントは、通常のアーカイブおよび Docker イメージ(英語)として利用できます。
ダウンロードしたアーカイブを解凍します。
<installation path>\confディレクトリを開き、buildAgent.dist.propertiesファイルの名前をbuildAgent.propertiesに変更します。buildAgent.propertiesファイルを編集して、TeamCity サーバーの URL（HTTPS を推奨します。これらの注記を参照）とエージェントの名前を指定してください。エージェント構成の詳細については、この記事を参照してください。
Linux では、bin/agent.sh シェルスクリプトに実行権限を与える必要がある場合があります。
Windows では、エージェントの手動起動を使用する代わりに、ビルドエージェントの Windows サービスをインストールすることをお勧めします。
エージェントプッシュ経由でインストール
TeamCity は、ビルドエージェントをリモートホストにインストールできるようにするエージェントプッシュ機能を提供します。サーバーホストプラットフォームとビルドエージェントのターゲットのサポートされている組み合わせ:
Unix ベースの TeamCity サーバーから、ビルドエージェントは Unix ホストにのみ（SSH 経由で）インストールできます。
Windows ベースの TeamCity サーバーから、ビルドエージェントを Unix（SSH 経由）または Windows（psexec 経由）ホストにインストールできます。
リモートホスト要件
リモートホストにはいくつかの要件があります。
プラットフォーム | 前提条件 |
|---|---|
Linux |
|
Windows |
次のコマンドで接続をテストできます。
net use \\target\Admin$ /user:Administrator
dir \\target\Admin$
|
インストール
エージェントプッシュページにアクセスするには、ユーザーはビルドエージェントマシンの管理権限を持っている必要があることに注意してください。
TeamCity UI で、エージェント | エージェントプッシュを開き、エージェントをインストールをクリックします。
複数のターゲットホストに同じ設定を使用する場合は、これらの設定を含むプリセットを作成し、別のリモートホストにエージェントをインストールするたびにそのプリセットを使用できます。エージェントをインストールするダイアログで、保存したプリセットを選択するか、「カスタム設定の使用」を選択して、ターゲットホストプラットフォームを指定し、対応する設定を構成します。SSH 経由の Linux システムへのエージェントプッシュは、SSH ポートパラメーターとして指定されたカスタムポート (デフォルトは 22) をサポートします。プリセットで指定されたポートは、実際のエージェントのインストール中にホスト名 (たとえば、
hostname.domain:2222) で上書きできます。Sysinternals psexec.exeをダウンロードする必要がある場合があります。その場合、対応する警告と、ダウンロードできる管理 | ツールへのリンクが表示されます。
関連ページ：
システム要件
この記事には、TeamCity サーバーとエージェントの環境の選択と構成、およびそれらと専用の外部データベース間のネットワーク接続に関する一般的な推奨事項が含まれています。ここに記載されていない特定の質問がある場合は、便利なフィードバックチャネルを介してサポートに連絡してください。TeamCity サーバーの要件：サーバー OS/ プラットフォームの選択 TeamCity サーバーは、Windows、Linux、macOS の最新バージョンで実行できます。サーバーのオペレーティングシステムの要件...
クラウドのホストビルドエージェント
TeamCity とクラウド (IaaS) ソリューションの統合により、TeamCity は TeamCity エージェントをオンデマンドで実行する仮想マシンを提供できるようになります。これにより、TeamCity は現在のワークロードに応じてアクティブなビルドエージェントの数を自動的に調整できます。クラウドエージェントとエグゼキューター：TeamCity は次の 2 種類の統合をサポートしています。通常のクラウドエージェント。この統合タイプでは、ビルドエージェントをホストする環境として、クラ...
TeamCity エージェントをインストールして開始する
TeamCity ビルドエージェントは、TeamCity サーバーからのコマンドをリッスンし、実際のビルドプロセスを開始するソフトウェアです。実稼働の TeamCity セットアップでは、専用のマシンに追加のビルドエージェントをインストールする必要があります。その前に、エージェントとサーバー間の通信、システム要件、競合するソフトウェア、およびセキュリティに関する注意事項を必ず参照してください。Tomcat サーブレットコンテナーにバンドルされた TeamCity をインストールするか、Window...