虎の巻: サーバーおよびエージェントマシン上の Java の更新

TeamCity Windows インストーラーとサーバー版 Docker イメージには Amazon Corretto(英語) 64 ビット版 Java 21 が含まれているため、手動でインストールする必要はありません。TeamCity 2025.11 インストーラーを実行するだけで、必要な JDK が提供されます。

TeamCity サーバーの .tar.gz アーカイブには Java が含まれていないため、手動でインストールする必要があります。インストールする JDK はプラットフォームに合わせてください。例: Amazon Corretto 21(英語) は、ARM64 と x86_64 の両方のアーキテクチャで動作する Linux と macOS 向けに異なるオプションを提供しています。

Java 21 をインストールしたら、対応するインストールパスを JAVA_HOME または TEAMCITY_JRE 環境変数に割り当てます。詳細な手順については、こちらの StackOverflow スレッド(英語)を参照してください。

• JAVA_HOME は、マシンのデフォルトの JDK を指定するグローバル変数です。この変数を設定すると、java -version ターミナルコマンドは対応するバージョンを指すようになります。

• TEAMCITY_JRE 変数は TeamCity によってのみ使用され、他のアプリケーションのデフォルトとして異なる Java バージョンを使い続けることができます。

エージェントマシンをアップグレードする前に、潜在的な問題を回避するために既存のエージェントをアンインストールすることをお勧めします。

1. エージェントのホームディレクトリに移動し、Uninstall.exe を実行し、すべての「削除 ...」チェックボックスをオフのままにして、アンインストールを完了します。

2. ブラウザーで TeamCity UI を開き、ログインします。

3. サイドナビゲーションバーで、エージェントを開きます。

4. エージェントをインストールするをクリックし、JDK にバンドルされている .exe エージェントインストーラーをダウンロードします。

5. 更新が必要なすべてのエージェントマシンでこのインストーラーを実行します。

ビルドエージェントをサービスとして実行する場合は、<agent_home>/launcher/conf/wrapper.conf ファイルの wrapper.java.command プロパティが必要な Java バージョンを指していることを確認してください。詳細については、次の記事を参照してください: ビルドエージェント Windows サービスラッパーのアップグレード。

エージェントマシンを更新するには、サーバーと同じ手順に従います。または、必要な JDK がバンドルされているエージェントアーカイブをインストールすることもできます。その手順は次のとおりです。

1. TeamCity UI で管理 | エージェント JDK に移動します。

2. 必要な Java バージョンをアップロードするには、JDK を追加をクリックします。

3. TeamCity が対象の JDK をダウンロードすると、対応するオプションがエージェント | エージェントをインストールする | JDK を使用したエージェントのディストリビューションに表示されます。エージェントの完全インストールには /jre ディレクトリが含まれます。エージェントを起動すると、JAVA_HOME および TEAMCITY_JRE 環境変数によって返されるバージョンよりも、このディレクトリの Java が優先されます。