エージェント用に Java を構成する

エージェントマシン上の Java へのパス

.exe TeamCity エージェントディストリビューションは、64 ビット Amazon Corretto 17 にバンドルされています。.zip エージェントのインストールには、適切な Java バージョンをインストールする必要があります。PATH 経由または次のいずれかの場所で利用できるようにしてください。

• <Agent home>/jre ディレクトリ

• TEAMCITY_JRE、JAVA_HOME、JRE_HOME 環境変数が指すディレクトリ (変数の 1 つだけが定義されていることを確認してください)

• エージェントを Windows サービスとして実行する場合は、<agent home>\launcher\conf\wrapper.conf ファイルの wrapper.java.command プロパティを Java 実行可能ファイルへの有効なパスに設定してください。

エージェントでの Java のアップグレード

エージェントを起動しようとしたときに、デフォルトの場所のいずれにも必要な Java バージョンが見つからない場合、エージェントは起動時にエラーを報告し、プロセスは起動せず、エージェントは TeamCity UI で切断された状態として表示されます。

ビルドエージェントがサポートされていない、または将来の TeamCity バージョンで廃止される予定の Java バージョンを使用している場合は、エージェントのページに該当する警告が表示され、UI に正常性項目が表示されます。

TeamCity エージェントで現在サポートされている Java バージョンに関する情報は、こちらから入手できます。

エージェント上の Java を更新するには、以下のいずれかを実行します。

• 同じビット数の新しい Java バージョンがインストールされていることをエージェントが検出すると、TeamCity UI のエージェントの詳細ページに自動更新アクションが表示されます。このアクションをクリックして、新しい Java を使用してエージェントを再起動します。エージェントは、現在のビルドを終了してアイドル状態になった後に再起動します。

• (Windows) ビルドエージェントの Windows インストーラーには必要な Java がバンドルされているため、TeamCity サーバーのエージェントページから取得した Windows インストーラー (.exe) を使用して、エージェントを手動で再インストールできます。インストール手順を参照してください。更新されたエージェントをインストールする前に、以前のバージョンのエージェントをアンインストールすることが重要です。エージェントホームディレクトリで Uninstall.exe を呼び出し、すべての「除去」チェックボックスをオフにして、アンインストールをクリックします。

• 必要な Java バージョンをエージェントの標準の場所の 1 つにインストールし、エージェントを再起動します。エージェントはそれを検出し、UI で新しい Java を使用するためのアクションを提供する必要があります。

• 必要な Java をエージェントにインストールし、それを使用するようにエージェントを構成します。

詳細については、この記事を参照してください: バンドルされていないバージョンの Java をインストールする方法。

無人 Java アップグレード

Java がパッケージマネージャー（たとえば、Linux の apt-get）経由でインストールされた場合、Java が最新バージョンにサイレントアップデートされる可能性があります。このバージョンが TeamCity でサポートされている場合でも、特定の問題が発生する可能性があります。たとえば、すでに実行中のビルドエージェントは再起動する必要があります。再起動しないと、正しい JDK が見つからず、タスクの実行に失敗します。

これらの潜在的な問題を回避するには、Java をインストールし、JAVA_HOME および TEAMCITY_JRE 環境変数を手動で構成することをお勧めします。例: 次のコマンドを実行して、Ubuntu の無人アップグレード(英語)を無効にすることができます。