Skip to content

Migration Guide 3.32

Ozan Gunalp edited this page May 27, 2026 · 11 revisions
Note

We highly recommend the use of quarkus update to update to a new version of Quarkus.

Items marked below with ⚙️ ✅ are automatically handled by quarkus update.

Apicurio Registry

Apicurio Registry was updated to a new major version, Apicurio Registry 3.

The main user-visible change is the schema ID format: Apicurio Registry 3.x uses 4-byte identifiers instead of 8-byte identifiers used in 2.x. This affects Kafka message compatibility between v2 and v3 producers/consumers.

For detailed migration scenarios and configuration options, see the Migrating from Apicurio Registry 2.x to 3.x

For extension developers

List<BuildItem> immutable

We used to return a mutable copy of list of build items when consuming a MultiBuildItem in a @BuildStep. We decided to return an immutable list instead and avoid the copy.

If you want to sort this list, copy it, or use a stream().sorted().

Datasource Dev Services

The datasource Dev Services have been converted to use the new Dev Services model. This changed the io.quarkus.datasource.deployment.spi SPI. If you’re producing a DevServicesDatasourceProviderBuildItem in your extension, the parameters used to construct it have changed. See the MS SQL conversion for an example of what to do.

Migration guides

Current version


LTS versions


Next version in main


Clone this wiki locally