Quarkus Nativo e Contêiner

Verifique primeiro a versão do Quarkus do projeto. Para trabalhos genéricos (não Quarkus) com GraalVM, use a habilidade opcional java-add-graalvm-native-image-support se instalada (caso contrário, consulte a documentação do GraalVM, https://www.graalvm.org/latest/reference-manual/native-image/).

Build Nativo

# container build: no local GraalVM needed (Docker/Podman required)
./mvnw package -Dnative -Dquarkus.native.container-build=true
# local Mandrel/GraalVM (JAVA_HOME / GRAALVM_HOME must point to it)
./mvnw package -Dnative
# Gradle, Quarkus 3.10+ (add -Dquarkus.native.container-build=true without a local Mandrel)
./gradlew build -Dquarkus.native.enabled=true -Dquarkus.package.jar.enabled=false
# Gradle, older Quarkus
./gradlew build -Dquarkus.package.type=native

quarkus.package.type foi depreciado na versão 3.10 (o guia de migração 3.10 o substitui por quarkus.native.enabled e quarkus.package.jar.*); ele ainda é aceito na versão 3.40 com um aviso. Controle de versão verificado com Gradle: na versão 3.9.5, -Dquarkus.native.enabled=true -Dquarkus.package.jar.enabled=false é ignorado (avisos de "chave de configuração não reconhecida") e apenas um quarkus-app para JVM é criado, enquanto -Dquarkus.package.type=native produz o executável nativo; nas versões 3.10.0, 3.27.6 e 3.40.1, as novas chaves produzem o executável nativo (a versão 3.10.0 também aceita a chave antiga com o aviso de depreciação). O perfil Maven native no pom.xml gerado já define quarkus.native.enabled=true, quarkus.package.jar.enabled=false e skipITs=false quando -Dnative é passado.

Build local verificado em macOS arm64 com o pacote Mandrel para sua linha Quarkus de https://github.com/graalvm/mandrel/releases (mandrel-java25-macos-aarch64-25.0.4.1-Final.tar.gz para 3.40.1, extraído em qualquer lugar, JAVA_HOME apontando para seu Contents/Home; as ferramentas de linha de comando do Xcode são suficientes): o package -Dnative Maven na versão 3.40.1 levou cerca de 70 s e o build Gradle com as duas flags cerca de 2,5 min; o executável é um binário Mach-O que inicia em cerca de 0,04 s, e ./mvnw verify -Dnative executou o *IT contra ele com sucesso. O Quarkus verifica a versão do Mandrel/GraalVM: a versão 3.40 recusa a 23.1 ("Versão desatualizada do GraalVM ou Mandrel detectada ... Quarkus atualmente suporta 25.0.0"), portanto, use Mandrel 25 com 3.40 e mandrel-java21-macos-aarch64-23.1.12.1-Final com 3.27.6 (Maven verify -Dnative e Gradle ambos verificados lá).

Binário: target/*-runner (Maven) ou build/*-runner (Gradle). Um build de contêiner no macOS ou Windows produz um arquivo ELF para Linux que não pode ser executado no host: execute-o em um contêiner Linux (por exemplo, docker run -v "$PWD/target:/w:ro" registry.access.redhat.com/ubi9/ubi-minimal /w/<name>-runner com o datasource passado através das variáveis de ambiente QUARKUS_DATASOURCE_*), e note que ./mvnw verify -Dnative falha então no *IT com Exit code is: '126'. Mandrel é a distribuição GraalVM da Red Hat para Quarkus; o build de contêiner puxa uma imagem de builder Mandrel que corresponde ao projeto (a versão 3.40.1 usou quay.io/quarkus/ubi9-quarkus-mandrel-builder-image:jdk-25, Mandrel 25.0.4.1, cerca de 2,5 minutos incluindo o download da imagem); substitua-o com quarkus.native.builder-image se necessário. Builds nativos são lentos e consomem muita memória (vários GB); faça-os em CI ou sob demanda, não em cada execução de teste.

Falhas Comuns em Builds Nativos

@RegisterForReflection(targets = ExternalDto.class)
public record ProductDto(String name) {}

…