エージェントホームディレクトリ

エージェントディレクトリ

エージェントは以下で構成されています。

• エージェントバイナリ（bin、launcher、lib ディレクトリに保存されます）。バイナリは、サーバーのバージョンに一致するようにサーバーから自動的に更新できます。

• エージェントプラグインおよびツール（plugins および tools ディレクトリに格納されています）。これらはエージェントバイナリインストールの一部であり、エージェント自体によって管理され、TeamCity サーバーから必要に応じて自動的に更新されます。

• エージェント構成（conf および launcher\conf ディレクトリに保管されています）。これは、エージェントの設定と動作を定義する独自の情報です。

• エージェント作業ディレクトリ (デフォルトでは work ディレクトリに保存されますが、エージェント構成で構成可能です)。

• エージェント補助データ（system、temp、backup、update ディレクトリに保管）。エージェントの実行中に必要なデータ。

• エージェントログ（logs ディレクトリに保存）: エージェントの問題を調査するために必要になる可能性のある内部エージェントログを保存するディレクトリ。

重要なエージェントファイルとディレクトリ

• /bin

  • agent.bat — Windows のコンソールからビルドエージェントを開始 / 停止するバッチスクリプト。

  • agent.sh — Linux/Unix でビルドエージェントを開始 / 停止するシェルスクリプト。

  • service.install.bat — ビルドエージェントを Windows サービスとしてインストールするためのバッチファイル。関連セクションも参照してください。

  • service.start.bat — インストールされたビルドエージェントサービスを使用してビルドエージェントを開始します。

  • service.stop.bat — インストールされているビルドエージェントサービスを停止します。

  • service.uninstall.bat — 現在インストールされているビルドエージェントの Windows サービスをアンインストールするためのバッチファイル。

• /conf/ : このディレクトリには、ビルドエージェントのすべての構成ファイルが含まれています。

  • buildAgent.properties — メイン設定ファイル。このファイルは、TeamCity サーバーの .exe インストーラーとビルドエージェントの .exe インストーラーによって生成されます。

  • buildAgent.dist.properties — サンプル構成ファイル。これを buildAgent.properties に名前変更して、初期エージェント構成ファイルを作成できます。

  • teamcity-agent-log4j.xml — エージェントのログ設定を作成します。詳細については、ファイル内のコメントまたは log4j マニュアル(英語)を参照してください。

• /launcher/conf/

  • wrapper.conf.template — 元の構成を作成するためのテンプレートとして使用されるサンプル構成ファイル。

  • wrapper.conf — 現在のビルドエージェント Windows サービス構成。これは、Java Service Wrapper 設定 java プロパティファイルです。詳細については、ファイル内のコメントまたは Java Service Wrapper のドキュメントを参照してください。

• /logs

  • launcher.log — ビルドエージェントランチャーのログ。

  • teamcity-agent.log — メインビルドエージェントログ。

  • wrapper.log — Java ServiceWrapper のログ。ビルドエージェントが Windows サービスとして実行されている場合にのみ使用できます。

  • teamcity-build.log — ビルドからログを記録します。

  • upgrade.log — ビルドエージェントのアップグレードプロセスからログを記録します。

  • teamcity-vcs.log — エージェント側のチェックアウトログ。

• /system

  • .artifacts_cache — すべてのビルドのアーティファクトのキャッシュ。構成することができます。

• /temp : 一時ディレクトリ ; パスは buildAgent.properties ファイルでオーバーライドできます。

  • agentTmp — ビルド中にビルド関連ファイルを保存するためにビルドエージェントによって使用される一時ディレクトリ。ビルドごとにクリーニングされます。

  • buildTmp — ビルドプロセスのデフォルトの一時ディレクトリとして設定され、ビルドごとにクリーンアップされる一時ディレクトリ

  • globalTmp — ビルドエージェントが自身の一時ファイルに使用する一時ディレクトリ。エージェントの再起動時にクリーンアップされます。