エージェント用 Java の構成

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

.exe TeamCity エージェントディストリビューションには、64 ビット版の Amazon Corretto 21 が同梱されています。 .zip エージェントをインストールするには、適切な Java バージョンをインストールする必要があります。 パス 経由で、または以下のいずれかの場所に Java をインストールしてください。

• <エージェントホーム>/jre ディレクトリ

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

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

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

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

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

TeamCity Agent で現在サポートされている Java バージョンに関する情報は、 こちらで確認できます。

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

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

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

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

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

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

Java の自動アップグレード

Java がパッケージマネージャー経由でインストールされている場合 (Linux の apt-get など)、利用可能な最新バージョンに Java がサイレントに更新されることがあります。 このバージョンが TeamCity でサポートされている場合でも、特定の課題につながることがあります。 たとえば、すでに実行中のビルドエージェントは再起動する必要があります。そうしないと、正解の JDK を見つけられず、タスクの実行に失敗します。

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