TeamCity 2020.2 ヘルプ

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

The Build Agent Home Directory is the directory where the agent is installed.

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

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

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

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

  • agent binaries (stored under binlauncherlib directories). The binaries can be automatically updated from the server to match the server version.

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

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

  • エージェントの作業ディレクトリ(デフォルトでは work ディレクトリに保存され、エージェントの設定で設定可能)。

  • エージェント補助データ( systemtempbackupupdate ディレクトリに保管)。エージェントの実行中に必要なデータ。

  • エージェントログ( logs ディレクトリに格納されています):エージェント問題の調査に必要となる可能性がある内部エージェントログを格納しているディレクトリ。

エージェントファイルの変更

エージェント構成ディレクトリは、ユーザーが編集できるファイルを持つように設計された唯一のものです。他のディレクトリはすべてユーザーが編集しないでください。

エージェントの作業ディレクトリの内容は削除できます(ただし、完全に削除できます)。これにより、影響を受けるすべてのビルドがクリーンにチェックアウトされます。

エージェントの補助データを格納しているディレクトリの内容は削除できます(ただし、完全にのみ、エージェントが実行されていない間にのみ)。データを削除すると、このエージェントでの次回のビルド時に余分なアクションが発生する可能性がありますが、これはパフォーマンスへの影響のみを意味し、一貫性には影響しません。

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

  • /bin

    • agent.bat — batch script to start/stop the build agent from the console under Windows.

    • agent.sh — shell script to start/stop the build agent under Linux/Unix.

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

    • service.start.bat — starts the build agent using the installed build agent service.

    • service.stop.bat — stops the installed build agent service.

    • service.uninstall.bat — batch file to uninstall the currently installed build agent Windows service.

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

    • buildAgent.propertiesmain configuration file. This file is generated by the TeamCity server .exe installer and build agent .exe installer.

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

    • teamcity-agent-log4j.xml — build agent logging settings. For details, refer to comments inside the file or to the log4j マニュアル(英語)

  • /launcher/conf/

    • wrapper.conf.template — sample configuration file to be used as a template for creating the original configuration.

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

  • /logs

    • launcher.log — log of the build agent launcher.

    • teamcity-agent.log — main build agent log.

    • wrapper.log — log of the Java Service Wrapper. Available only if the build agent is running as a windows service.

    • teamcity-build.log — log from the build.

    • upgrade.log — log from the build agent upgrade process.

    • teamcity-vcs.log — agent-side checkout logs.

  • /system

    • .artifacts_cache — cache for all build's artifacts; can be configured.

  • /temp: 一時フォルダー ; パスは buildAgent.properties ファイルでオーバーライドできます。
    • agentTmp — ビルド中にビルド関連ファイルを保存するためにビルドエージェントによって使用される一時フォルダー。ビルドごとにクリーンアップされます。

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

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