Merge pull request #50482 from won-seoop

Closes gh-50482

* pr/50482:
  Polish "Document Java 25 requirement for AOT cache"
  Document Java 25 requirement for AOT cache

Author: philwebb

spring-boot-project/spring-boot-docs/src/docs/antora/modules/reference/pages/packaging/class-data-sharing.adoc

@@ -3,8 +3,11 @@
 
 Class Data Sharing (CDS) is a https://docs.oracle.com/en/java/javase/17/vm/class-data-sharing.html[JVM feature] that can help reduce the startup time and memory footprint of Java applications.
 
-In Java 24, CDS is succeeded by the AOT Cache via https://openjdk.org/jeps/483[JEP 483].
-Spring Boot supports both CDS and AOT cache, and it is recommended that you use the latter if it is available in the JVM version you are using (Java 24+).
+If you are using Java 25 or above, CDS has been succeeded by the AOT Cache via https://openjdk.org/jeps/483[JEP 483].
+
+NOTE: Spring Boot supports both CDS and AOT cache, however, we recommend using the AOT cache whenever possible.
+
+
 
 [[packaging.class-data-sharing.cds]]
 == CDS
@@ -29,6 +32,8 @@ $ java -XX:SharedArchiveFile=application.jsa -jar my-app.jar
 
 NOTE: For more details about CDS, refer to the xref:how-to:class-data-sharing.adoc[CDS how-to guide] and the {url-spring-framework-docs}/integration/cds.html[Spring Framework reference documentation].
 
+
+
 [[packaging.class-data-sharing.aot-cache]]
 == AOT Cache
 

spring-boot-project/spring-boot-docs/src/docs/antora/modules/reference/pages/packaging/container-images/dockerfiles.adoc

@@ -57,15 +57,38 @@ Additionally, the layout created by the `jarmode` is CDS and AOT cache friendly
 
 
 
+[[packaging.container-images.dockerfiles.aot-cache]]
+== AOT cache
+
+If you are using Java 25 or above, and want to additionally enable the xref:reference:packaging/class-data-sharing.adoc#packaging.class-data-sharing.aot-cache[AOT cache], you can use this `Dockerfile`:
+[source,dockerfile]
+----
+include::reference:partial$dockerfile[]
+
+# Execute the AOT cache training run
+RUN java -XX:AOTCacheOutput=app.aot -Dspring.context.exit=onRefresh -jar application.jar
+
+# Start the application jar with AOT cache enabled - this is not the uber jar used by the builder
+# This jar only contains application code and references to the extracted jar files
+# This layout is efficient to start up and AOT cache friendly
+ENTRYPOINT ["java", "-XX:AOTCache=app.aot", "-jar", "application.jar"]
+----
+
+This is mostly the same as the above `Dockerfile`.
+As the last steps, it creates the AOT cache file by doing a training run and passes the AOT cache parameter to `java -jar`.
+
+
 [[packaging.container-images.dockerfiles.cds]]
 == CDS
 
 If you want to additionally enable xref:reference:packaging/class-data-sharing.adoc#packaging.class-data-sharing.cds[CDS], you can use this `Dockerfile`:
 [source,dockerfile]
 ----
 include::reference:partial$dockerfile[]
+
 # Execute the CDS training run
 RUN java -XX:ArchiveClassesAtExit=application.jsa -Dspring.context.exit=onRefresh -jar application.jar
+
 # Start the application jar with CDS enabled - this is not the uber jar used by the builder
 # This jar only contains application code and references to the extracted jar files
 # This layout is efficient to start up and CDS friendly
@@ -75,21 +98,4 @@ ENTRYPOINT ["java", "-XX:SharedArchiveFile=application.jsa", "-jar", "applicatio
 This is mostly the same as the above `Dockerfile`.
 As the last steps, it creates the CDS archive by doing a training run and passes the CDS parameter to `java -jar`.
 
-[[packaging.container-images.dockerfiles.aot-cache]]
-== AOT cache
-
-If you want to additionally enable the xref:reference:packaging/class-data-sharing.adoc#packaging.class-data-sharing.aot-cache[AOT cache], you can use this `Dockerfile`:
-[source,dockerfile]
-----
-include::reference:partial$dockerfile[]
-# Execute the AOT cache training run
-RUN java -XX:AOTMode=record -XX:AOTConfiguration=app.aotconf -Dspring.context.exit=onRefresh -jar application.jar
-RUN java -XX:AOTMode=create -XX:AOTConfiguration=app.aotconf -XX:AOTCache=app.aot -jar application.jar && rm app.aotconf
-# Start the application jar with AOT cache enabled - this is not the uber jar used by the builder
-# This jar only contains application code and references to the extracted jar files
-# This layout is efficient to start up and AOT cache friendly
-ENTRYPOINT ["java", "-XX:AOTCache=app.aot", "-jar", "application.jar"]
-----
-
-This is mostly the same as the above `Dockerfile`.
-As the last steps, it creates the AOT cache file by doing a training run and passes the AOT cache parameter to `java -jar`.
+NOTE: If you are using Java 25 or above, we recommend using an AOT cache instead of CDS.

spring-boot-project/spring-boot-docs/src/docs/antora/modules/reference/partials/dockerfile

@@ -1,17 +1,21 @@
 # Perform the extraction in a separate builder container
 FROM bellsoft/liberica-openjre-debian:24-cds AS builder
 WORKDIR /builder
+
 # This points to the built jar file in the target folder
 # Adjust this to 'build/libs/*.jar' if you're using Gradle
 ARG JAR_FILE=target/*.jar
+
 # Copy the jar file to the working directory and rename it to application.jar
 COPY ${JAR_FILE} application.jar
+
 # Extract the jar file using an efficient layout
 RUN java -Djarmode=tools -jar application.jar extract --layers --destination extracted
 
 # This is the runtime container
 FROM bellsoft/liberica-openjre-debian:24-cds
 WORKDIR /application
+
 # Copy the extracted jar contents from the builder container into the working directory in the runtime container
 # Every copy step creates a new docker layer
 # This allows docker to only pull the changes it really needs