Atualizando projetos para a versão mais recente do Quarkus
experimentalVocê pode atualizar ou subir a versão dos seus projetos Quarkus para a versão mais recente de Quarkus utilizando um comando update.
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. |
Se as atualizações esperadas estiverem faltando, considere os seguintes motivos:
-
A receita OpenRewrite pode não incluir um item específico do seu projeto.
-
O seu projeto pode estar utilizando uma extensão que é incompatível com a versão mais recente do Quarkus.
Pré-requisitos
Para concluir este guia, você precisa:
-
Mais ou menos 30 minutes
-
Um IDE
-
JDK 17+ instalado com
JAVA_HOMEconfigurado corretamente -
Apache Maven 3.9.16
-
Opcionalmente, o Quarkus CLI se você quiser usá-lo
-
Opcionalmente, Mandrel ou GraalVM instalado e configurado apropriadamente se você quiser criar um executável nativo (ou Docker se você usar uma compilação de contêiner nativo)
-
Um projeto baseado na versão 2.13 ou posterior de Quarkus.
Procedimento
-
Crie uma
branchpara o seu projeto utilizando o seu sistema de controle de versão. -
To use the Quarkus CLI in the next step, install the latest version of the Quarkus CLI. Confirm the version number using
quarkus -v. -
Vá para o diretório do projeto e atualize o projeto para a última versão disponível:
-
Analise a saída do comando de atualização para obter possíveis instruções e execute as tarefas sugeridas, se necessário.
-
Utilize uma ferramenta de comparação para inspecionar todas as alterações.
-
Review the Migration Guides for your target version and apply any additional steps not covered by the update command.
-
Garanta que o projeto é construído sem erros, que todos os testes são aprovados e que a aplicação funciona conforme esperado antes de ser implantado em produção.
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.
