Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

第1章 Red Hat build of Quarkus 3.2 へのアプリケーションの移行

アプリケーション開発者は、Quarkus CLI の update コマンドを使用 して、Red Hat build of Quarkus の以前のバージョンをベースとするアプリケーションをバージョン 3.2 に移行できます。

重要

Quarkus CLI は開発モードのみを対象としています。Red Hat は、実稼働環境での Quarkus CLI の使用をサポートしていません。

1.1. プロジェクトを最新の Red Hat build of Quarkus に更新する
リンクのコピー

update コマンドを使用して、Red Hat build of Quarkus プロジェクトを最新バージョンに更新またはアップグレードできます。

update コマンドは主に OpenRewrite レシピを使用して、プロジェクトの依存関係、ソースコード、ドキュメントの更新をほぼすべて自動化します。レシピは多くの移行タスクを実行しますが、移行ガイドで詳しく説明されているすべてのタスクに対応しているわけではありません。

更新後に、予期した更新が欠落している場合は次の理由が考えられます。

  • update コマンドによって適用されるレシピに、プロジェクトに必要な移行タスクが含まれていない可能性があります。
  • プロジェクトで、Red Hat build of Quarkus の最新バージョンと互換性のないエクステンションが使用されている可能性があります。
重要

Hibernate ORM または Hibernate Reactive を使用するプロジェクトについては、Hibernate ORM 5 to 6 migration クイックリファレンスを確認してください。次の更新コマンドは、このガイドのサブセットのみカバーしています。

1.1.1. 前提条件
リンクのコピー

  • 約 30 分
  • IDE
  • JAV_HOME が適切に設定された状態でインストールされた JDK 11+
  • Apache Maven 3.8.6 以降
  • 使用する必要がある場合はオプションで Red Hat build of Quarkus CLI
  • ネイティブ実行可能ファイル (ネイティブコンテナービルドを使用する場合は Docker) をビルドする必要がある場合は、オプションで Mandrel または GraalVM がインストールされ、適切に設定されていること
  • Red Hat build of Quarkus バージョン 2.13 以降をベースとするプロジェクト

1.1.2. 手順
リンクのコピー

  1. バージョン管理システムを使用して、プロジェクトの作業ブランチを作成します。
  2. 次のステップで Red Hat build of Quarkus CLI を使用するには、Red Hat build of Quarkus の最新バージョンをインストール します。quarkus -v を使用してバージョン番号を確認します。
  3. Quarkus スタートガイドの Red Hat build of Quarkus エクステンションレジストリークライアントの設定 セクションで説明されているとおり、エクステンションレジストリークライアントを設定します。

  4. Red Hat build of Quarkus CLI を使用して更新するには、プロジェクトディレクトリーに移動し、プロジェクトを最新のストリームに更新します。 

    quarkus update
    Copy to Clipboard Toggle word wrap

    オプション: デフォルトでは、このコマンドは最新の現行バージョンに更新します。最新の現行バージョンではなく特定のストリームに更新するには、このコマンドに stream オプションを追加し、その後にバージョンを追加します (例: --stream=3.2)。

  5. Red Hat build of Quarkus CLI ではなく Maven を使用して更新するには、プロジェクトディレクトリーに移動し、プロジェクトを最新ストリームに更新します。

    1. Red Hat build of Quarkus Maven プラグインのバージョンが、サポートされている最新の Red Hat build of Quarkus バージョンと一致していることを確認してください。

    2. Quarkus スタートガイド に記載されているガイドラインに従ってプロジェクトを設定します。 

      mvn com.redhat.quarkus.platform:quarkus-maven-plugin:3.2.12.SP1-redhat-00003:update
      Copy to Clipboard Toggle word wrap

      オプション: デフォルトでは、このコマンドは最新の現行バージョンに更新します。最新の現行バージョンではなく特定のストリームに更新するには、このコマンドに stream オプションを追加し、その後にバージョンを追加します (例: -Dstream=3.2)。

  6. 考えられる指示の更新コマンド出力を分析し、必要に応じて提案されたタスクを実行します。
  7. diff ツールを使用してすべての変更を検査します。
  8. 更新コマンドで更新されなかった項目については、移行ガイドを確認してください。プロジェクトにそのような項目がある場合は、これらのトピックでアドバイスされている追加の手順を実行ます。
  9. 実稼働環境にデプロイする前に、プロジェクトがエラーなくビルドされ、すべてのテストが合格し、アプリケーションが求められるとおりに機能することを確認します。

  10. 更新後の Red Hat build of Quarkus アプリケーションを実稼働環境にデプロイする前に、以下を確認します。

    • プロジェクトはエラーなしでビルドされる。
    • すべてのテストに合格する。
    • アプリケーションが求められるとおりに機能する。
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2026 Red Hat