第1章 Red Hat build of Quarkus 3.15 へのアプリケーションの移行
アプリケーション開発者は、quarkus CLI または Maven を使用して、Red Hat build of Quarkus バージョン 3.2 以降をベースとするアプリケーションをバージョン 3.15 に移行できます。
Quarkus CLI は、Quarkus プロジェクトの作成、更新、ビルドなどのタスクを含む開発目的で使用されます。Red Hat は、実稼働環境での Quarkus CLI の使用をサポートしていません。
1.1. プロジェクトを Red Hat build of Quarkus の最新バージョンに更新する リンクのコピーリンクがクリップボードにコピーされました!
Red Hat build of Quarkus プロジェクトを最新バージョンに更新するには、このガイドの後半で詳しく説明する次の手順に従います。
-
quarkusCLI または Maven コマンドを使用して、自動更新タスクを実行します。 - 以前のバージョンとの互換性に影響を与える変更 セクションを参照して、手動更新タスクを実行します。
1.1.1. 自動更新 リンクのコピーリンクがクリップボードにコピーされました!
quarkus CLI または Maven コマンドを実行すると、プロジェクトの依存関係とソースコードをアップグレードする OpenRewrite レシピがトリガーされます。この自動化されたアプローチにより、信頼性の高い便利な方法でプロジェクトを更新できます。
ただし、すべての移行タスクが自動化されるわけではありません。quarkus update コマンドまたは Maven の同等のコマンドを実行しても、特定の更新が適用されない場合は、次の理由が考えられます。
- 必要な移行タスクが利用可能な OpenRewrite レシピの対象外である。
- プロジェクトが依存するエクステンションと Red Hat build of Quarkus の最新バージョンの間に互換性がない。
1.1.2. 手動更新 リンクのコピーリンクがクリップボードにコピーされました!
手動更新では、あらゆる移行タスクに対応する柔軟性と制御性が得られ、プロジェクトを特定のニーズに合わせて調整できます。自動化されていないタスクは手動で処理する必要があります。
以前のリリースからこのリリースに更新するために必要な移行タスクのリストは、このガイドの 以前のバージョンとの互換性に影響を与える変更 セクションを参照してください。
アプリケーションプロジェクトの現在のバージョンからアップグレード先のバージョンまでの間にリリースされた各バージョンの移行ガイドを確認することが重要です。この確認作業により、更新プロセスについて十分な情報が得られ、準備が整います。たとえば、バージョン 3.8 から 3.15 にアップグレードする場合は、このガイドを確認するだけで済みます。バージョン 3.2 から 3.15 にアップグレードする場合は、このガイドの中間バージョン Red Hat build of Quarkus 3.8 へのアプリケーションの移行 ガイドも確認する必要があります。
この移行ガイドの各タスクで、必要な変更の概要を示し、その変更が quarkus update コマンドとそれに相当する Maven によって自動的に処理されるかどうかを示します。
その他の背景情報は、Quarkus コミュニティーの Migration guides を参照してください。