Migration Guide 3.14

Table of Contents

• Dev Services
• For extension developers
  • Getting your application to compile
  • Publishing the config documentation

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.

Dev Services

Several Dev Services default images have been updated:

• PostgreSQL from 14 to 16

• MySQL from 8.0 to 8.4

• MongoDB from 4.4 to 7.0

For extension developers

This paragraph only concerns people developing their own Quarkus extensions.

Getting your application to compile

The extension annotation processor that is used to generate some files required for the Quarkus runtime and the configuration documentation has been redeveloped from scratch. It is a lot more flexible but comes with some new constraints:

• You cannot mix configuration using the legacy @ConfigRoot approach (i.e. without a corresponding @ConfigMapping annotation) and the new @ConfigMapping approach in the same module. This shouldn’t be too much of a problem.

• If you use the new @ConfigMapping approach, you don’t need to configure anything. The change should be transparent for you.

• If you use the legacy @ConfigRoot approach (i.e. without a corresponding @ConfigMapping annotation), you need to inform the annotation processor of it:

              <plugin>
                  <groupId>org.apache.maven.plugins</groupId>
                  <artifactId>maven-compiler-plugin</artifactId>
                  <configuration>
                      <annotationProcessorPaths>
                          <path>
                              <groupId>io.quarkus</groupId>
                              <artifactId>quarkus-extension-processor</artifactId>
                              <version>${quarkus.version}</version>
                          </path>
                      </annotationProcessorPaths>
                      <compilerArgs>
                          <arg>-AlegacyConfigRoot=true</arg>
                      </compilerArgs>
                  </configuration>
              </plugin>

  The important part is the added compilerArgs -AlegacyConfigRoot=true.

  Note that this will result in a warning when compiling the test classes (given you don’t have config annotations in your test classes, the annotation processor will not be triggered and you will get a warning telling you the legacyConfigRoot parameter is unused). To alleviate this issue, it is recommended to only enable the annotation processor for the default-compile execution (which compiles the main classes):

              <plugin>
                  <artifactId>maven-compiler-plugin</artifactId>
                  <executions>
                      <execution>
                          <id>default-compile</id>
                          <configuration>
                              <annotationProcessorPaths>
                                  <path>
                                      <groupId>io.quarkus</groupId>
                                      <artifactId>quarkus-extension-processor</artifactId>
                                      <version>${quarkus.version}</version>
                                  </path>
                              </annotationProcessorPaths>
                              <compilerArgs>
                                  <arg>-AlegacyConfigRoot=true</arg>
                              </compilerArgs>
                          </configuration>
                      </execution>
                  </executions>
              </plugin>

Publishing the config documentation

The config documentation used to be generated in the root target/generated/config directory by the extension annotation processor itself.

This is not the case anymore: the extension annotation processor builds a model that is in each module, and we have a Maven plugin that assembles the model and generate the Asciidoc output.

In your typical Quarkiverse extension, you would have to apply the following changes:

diff --git a/docs/pom.xml b/docs/pom.xml
index 71be73f..5022bf4 100644
--- a/docs/pom.xml
+++ b/docs/pom.xml
@@ -56,6 +56,14 @@
                     </execution>
                 </executions>
             </plugin>
+            <plugin>
+                <groupId>io.quarkus</groupId>
+                <artifactId>quarkus-config-doc-maven-plugin</artifactId>
+                <extensions>true</extensions>
+                <configuration>
+                    <targetDirectory>${project.basedir}/modules/ROOT/pages/includes/</targetDirectory>
+                </configuration>
+            </plugin>
             <plugin>
                 <artifactId>maven-resources-plugin</artifactId>
                 <executions>
@@ -68,11 +76,6 @@
                         <configuration>
                             <outputDirectory>${project.basedir}/modules/ROOT/pages/includes/</outputDirectory>
                             <resources>
-                                <resource>
-                                    <directory>${project.basedir}/../target/asciidoc/generated/config/</directory>
-                                    <include>quarkus-github-app.adoc</include>
-                                    <filtering>false</filtering>
-                                </resource>
                                 <resource>
                                     <directory>${project.basedir}/templates/includes</directory>
                                     <include>attributes.adoc</include>
diff --git a/pom.xml b/pom.xml
index c87d42b..10cbacd 100644
--- a/pom.xml
+++ b/pom.xml
@@ -98,6 +98,11 @@
                     <artifactId>quarkus-maven-plugin</artifactId>
                     <version>${quarkus.version}</version>
                 </plugin>
+                <plugin>
+                    <groupId>io.quarkus</groupId>
+                    <artifactId>quarkus-config-doc-maven-plugin</artifactId>
+                    <version>${quarkus.version}</version>
+                </plugin>
                 <plugin>
                     <groupId>org.apache.maven.plugins</groupId>
                     <artifactId>maven-compiler-plugin</artifactId>