Sync documentation of main branch

Author: actions-user

_generated-doc/main/config/quarkus-all-config.adoc

@@ -20274,7 +20274,7 @@ Environment variable: `+++QUARKUS_ELASTICSEARCH_MAX_CONNECTIONS+++`
 endif::add-copy-button-to-env-var[]
 --
 |int
-|`20`
+|`40`
 
 a| [[quarkus-elasticsearch-rest-client_quarkus-elasticsearch-max-connections-per-route]] [.property-path]##link:#quarkus-elasticsearch-rest-client_quarkus-elasticsearch-max-connections-per-route[`quarkus.elasticsearch.max-connections-per-route`]##
 ifdef::add-copy-button-to-config-props[]
@@ -20295,7 +20295,7 @@ Environment variable: `+++QUARKUS_ELASTICSEARCH_MAX_CONNECTIONS_PER_ROUTE+++`
 endif::add-copy-button-to-env-var[]
 --
 |int
-|`10`
+|`20`
 
 a| [[quarkus-elasticsearch-rest-client_quarkus-elasticsearch-io-thread-counts]] [.property-path]##link:#quarkus-elasticsearch-rest-client_quarkus-elasticsearch-io-thread-counts[`quarkus.elasticsearch.io-thread-counts`]##
 ifdef::add-copy-button-to-config-props[]

_generated-doc/main/config/quarkus-elasticsearch-rest-client.adoc

@@ -173,7 +173,7 @@ Environment variable: `+++QUARKUS_ELASTICSEARCH_MAX_CONNECTIONS+++`
 endif::add-copy-button-to-env-var[]
 --
 |int
-|`20`
+|`40`
 
 a| [[quarkus-elasticsearch-rest-client_quarkus-elasticsearch-max-connections-per-route]] [.property-path]##link:#quarkus-elasticsearch-rest-client_quarkus-elasticsearch-max-connections-per-route[`quarkus.elasticsearch.max-connections-per-route`]##
 ifdef::add-copy-button-to-config-props[]
@@ -194,7 +194,7 @@ Environment variable: `+++QUARKUS_ELASTICSEARCH_MAX_CONNECTIONS_PER_ROUTE+++`
 endif::add-copy-button-to-env-var[]
 --
 |int
-|`10`
+|`20`
 
 a| [[quarkus-elasticsearch-rest-client_quarkus-elasticsearch-io-thread-counts]] [.property-path]##link:#quarkus-elasticsearch-rest-client_quarkus-elasticsearch-io-thread-counts[`quarkus.elasticsearch.io-thread-counts`]##
 ifdef::add-copy-button-to-config-props[]

_generated-doc/main/config/quarkus-elasticsearch-rest-client_quarkus.elasticsearch.adoc

@@ -173,7 +173,7 @@ Environment variable: `+++QUARKUS_ELASTICSEARCH_MAX_CONNECTIONS+++`
 endif::add-copy-button-to-env-var[]
 --
 |int
-|`20`
+|`40`
 
 a| [[quarkus-elasticsearch-rest-client_quarkus-elasticsearch-max-connections-per-route]] [.property-path]##link:#quarkus-elasticsearch-rest-client_quarkus-elasticsearch-max-connections-per-route[`quarkus.elasticsearch.max-connections-per-route`]##
 ifdef::add-copy-button-to-config-props[]
@@ -194,7 +194,7 @@ Environment variable: `+++QUARKUS_ELASTICSEARCH_MAX_CONNECTIONS_PER_ROUTE+++`
 endif::add-copy-button-to-env-var[]
 --
 |int
-|`10`
+|`20`
 
 a| [[quarkus-elasticsearch-rest-client_quarkus-elasticsearch-io-thread-counts]] [.property-path]##link:#quarkus-elasticsearch-rest-client_quarkus-elasticsearch-io-thread-counts[`quarkus.elasticsearch.io-thread-counts`]##
 ifdef::add-copy-button-to-config-props[]

_generated-doc/main/infra/quarkus-all-build-items.adoc

@@ -9488,6 +9488,18 @@ Add a page (or section) to the Dev UI. This is typically the middle part of the
 
 _No Javadoc found_
 
+`java.util.List<LibraryLink> libraryVersions` 
+
+_No Javadoc found_
+
+`java.lang.String darkLogo` 
+
+_No Javadoc found_
+
+`java.lang.String lightLogo` 
+
+_No Javadoc found_
+
 
 
 

_versions/main/guides/_attributes.adoc

@@ -11,13 +11,13 @@
 :mandrel-flavor: jdk-21
 :surefire-version: 3.5.3
 :gradle-version: 8.14
-:elasticsearch-version: 8.18.2
-:elasticsearch-image: docker.io/elastic/elasticsearch:8.18.2
-:opensearch-image: docker.io/opensearchproject/opensearch:2.16.0
+:elasticsearch-version: 9.0.2
+:elasticsearch-image: docker.io/elastic/elasticsearch:9.0.2
+:opensearch-image: docker.io/opensearchproject/opensearch:3.0.0
 :infinispan-version: ${infinispan.version}
 :infinispan-protostream-version: ${infinispan.protostream.version}
-:logstash-image: docker.io/elastic/logstash:8.18.2
-:kibana-image: docker.io/elastic/kibana:8.18.2
+:logstash-image: docker.io/elastic/logstash:9.0.2
+:kibana-image: docker.io/elastic/kibana:9.0.2
 :keycloak-docker-image: quay.io/keycloak/keycloak:26.2.4
 :jandex-version: 3.3.1
 :jandex-gradle-plugin-version: 1.0.0
@@ -27,10 +27,10 @@
 :gcf-invoker-version: 1.4.1
 // Cannot simply use the name 'hibernate-*-version' here as it somehow gets
 // overridden to the full version, at least when building locally.
-:hibernate-orm-version-major-minor: 6.6
-:hibernate-search-version-major-minor: 7.2
+:hibernate-orm-version-major-minor: 7.0
+:hibernate-search-version-major-minor: 8.0
 :hibernate-validator-version-major-minor: 9.0
-:jakarta-persistence-version-major-minor: 3.1
+:jakarta-persistence-version-major-minor: 3.2
 // .
 :quarkus-home-url: https://quarkus.io
 :quarkus-org-url: https://github.com/quarkusio

_versions/main/guides/hibernate-orm.adoc

@@ -515,14 +515,17 @@ HibernateCriteriaBuilder hibernateCriteriaBuilder;
 Metamodel metamodel;
 
 @Inject
-Cache cache;
+jakarta.persistence.Cache cache;
 
 @Inject
 org.hibernate.Cache cache;
 
 @Inject
 jakarta.persistence.PersistenceUnitUtil persistenceUnitUtil;
 
+@Inject
+jakarta.persistence.SchemaManager schemaManager;
+
 @Inject
 org.hibernate.relational.SchemaManager schemaManager;
 ----
@@ -1692,8 +1695,8 @@ section of the Hibernate Validator guide for more details.
 == Static metamodel and Jakarta Data
 
 Both static metamodel and Jakarta Data capabilities of Hibernate ORM are available in Quarkus
-through the `hibernate-jpamodelgen` annotation processor. Since it is an annotation processor,
-you must configure the annotation processor in your build tool:
+through the `hibernate-processor` annotation processor. Since it is an annotation processor,
+you must configure it accordingly in your build tool:
 
 [source,xml,role="primary asciidoc-tabs-target-sync-cli asciidoc-tabs-target-sync-maven"]
 .pom.xml
@@ -1704,7 +1707,7 @@ you must configure the annotation processor in your build tool:
         <annotationProcessorPaths>
             <path>
                 <groupId>org.hibernate.orm</groupId>
-                <artifactId>hibernate-jpamodelgen</artifactId>
+                <artifactId>hibernate-processor</artifactId>
                 <!-- Note, no artifact version is required, it's managed by Quarkus.  -->
             </path>
             <!-- other processors that may be required by your app -->
@@ -1718,9 +1721,9 @@ you must configure the annotation processor in your build tool:
 .build.gradle
 ----
 // Enforce the version management of your annotation processor dependencies,
-// so that there's no need to define an explicit version of the hibernate-jpamodelgen
+// so that there's no need to define an explicit version of the hibernate-processor
 annotationProcessor enforcedPlatform("${quarkusPlatformGroupId}:${quarkusPlatformArtifactId}:${quarkusPlatformVersion}")
-annotationProcessor 'org.hibernate.orm:hibernate-jpamodelgen'
+annotationProcessor 'org.hibernate.orm:hibernate-processor'
 ----
 
 === Static metamodel
@@ -1757,7 +1760,7 @@ For a more detailed overview of static metamodel, please refer to the link:{jaka
 
 === Jakarta Data
 
-Jakarta Data requires, besides having the `hibernate-jpamodelgen` annotation processor in place, one extra dependency to be added:
+Jakarta Data requires, besides having the `hibernate-processor` annotation processor in place, one extra dependency to be added:
 
 [source,xml,role="primary asciidoc-tabs-target-sync-cli asciidoc-tabs-target-sync-maven"]
 .pom.xml

_versions/main/guides/hibernate-search-orm-elasticsearch.adoc

@@ -631,7 +631,7 @@ quarkus.datasource.db-kind=postgresql <1>
 
 quarkus.hibernate-orm.sql-load-script=import.sql <2>
 
-quarkus.hibernate-search-orm.elasticsearch.version=8 <3>
+quarkus.hibernate-search-orm.elasticsearch.version=9 <3>
 quarkus.hibernate-search-orm.indexing.plan.synchronization.strategy=sync <4>
 
 %prod.quarkus.datasource.jdbc.url=jdbc:postgresql://localhost/quarkus_test
@@ -820,7 +820,7 @@ as shown below.
 
 [source,properties]
 ----
-quarkus.hibernate-search-orm.elasticsearch.version=opensearch:2.16
+quarkus.hibernate-search-orm.elasticsearch.version=opensearch:3.0
 ----
 
 All other configuration options and APIs are exactly the same as with Elasticsearch.
@@ -850,7 +850,7 @@ quarkus.datasource.db-kind=h2
 quarkus.datasource.jdbc.url=jdbc:h2:mem:default;DB_CLOSE_DELAY=-1
 
 quarkus.hibernate-search-orm.elasticsearch.hosts=es1.mycompany.com:9200
-quarkus.hibernate-search-orm.elasticsearch.version=8
+quarkus.hibernate-search-orm.elasticsearch.version=9
 ----
 
 Using a map based approach, it is also possible to configure named persistence units:
@@ -870,10 +870,10 @@ quarkus.hibernate-orm."inventory".datasource=inventory <4>
 quarkus.hibernate-orm."inventory".packages=org.acme.model.inventory
 
 quarkus.hibernate-search-orm."users".elasticsearch.hosts=es1.mycompany.com:9200 <5>
-quarkus.hibernate-search-orm."users".elasticsearch.version=8
+quarkus.hibernate-search-orm."users".elasticsearch.version=9
 
 quarkus.hibernate-search-orm."inventory".elasticsearch.hosts=es2.mycompany.com:9200 <6>
-quarkus.hibernate-search-orm."inventory".elasticsearch.version=8
+quarkus.hibernate-search-orm."inventory".elasticsearch.version=9
 ----
 <1> Define a datasource named `users`.
 <2> Define a datasource named `inventory`.

_versions/main/guides/hibernate-search-standalone-elasticsearch.adoc

@@ -560,7 +560,7 @@ Edit `src/main/resources/application.properties` and inject the following config
 [source,properties]
 ----
 quarkus.hibernate-search-standalone.mapping.structure=document <1>
-quarkus.hibernate-search-standalone.elasticsearch.version=8 <2>
+quarkus.hibernate-search-standalone.elasticsearch.version=9 <2>
 quarkus.hibernate-search-standalone.indexing.plan.synchronization.strategy=sync <3>
 
 %prod.quarkus.hibernate-search-standalone.elasticsearch.hosts=localhost:9200 <4>
@@ -738,7 +738,7 @@ as shown below.
 
 [source,properties]
 ----
-quarkus.hibernate-search-standalone.elasticsearch.version=opensearch:2.16
+quarkus.hibernate-search-standalone.elasticsearch.version=opensearch:3.0
 ----
 
 All other configuration options and APIs are exactly the same as with Elasticsearch.

_versions/main/guides/kubernetes-client.adoc

@@ -435,6 +435,7 @@ subjects:
 Replace `<applicationName>` and `<namespace>` with your values.
 Have a look at https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/[Configure Service Accounts for Pods] to get further information.
 
+[[openshift-client]]
 == OpenShift Client
 
 If the targeted Kubernetes cluster is an OpenShift cluster, it is possible to access it through
@@ -513,6 +514,126 @@ To use this feature, you have to add a dependency on `quarkus-test-kubernetes-cl
 testImplementation("io.quarkus:quarkus-test-kubernetes-client")
 ----
 
+[[optimizing-native-image]]
+== Optimizing the Native Image
+
+The Kubernetes and OpenShift client extensions aim to provide a great *developer experience* while enabling the client to work in *native mode*.
+When building a native image, the Kubernetes Client extension will register all the accessible Kubernetes model classes for reflection.
+Unfortunately, this can lead to large native image sizes and longer build times.
+
+Once you've completed your application implementation, if you want to distribute and deploy your application as a *native image*, you should consider reducing its size by following these guidelines.
+
+=== Use the Kubernetes Client extension
+
+The <<openshift-client, OpenShift Client>> provides domain-specific language (DSL) accessors to common OpenShift resources.
+In addition, the extension supplies the necessary project configuration to bring in the OpenShift model type modules.
+
+In JVM mode, this works great because, as a developer, you don't need to worry about the configuration.
+However, in native mode, by depending on the OpenShift extension you're bringing in many resources that your application might not need unnecessarily increasing its size.
+
+In this context, it's better to depend only on what you need, by adding a dependency to the Kubernetes Client extension and only the minimum OpenShift model dependencies:
+
+[source,xml,role="primary asciidoc-tabs-target-sync-maven"]
+.pom.xml
+----
+<dependency>
+    <groupId>io.quarkus</groupId>
+    <artifactId>quarkus-kubernetes-client</artifactId>
+</dependency>
+<dependency>
+    <groupId>io.fabric8</groupId>
+    <artifactId>openshift-model</artifactId>
+</dependency>
+----
+
+[source,gradle,role="secondary asciidoc-tabs-target-sync-gradle"]
+.build.gradle
+----
+implementation("io.quarkus:quarkus-kubernetes-client")
+implementation("io.fabric8:openshift-model")
+----
+
+The OpenShift-specific DSL accessors won't be available since you'll now have a Bean of type `KubernetesClient` instead of `OpenShiftClient`.
+However, the Fabric8 Kubernetes Client provides generic entry-points to perform operations on any resource:
+
+[source%nowrap,java]
+----
+// List OpenShift Routes in any namespace
+kubernetesClient
+    .resources(io.fabric8.openshift.api.model.Route.class)
+    .inAnyNamespace().list();
+// Delete an OpenShift Route
+kubernetesClient
+    .resources(io.fabric8.openshift.api.model.Route.class)
+    .inNamespace("default").withName("the-route").delete();
+// Create or replace a new OpenShift Route
+kubernetesClient
+    .resource(new RouteBuilder()/* ... */.build())
+    .inNamespace("default").createOr(NonDeletingOperation::update);
+----
+
+=== Depend only on the modules you need
+
+The Kubernetes Client extension has transitive dependencies to all of the vanilla Kubernetes API model types.
+This is very convenient in JVM mode, since you don't need to worry about configuring the project.
+
+However, in native mode, this implies registering for reflection model types that you very likely won't use in your application.
+You can mitigate this by providing a more granular project configuration and depending only on those models you are sure the application uses.
+
+[source,xml,role="primary asciidoc-tabs-target-sync-maven"]
+.pom.xml
+----
+<dependency>
+    <groupId>io.quarkus</groupId>
+    <artifactId>quarkus-kubernetes-client</artifactId>
+</dependency>
+<dependency>
+    <groupId>io.fabric8</groupId>
+    <artifactId>kubernetes-client-api</artifactId>
+    <!-- Exclude all transitive dependencies -->
+    <exclusions>
+        <exclusion>
+            <groupId>io.fabric8</groupId>
+            <artifactId>*</artifactId>
+        </exclusion>
+    </exclusions>
+</dependency>
+<!-- Include only those that make sense for your application -->
+<dependency>
+    <groupId>io.fabric8</groupId>
+    <artifactId>kubernetes-client</artifactId>
+</dependency>
+<dependency>
+    <groupId>io.fabric8</groupId>
+    <artifactId>kubernetes-model-core</artifactId>
+</dependency>
+<dependency>
+    <groupId>io.fabric8</groupId>
+    <artifactId>kubernetes-model-admissionregistration</artifactId>
+</dependency>
+<dependency>
+    <groupId>io.fabric8</groupId>
+    <artifactId>kubernetes-model-apps</artifactId>
+</dependency>
+<!-- ... -->
+----
+
+[source,gradle,role="secondary asciidoc-tabs-target-sync-gradle"]
+.build.gradle
+----
+implementation("quarkus-kubernetes-client")
+implementation("io.fabric8:kubernetes-client-api") {
+    // Exclude all transitive dependencies
+    exclude group: "io.fabric8"
+}
+// Include only those that make sense for your application
+implementation("io.fabric8:kubernetes-client")
+implementation("io.fabric8:kubernetes-model-core")
+implementation("io.fabric8:kubernetes-model-admissionregistration")
+implementation("io.fabric8:kubernetes-model-apps")
+// ...
+----
+
 == Configuration Reference
 
 include::{generated-dir}/config/quarkus-kubernetes-client.adoc[opts=optional, leveloffset=+1]