Update projects to the latest Quarkus version
experimentalYou can update or upgrade your Quarkus projects to the latest version of Quarkus by using an update command.
The update command primarily employs OpenRewrite recipes to automate updates for most project dependencies, source code, and documentation.
|
The update command automates only a subset of the migration. Always review the Migration Guides for your target version to identify any additional steps that require manual changes. |
Post-update, if expected updates are missing, consider the following reasons:
-
The recipe might not include a specific item in your project.
-
Your project might use an extension that is incompatible with the latest Quarkus version.
Requisitos previos
To complete this guide, you need:
-
Roughly 30 minutes
-
An IDE
-
JDK 17+ installed with
JAVA_HOMEconfigured appropriately -
Apache Maven 3.9.16
-
Optionally the Quarkus CLI if you want to use it
-
Optionally Mandrel or GraalVM installed and configured appropriately if you want to build a native executable (or Docker if you use a native container build)
-
A project based on Quarkus version 2.13 or later.
Procedimiento
-
Create a working branch for your project by using your version control system.
-
To use the Quarkus CLI in the next step, install the latest version of the Quarkus CLI. Confirm the version number using
quarkus -v. -
Go to the project directory and update the project to the latest stream:
-
Analyze the update command output for potential instructions and perform the suggested tasks if necessary.
-
Use a diff tool to inspect all changes.
-
Review the Migration Guides for your target version and apply any additional steps not covered by the update command.
-
Ensure the project builds without errors, all tests pass, and the application functions as required before deploying to production.
Update recipes
The OpenRewrite recipes used by the update command are maintained in the Quarkus Updates repository. If you find that a recipe is missing or incorrect, you can contribute improvements there. Refer to the README.md and the CONTRIBUTING.md guide for detailed instructions on how to write and test recipes.
