エージェントツールのインストール
TeamCity では、エージェントツールは、エージェントを構築するためのファイルをディストリビューションするためだけに使われるプラグインの一種です。エージェントツールは、ファイルのセットまたはバイナリディストリビューションになります。そのクラスはランタイムにロードされません。
TeamCity を使用すると、サーバー上で追加のツールをインストール / 削除し、オンデマンドでエージェントを構築するために配布することができます。
ビルドエージェントが多数ある環境では、構成ファイルのディストリビューションを一元化したり (たとえば、カスタム構成ファイル / ライブラリを必要とするすべてのエージェントにディストリビューションする場合)、エージェント上のツールを一度に削除したりできます。
管理 | ツールページは、適切なプラグインによって使用されるツールをセットアップするための統一されたインターフェースを提供します。ツールの異なるバージョンをインストールしたり、デフォルトバージョンを変更したりできます。ツールは、要求するエージェントをビルドするために自動的に配布され、関連するランナーで使用されます。
管理 | ツールページでは、次の種類のツールを管理できます。
IntelliJ インスペクションと重複エンジンと IntelliJ IDEA バージョン。サーバーの初回起動後に TeamCity が自動的にダウンロードしてインストールします。TeamCity が IntelliJ IDEA のダウンロードとインストールに失敗した場合:
管理 | ツールに移動します。
「IntelliJ インスペクションと重複エンジン」セクションまでスクロールし、「バージョンをインストール ...」をクリックします。
アップロードモードを選択し、ファイルの選択をクリックしてツールをアップロードします。
バンドルバージョンがデフォルトに設定された JetBrains dotCover コマンドラインツール。.NET プロジェクトのコードカバレッジを収集するために使用します。ダウンロードダイアログで利用可能な dotCover バージョンのリストは NuGet から取得され、現在の TeamCity サーバーバージョンに依存しません。
JetBrains ReSharper コマンドラインツール : デフォルトでは、これらのツールは TeamCity にバンドルされており、コード分析を実行するためにインスペクション（.NET）、重複ファインダー（.NET）ビルドランナーによって使用されます。
Maven: バンドルされているいくつかのバージョンが表示され、3.6.3 がデフォルトとして設定されています。
NuGet 固有のビルド手順および NuGet 依存関係トリガーで使用される NuGet.exe。
tools/NuGet.exeファイルを含む NuGet パッケージ（.nupkgファイル）がサポートされています。NUnit 3 : 異なるバージョンをインストールし、デフォルトのバージョンを設定 / 変更できます。
Sysinternals handle.exe は、Windows エージェントのチェックアウトディレクトリにファイルを保持するプロセスを決定するために使用されていました。
Sysinternals psexec.exe は、エージェントプッシュを使用して TeamCity エージェントを Windows サーバーから Windows ホストにインストールするために必要です。
独自のツールを
.zip、.tar、または.tar.gzアーカイブとして保存するもアップロードできます: ツールプラグインの構造はプラグインパッケージングページ(英語)に記述されています。TeamCity は、すべてのエージェントでツール名として ZIP ファイルの名前を使用します。ZIP ファイルは、エージェント上で同じ名前のディレクトリに自動的に解凍されます。
最初のカスタムツールがインストールされると、ページにカスタムアーカイブセクションが表示されます。このセクションでは、すべてのツールの使用状況を確認したり、ツールを削除したり、新しいツールをインストールしたりできます。
TeamCity はインストールされたツールを <TeamCity Data Directory> /plugins/.tools に配置し、このディレクトリの内容を監視します。
エージェントは、それを必要とする最初のビルドを開始する前にツールをダウンロードします。ダウンロードすると、ツールはエージェントに保存されるため、ビルドが再度ダウンロードするのに時間を費やすことはありません。
ツールに直接依存するビルドステップの設定を編集する場合は、ドロップダウンメニューからこのツールの特定のバージョンを選択するだけで、TeamCity にエージェントに配信する正確なツールを知らせることができます。
ただし、任意のビルドスクリプトで特定のツールが必要になる場合があります。そのような場合、パラメーターの入力をサポートするビルドステップ設定の %teamcity.tool.<installed_tool_ID>% パラメーターを介して必要なツールを参照できます。また、ビルド構成パラメーターの値やエージェント要件でツールを参照することもできます。たとえば、エージェント要件の場合、%teamcity.tool.<installed_tool_ID>% という名前のパラメーターに型 exists の要件を定義すると、ビルドに参照されたツールが必要であることが TeamCity に指示されます。ビルドを開始する前に、TeamCity サーバーはすべてのビルドステップの設定をスキャンし、そのようなツール参照をすべて見つけて、ビルドに必要なツールをエージェントに通知します。
ツールがエージェントに表示されることを確認するには、TeamCity UI でエージェントによって報告された構成パラメーターで teamcity.tool.<installed_tool_ID> を探します。
TeamCity UI でツールを削除すると、このツールがインストールされている各エージェントがこれを検出し、ツールの独自のコピーを削除して、再起動します。
関連ページ：
TeamCity エージェントをインストールして開始する
TeamCity ビルドエージェントは、TeamCity サーバーからのコマンドをリッスンし、実際のビルドプロセスを開始するソフトウェアです。実稼働の TeamCity セットアップでは、専用のマシンに追加のビルドエージェントをインストールする必要があります。その前に、エージェントとサーバー間の通信、システム要件、競合するソフトウェア、およびセキュリティに関する注意事項を必ず参照してください。Tomcat サーブレットコンテナーにバンドルされた TeamCity をインストールするか、Window...
dotCover
dotCover ランナーは、JetBrains dotCover を使用して .NET プロセスのカバレッジレポートを生成します。生成されたレポートは、ビルド結果ページのコードカバレッジタブに公開されます。このランナーは、複数の先行する .NET ステップの後に配置して、個々のコードカバレッジをマージし、統合レポートを公開することもできます。dotCover ステップ設定：このセクションでは、ランナー設定の使用方法について説明します。現在のタスクに応じてこれらの設定を組み合わせる方法の例については、...
.NET
TeamCity.NET ビルドステップを使用すると、.NET (Core) および .NET フレームワークを対象とするアプリケーションをビルド、テスト、デプロイできるほか、NuGet パッケージをダウンロードしてプッシュすることもできます。.NET ステップイン構成とパイプライン：クラシックビルド構成では、.NET は、選択したコマンドに応じて設定が変化する単一のビルドステップです。パイプラインでは、これらの各コマンドは個別のビルドステップとして使用できます。エージェント要件：.NET ス...
NUnit
NUnit ビルドランナーは、TeamCity サーバーで NUnit テストを実行するように設計されています。ただし、.NET ランナーを使用して NUnit テストを起動し、TeamCity でテストレポートを表示することもできます。詳細については、TeamCity での NUnit サポートの記事を参照してください。レガシーおよび更新された NUnit ランナー：バージョン 2024.07 では、更新された NUnit ランナーが導入されました。従来のランナーと比較すると、.NET ランタイ...
TeamCity データディレクトリ
TeamCity データディレクトリは、TeamCity サーバーが構成、ビルド結果、現在の操作ファイルを保存するために使用するファイルシステム上のディレクトリです。このディレクトリは、すべての構成設定の 1 次ストレージであり、TeamCity のインストールに不可欠なデータを保持します。ビルド履歴、ユーザーとそのデータ、その他のデータはデータベースに保存されます。ディレクトリとデータベースに保存されるデータの説明については、バックアップに関する注意事項を参照してください。このドキュメントや他...
ビルドパラメーターの設定
パラメーターは、TeamCity 設定およびビルドスクリプトの構文を介して参照するペアです。パラメーター部分は、生の値 () にすることも、別のパラメーターへの参照 () を含めることもできます。パラメーター型：TeamCity は 3 種類のパラメーターをサポートしています。構成パラメーター — ビルド構成内で設定を共有することを主な目的とするパラメーター。これらのパラメーターを使用して、テンプレートから作成された構成やレシピを使用する構成をカスタマイズすることもできます。TeamCity は...