TeamCity 2020.1ヘルプ

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

エージェントホームディレクトリの構築は、エージェントがインストールされているディレクトリです。

ビルド・エージェントは任意のディレクトリにインストールできます。TeamCity .tar.gzディストリビューションまたは.exeディストリビューションオプションを使用してビルド・エージェントをインストールすると、エージェントは < TeamCity Home >/buildAgentに配置されます。.exeエージェントのインストールで推奨されるデフォルトのディレクトリは C:\BuildAgentです。

エージェントはすべての関連データをそのディレクトリに格納し、OSへのインストール/アンインストールが必要な唯一の場所は自動起動システムに統合されています (たとえば、Windowsのサービス設定)。

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

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

  • エージェントバイナリ( 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 Service WrapperのログビルドエージェントがWindowsサービスとして実行されている場合にのみ使用可能

    • teamcity-build.log - ビルドからのログ

    • upgrade.log - ビルドエージェントのアップグレードプロセスからのログ

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

  • /system

    • .artifacts_cache - すべてのビルドのアーティファクトをキャッシュします。設定可能

  • /temp : 一時フォルダーパスは buildAgent.properties ファイルで上書きすることができます
    • agentTmp - ビルド中にビルド関連ファイルを格納するためにビルドエージェントが使用する一時フォルダー。各ビルド後に清掃されます。

    • buildTmp - ビルドプロセスのデフォルトの一時ディレクトリとして設定され、各ビルド後に消去される一時フォルダー

    • globalTmp - 自身の一時ファイル用にビルドエージェントによって使用される一時フォルダー。エージェントの再起動時に消去されます。