エージェントホームディレクトリ
エージェントホームディレクトリの構築は、エージェントがインストールされているディレクトリです。
ビルドエージェントは任意のディレクトリにインストールできます。 ビルドエージェントのインストールを選択して TeamCity .tar.gz ディストリビューションまたは .exe ディストリビューションを使用する場合、エージェントは <TeamCity ホーム>/ビルドエージェント に配置されます。 .exe エージェントのインストールで提案されるデフォルトのディレクトリは C:\BuildAgent です。
エージェントは関連するすべてのデータをそのディレクトリに保存します。 OS へのインストール / アンインストールが必要なのは、 自動起動システムへの統合のみです (たとえば、Windows のサービス設定)。
エージェントディレクトリ
エージェントは以下で構成されています。
エージェントバイナリ（
bin、launcher、ライブラリディレクトリに保存されます）。 バイナリは、サーバーのバージョンに一致するようにサーバーから自動的に更新できます。エージェントプラグインおよびツール（
pluginsおよびtoolsディレクトリに格納されています）。 エージェントバイナリのインストールの一部であり、エージェント自体によって管理され、TeamCity サーバーから必要に応じて自動的に更新されます。エージェント構成（
confおよびlauncher\confディレクトリに保管されています）。 これは、エージェントの設定と動作を定義する独自の情報です。エージェント作業ディレクトリ (デフォルトでは
workディレクトリに保存され、エージェント構成で変更できます)。エージェント補助データ（
system、temp、backup、updateディレクトリに保管）。 エージェントの実行中に必要なデータ。エージェントログ（
logsディレクトリに保存）: エージェントの問題を調査するために必要になる可能性のある内部エージェントログを保存するディレクトリ。
エージェントファイルの変更
エージェント構成ディレクトリは、ユーザーが編集できるファイルを持つように設計された唯一のものです。 他のディレクトリはすべてユーザーが編集しないでください。
エージェント作業ディレクトリの内容は削除できます (ただし、完全にのみ)。 その結果、影響を受けるすべてのビルドで クリーンチェックアウトが実行されます。
エージェントの補助データを格納しているディレクトリの内容は削除できます（ただし、完全にのみ、エージェントが実行されていない間にのみ）。 データを削除すると、このエージェントでの次回のビルド時に余分なアクションが発生する可能性がありますが、これはパフォーマンスへの影響のみを意味し、一貫性には影響しません。
重要なエージェントファイルとディレクトリ
/バイナリ
agent.bat— Windows のコンソールからビルドエージェントを開始 / 停止するバッチスクリプト。agent.sh— Linux/Unix でビルドエージェントを開始 / 停止するシェルスクリプト。service.install.bat— ビルドエージェントを Windows サービスとしてインストールするためのバッチファイル。 関連セクションも参照してください。service.start.bat— インストールされたビルドエージェントサービスを使用してビルドエージェントを開始します。service.stop.bat— インストールされているビルドエージェントサービスを停止します。service.uninstall.bat— 現在インストールされているビルドエージェントの Windows サービスをアンインストールするためのバッチファイル。
/conf/: このディレクトリには、ビルドエージェントのすべての構成ファイルが含まれています。
ビルドエージェント.プロパティ— メイン設定ファイル。 このファイルは、TeamCity サーバーの.exeインストーラーとビルドエージェントの.exeインストーラーによって生成されます。buildAgent.dist.properties— サンプル構成ファイル。 これをビルドエージェント.プロパティに名前変更して、初期エージェント構成ファイルを作成できます。teamcity-agent-log4j.xml— エージェントのログ設定を作成します。 詳細については、ファイル内のコメントまたは log4j マニュアル(英語)を参照してください。
/launcher/conf/
wrapper.conf.template— 元の構成を作成するためのテンプレートとして使用されるサンプル構成ファイル。wrapper.conf— 現在のビルドエージェント Windows サービス構成。 これは、Java Service Wrapper 設定 java プロパティファイルです。 詳細については、ファイル内のコメントまたは Java Service Wrapper のドキュメントを参照してください。
/ログ
ランチャー.ログ。— ビルドエージェントランチャーのログ。teamcity-agent.log— メインビルドエージェントログ。wrapper.log— Java ServiceWrapper のログ。 ビルドエージェントが Windows サービスとして実行されている場合にのみ使用できます。teamcity-build.log— ビルドからログを記録します。upgrade.log— ビルドエージェントのアップグレードプロセスからログを記録します。teamcity-vcs.log— エージェント側のチェックアウトログ。
/system
.artifacts_cache— すべてのビルドのアーティファクトのキャッシング。 構成可能です。
/一時: 一時ディレクトリ ; パスは
ビルドエージェント.プロパティファイルでオーバーライドできます。agentTmp— ビルド中にビルド関連ファイルを保存するためにビルドエージェントによって使用される一時ディレクトリ。 ビルドごとにクリーニングされます。buildTmp— ビルドプロセスのデフォルトの一時ディレクトリとして設定され、ビルドごとにクリーンアップされる一時ディレクトリglobalTmp— ビルドエージェントが自身の一時ファイルに使用する一時ディレクトリ。 エージェントの再起動時にクリーンアップされます。