Criar um Projeto Quarkus

1. Detectar o ambiente

java -version          # Java 17, 21 or 25 (Quarkus 3.40 recommends 25, 3.27 recommends 21)
quarkus --version      # optional Quarkus CLI
./mvnw -v || mvn -v    # or ./gradlew -v

Se a pasta já contiver um projeto Quarkus (io.quarkus.platform BOM, quarkus-maven-plugin ou plugin Gradle io.quarkus), NÃO crie um novo projeto: leia a versão do Quarkus e mantenha-a. Para um novo projeto, use o stream marcado como recomendado em https://code.quarkus.io/api/streams (um stream LTS; veja também https://quarkus.io/support/) e não invente uma versão de patch: deixe a ferramenta escolher. Quarkus 4.0 ainda é beta, então não o use a menos que seja solicitado. Se uma extensão estiver faltando no stream recomendado, a CLI escolherá silenciosamente um stream mais antigo; verifique quarkus.platform.version no arquivo de build gerado.

2. Criar projeto (escolha um)

Quarkus CLI (instale via https://quarkus.io/get-started/, por exemplo, SDKMAN sdk install quarkus):

quarkus create app com.example:demo \
  --extension='rest-jackson,hibernate-orm-panache,jdbc-postgresql,hibernate-validator,smallrye-health' \
  --java=21 --maven        # or --gradle

Sem CLI: plugin Maven (fixe a versão para o release atual de https://quarkus.io/guides/maven-tooling, substitua QUARKUS_VERSION abaixo por ela):

mvn io.quarkus.platform:quarkus-maven-plugin:QUARKUS_VERSION:create \
  -DprojectGroupId=com.example -DprojectArtifactId=demo \
  -Dextensions='rest-jackson,hibernate-orm-panache,jdbc-postgresql' \
  -DbuildTool=maven        # or gradle

Ou gere a partir da interface web / API REST do https://code.quarkus.io (https://code.quarkus.io/d?g=com.example&a=demo&e=rest-jackson&b=MAVEN) e descompacte.

3. Escolher extensões

Adicione depois com quarkus extension add <name> ou ./mvnw quarkus:add-extension -Dextensions=<name>; quarkus extension list --installable lista as opções.

4. Estrutura e execução

src/main/java/...          # resources, services, entities
src/main/resources/application.properties
src/main/docker/           # Dockerfile.jvm, Dockerfile.native, ...
src/test/java/...          # @QuarkusTest / @QuarkusIntegrationTest

./mvnw quarkus:dev         # or: quarkus dev / ./gradlew quarkusDev

Os testes gerados incluem uma classe *IT que o Maven ignora por padrão (<skipITs>true</skipITs> no template); execute-a com ./mvnw verify -DskipITs=false ou -Dnative. O modo Dev oferece recarregamento ao vivo, Dev UI em http://localhost:8080/q/dev-ui, Dev Services (containers automáticos) e testes contínuos (pressione r). Pacote: ./mvnw package (executável target/quarkus-app/quarkus-run.jar).

Referências

• Configuração
• Banco de Dados (Dev Services, Hibernate, Flyway/Liquibase)
• Noções básicas de segurança
• Imagens de container
• Insights de runtime local (BootUI)

Verificado (scaffold, ./mvnw verify, ./gradlew build, modo dev, Dev Services PostgreSQL, JDK 26 com release Java 25) no Quarkus 3.40.1 (stream LTS recomendado atual) e ./mvnw verify em 3.27.6 (LTS mais antigo).

Habilidades relacionadas: quarkus-dev-services-and-testing, quarkus-native-and-container.

Fontes upstream (leia antes de atualizar)

Busque a página para a versão alvo; prefira-a a esta habilidade quando houver conflito.

• quarkus update (atualização automatizada, usa OpenRewrite): https://quarkus.io/guides/update-quarkus
• Guias de migração, uma página wiki por versão menor: https://github.com/quarkusio/quarkus/wiki/Migration-Guide-3.20 (mude a versão)
• Anúncios de release: https://quarkus.io/blog/
• Política LTS e LTS atual: https://quarkus.io/blog/lts-releases/