The English version of quarkus.io is the official project site. Translated sites are community supported on a best-effort basis.

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

  1. Crie uma branch para o seu projeto utilizando o seu sistema de controle de versão.

  2. To use the Quarkus CLI in the next step, install the latest version of the Quarkus CLI. Confirm the version number using quarkus -v.

  3. Vá para o diretório do projeto e atualize o projeto para a última versão disponível:

    Utilizando o Quarkus CLI
    quarkus update

    Optional: To specify a particular stream, use the --stream option; for example: --stream=3.2

    Utilizando o Maven
    ./mvnw io.quarkus.platform:quarkus-maven-plugin:3.17.2:update -N

    Optional: To specify a particular stream, use the -Dstream option; for example: -Dstream=3.2

  4. Analise a saída do comando de atualização para obter possíveis instruções e execute as tarefas sugeridas, se necessário.

  5. Utilize uma ferramenta de comparação para inspecionar todas as alterações.

  6. 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.

  7. 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.

Conteúdo Relacionado