Atualizando projetos para a versão mais recente do Quarkus
Você 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. Although these recipes update many migration items, they do not cover all the items detailed in the Migration Guides.
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.
-
If you have Gradle Kotlin build files (
.kts
), Quarkus Update will fail until OpenRewrite supports these.
For projects that use Hibernate ORM or Hibernate Reactive, review the Hibernate ORM 5 to 6 migration quick reference. The following update command covers only a subset of this guide. |
Pré-requisitos
Para concluir este guia, você precisa:
-
Mais ou menos 30 minutes
-
Um IDE
-
JDK 17+ installed with
JAVA_HOME
configured appropriately -
Apache Maven 3.9.9
-
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
branch
para 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 items that were not updated by the update command. If your project has such items, implement the additional steps advised in these topics.
-
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.