エージェントツールのインストール
TeamCity では、 エージェントツールは、 ビルドエージェントにファイルを配布するためだけに使用されるプラグインの一種です。 エージェントツールは、ファイルのセットまたはバイナリディストリビューションになります。 そのクラスはランタイムにロードされません。
TeamCity では、サーバーに追加ツールをインストール/削除し、必要に応じてビルドエージェントに配布できます。
多数のビルドエージェントがある環境では、構成ファイルの配布を一元化したり (たとえば、それを必要とするすべてのエージェントにカスタム構成ファイル/ライブラリを配布したい場合)、エージェント上のツールを一括で削除したりできます。
管理 | ツール ページは、適切なプラグインによって使用されるツールをセットアップするための統一されたインターフェースを提供します。 ツールの異なるバージョンをインストールしたり、デフォルトバージョンを変更したりできます。 ツールは、要求するエージェントをビルドするために自動的に配布され、関連するランナーで使用されます。
管理 | ツール ページでは、次の種類のツールを管理できます。
IntelliJ インスペクションおよび重複エンジン は、サーバーの初回起動後に TeamCity が自動的にダウンロードしてインストールする IntelliJ IDEA バージョンです。 TeamCity が IntelliJ IDEA のダウンロードとインストールに失敗した場合:
管理 | ツール に移動します。
「IntelliJ インスペクションおよび重複エンジン 」セクションまでスクロールし、「バージョンをインストール… 」をクリックします。
アップロード モードを選択し、 ファイルを選択 をクリックしてツールをアップロードします。
バンドルバージョンがデフォルトに設定された JetBrains dotCover コマンドラインツール。 .NET プロジェクトのコードカバレッジを収集するために使用します。 ダウンロード ダイアログで利用可能な dotCover バージョンの一覧は NuGet から取得され、現在の TeamCity サーバーバージョンには依存しません。
JetBrains ReSharper コマンドラインツール: デフォルトでは、これらのツールは TeamCity にバンドルされており、コード解析を実行するためにインスペクション (.NET)、Duplicates Finder (.NET) ビルドランナーによって使用されます。
Maven: バンドルされているいくつかのバージョンが表示され、3.6.3 がデフォルトとして設定されています。
NuGet 固有のビルド手順および NuGet 依存関係トリガーで使用される NuGet.exe。
tools/NuGet.exeファイルを含む NuGet パッケージ（.nupkgファイル）がサポートされています。NUnit 3: 異なるバージョンをインストールし、デフォルトのバージョンを設定 / 変更できます。
Sysinternals handle.exe は、Windows エージェントのチェックアウトディレクトリにファイルを保持するプロセスを決定するために使用されていました。
Sysinternals psexec.exe は、Agent push を使用して Windows サーバーから Windows ホストに TeamCity エージェントをインストールするために必要です。
独自のツールを
.zip、.tar、または.tar.gzアーカイブとして をアップロードすることもできます。ツールプラグインの構造については、 Plugins Packaging ページで説明されています。 TeamCity は ZIP ファイルの名前をすべてのエージェント上のツール名として使用します。 ZIP ファイルは、エージェント上で同じお名前のディレクトリに自動的にアンパックされます。
最初のカスタムツールがインストールされると、 カスタムアーカイブ セクションがページに表示されます。 このセクションでは、すべてのツールの使用箇所を確認し、ツールを削除したり、新しいツールをインストールしたりできます。
TeamCity はインストール済みツールを <TeamCity データディレクトリ>/プラグイン/.ツール に配置し、このディレクトリの内容を監視します。
エージェントは、それを必要とする最初のビルドを開始する前にツールをダウンロードします。 ダウンロードすると、ツールはエージェントに保存されるため、ビルドが再度ダウンロードするのに時間を費やすことはありません。
ツールに直接依存するビルドステップの設定を編集する場合は、ドロップダウンメニューからこのツールの特定のバージョンを選択するだけで、どのツールをエージェントに配信する必要があるかを TeamCity に知らせることができます。
ただし、任意のビルドスクリプトで特定のツールが必要になる場合があります。 そのような場合、パラメーターの入力をサポートするビルドステップ設定の %teamcity.tool.<installed_tool_ID>% パラメーターを介して必要なツールを参照できます。 また、 ビルド構成パラメーターの値や エージェント要件でツールを参照することもできます。 たとえば、エージェント要件の場合、 %teamcity.tool.<installed_tool_ID>% という名前のパラメーターに対して 存在する 型の要件を定義すると、ビルドに参照されたツールが必要であることが TeamCity に伝わります。 ビルドを開始する前に、TeamCity サーバーはすべてのビルドステップの設定をスキャンし、そのようなツール参照をすべて見つけて、ビルドに必要なツールをエージェントに通知します。
ツールがエージェントに表示されることを確認するには、TeamCity UI の エージェントから報告された構成パラメーターで teamcity.tool.<installed_tool_ID> を探します。
TeamCity UI でツールを削除すると、そのツールがインストールされている各エージェントが検出し、ツールの自身のコピーを削除して再起動します。