Sync web site with Quarkus documentation

quarkusbot · quarkusbot · commit fb264d35c3fa · 2025-03-05T15:49:30.000Z
diff --git a/_generated-doc/latest/config/quarkus-all-config.adoc b/_generated-doc/latest/config/quarkus-all-config.adoc
@@ -56047,7 +56047,7 @@ endif::add-copy-button-to-config-props[]
 
 [.description]
 --
-The flavor to use (kind, k3s or api-only). Default to api-only.
+The flavor to use (kind, k3s or api-only). If not set, Dev Services for Kubernetes will set it to: api-only.
 
 
 ifdef::add-copy-button-to-env-var[]
@@ -56058,7 +56058,7 @@ Environment variable: `+++QUARKUS_KUBERNETES_CLIENT_DEVSERVICES_FLAVOR+++`
 endif::add-copy-button-to-env-var[]
 --
 a|tooltip:kind[kind (needs priviledge docker)], tooltip:k3s[k3s (needs priviledge docker)], tooltip:api-only[api only]
-|tooltip:api-only[api only]
+|
 
 a|icon:lock[title=Fixed at build time] [[quarkus-kubernetes-client_quarkus-kubernetes-client-devservices-override-kubeconfig]] [.property-path]##link:#quarkus-kubernetes-client_quarkus-kubernetes-client-devservices-override-kubeconfig[`quarkus.kubernetes-client.devservices.override-kubeconfig`]##
 ifdef::add-copy-button-to-config-props[]
@@ -81118,7 +81118,7 @@ Environment variable: `+++QUARKUS_REST_CLIENT_CONNECTION_POOL_SIZE+++`
 endif::add-copy-button-to-env-var[]
 --
 |int
-|
+|`50`
 
 a| [[quarkus-rest-client-config_quarkus-rest-client-keep-alive-enabled]] [.property-path]##link:#quarkus-rest-client-config_quarkus-rest-client-keep-alive-enabled[`quarkus.rest-client.keep-alive-enabled`]##
 ifdef::add-copy-button-to-config-props[]
@@ -82208,7 +82208,7 @@ Environment variable: `+++QUARKUS_REST_CLIENT__CLIENT__CONNECTION_POOL_SIZE+++`
 endif::add-copy-button-to-env-var[]
 --
 |int
-|
+|`50`
 
 a| [[quarkus-rest-client-config_quarkus-rest-client-client-keep-alive-enabled]] [.property-path]##link:#quarkus-rest-client-config_quarkus-rest-client-client-keep-alive-enabled[`quarkus.rest-client."client".keep-alive-enabled`]##
 ifdef::add-copy-button-to-config-props[]
diff --git a/_generated-doc/latest/config/quarkus-kubernetes-client.adoc b/_generated-doc/latest/config/quarkus-kubernetes-client.adoc
@@ -607,7 +607,7 @@ endif::add-copy-button-to-config-props[]
 
 [.description]
 --
-The flavor to use (kind, k3s or api-only). Default to api-only.
+The flavor to use (kind, k3s or api-only). If not set, Dev Services for Kubernetes will set it to: api-only.
 
 
 ifdef::add-copy-button-to-env-var[]
@@ -618,7 +618,7 @@ Environment variable: `+++QUARKUS_KUBERNETES_CLIENT_DEVSERVICES_FLAVOR+++`
 endif::add-copy-button-to-env-var[]
 --
 a|tooltip:kind[kind (needs priviledge docker)], tooltip:k3s[k3s (needs priviledge docker)], tooltip:api-only[api only]
-|tooltip:api-only[api only]
+|
 
 a|icon:lock[title=Fixed at build time] [[quarkus-kubernetes-client_quarkus-kubernetes-client-devservices-override-kubeconfig]] [.property-path]##link:#quarkus-kubernetes-client_quarkus-kubernetes-client-devservices-override-kubeconfig[`quarkus.kubernetes-client.devservices.override-kubeconfig`]##
 ifdef::add-copy-button-to-config-props[]
diff --git a/_generated-doc/latest/config/quarkus-kubernetes-client_quarkus.kubernetes-client.adoc b/_generated-doc/latest/config/quarkus-kubernetes-client_quarkus.kubernetes-client.adoc
@@ -607,7 +607,7 @@ endif::add-copy-button-to-config-props[]
 
 [.description]
 --
-The flavor to use (kind, k3s or api-only). Default to api-only.
+The flavor to use (kind, k3s or api-only). If not set, Dev Services for Kubernetes will set it to: api-only.
 
 
 ifdef::add-copy-button-to-env-var[]
@@ -618,7 +618,7 @@ Environment variable: `+++QUARKUS_KUBERNETES_CLIENT_DEVSERVICES_FLAVOR+++`
 endif::add-copy-button-to-env-var[]
 --
 a|tooltip:kind[kind (needs priviledge docker)], tooltip:k3s[k3s (needs priviledge docker)], tooltip:api-only[api only]
-|tooltip:api-only[api only]
+|
 
 a|icon:lock[title=Fixed at build time] [[quarkus-kubernetes-client_quarkus-kubernetes-client-devservices-override-kubeconfig]] [.property-path]##link:#quarkus-kubernetes-client_quarkus-kubernetes-client-devservices-override-kubeconfig[`quarkus.kubernetes-client.devservices.override-kubeconfig`]##
 ifdef::add-copy-button-to-config-props[]
diff --git a/_generated-doc/latest/config/quarkus-kubernetes-client_quarkus.kubernetes-client.devservices.adoc b/_generated-doc/latest/config/quarkus-kubernetes-client_quarkus.kubernetes-client.devservices.adoc
@@ -57,7 +57,7 @@ endif::add-copy-button-to-config-props[]
 
 [.description]
 --
-The flavor to use (kind, k3s or api-only). Default to api-only.
+The flavor to use (kind, k3s or api-only). If not set, Dev Services for Kubernetes will set it to: api-only.
 
 
 ifdef::add-copy-button-to-env-var[]
@@ -68,7 +68,7 @@ Environment variable: `+++QUARKUS_KUBERNETES_CLIENT_DEVSERVICES_FLAVOR+++`
 endif::add-copy-button-to-env-var[]
 --
 a|tooltip:kind[kind (needs priviledge docker)], tooltip:k3s[k3s (needs priviledge docker)], tooltip:api-only[api only]
-|tooltip:api-only[api only]
+|
 
 a|icon:lock[title=Fixed at build time] [[quarkus-kubernetes-client_quarkus-kubernetes-client-devservices_quarkus-kubernetes-client-devservices-override-kubeconfig]] [.property-path]##link:#quarkus-kubernetes-client_quarkus-kubernetes-client-devservices_quarkus-kubernetes-client-devservices-override-kubeconfig[`quarkus.kubernetes-client.devservices.override-kubeconfig`]##
 ifdef::add-copy-button-to-config-props[]
diff --git a/_generated-doc/latest/config/quarkus-rest-client-config.adoc b/_generated-doc/latest/config/quarkus-rest-client-config.adoc
@@ -333,7 +333,7 @@ Environment variable: `+++QUARKUS_REST_CLIENT_CONNECTION_POOL_SIZE+++`
 endif::add-copy-button-to-env-var[]
 --
 |int
-|
+|`50`
 
 a| [[quarkus-rest-client-config_quarkus-rest-client-keep-alive-enabled]] [.property-path]##link:#quarkus-rest-client-config_quarkus-rest-client-keep-alive-enabled[`quarkus.rest-client.keep-alive-enabled`]##
 ifdef::add-copy-button-to-config-props[]
@@ -1423,7 +1423,7 @@ Environment variable: `+++QUARKUS_REST_CLIENT__CLIENT__CONNECTION_POOL_SIZE+++`
 endif::add-copy-button-to-env-var[]
 --
 |int
-|
+|`50`
 
 a| [[quarkus-rest-client-config_quarkus-rest-client-client-keep-alive-enabled]] [.property-path]##link:#quarkus-rest-client-config_quarkus-rest-client-client-keep-alive-enabled[`quarkus.rest-client."client".keep-alive-enabled`]##
 ifdef::add-copy-button-to-config-props[]
diff --git a/_generated-doc/latest/config/quarkus-rest-client-config_quarkus.rest-client.adoc b/_generated-doc/latest/config/quarkus-rest-client-config_quarkus.rest-client.adoc
@@ -333,7 +333,7 @@ Environment variable: `+++QUARKUS_REST_CLIENT_CONNECTION_POOL_SIZE+++`
 endif::add-copy-button-to-env-var[]
 --
 |int
-|
+|`50`
 
 a| [[quarkus-rest-client-config_quarkus-rest-client-keep-alive-enabled]] [.property-path]##link:#quarkus-rest-client-config_quarkus-rest-client-keep-alive-enabled[`quarkus.rest-client.keep-alive-enabled`]##
 ifdef::add-copy-button-to-config-props[]
@@ -1423,7 +1423,7 @@ Environment variable: `+++QUARKUS_REST_CLIENT__CLIENT__CONNECTION_POOL_SIZE+++`
 endif::add-copy-button-to-env-var[]
 --
 |int
-|
+|`50`
 
 a| [[quarkus-rest-client-config_quarkus-rest-client-client-keep-alive-enabled]] [.property-path]##link:#quarkus-rest-client-config_quarkus-rest-client-client-keep-alive-enabled[`quarkus.rest-client."client".keep-alive-enabled`]##
 ifdef::add-copy-button-to-config-props[]
diff --git a/_generated-doc/latest/infra/quarkus-all-build-items.adoc b/_generated-doc/latest/infra/quarkus-all-build-items.adoc
@@ -5383,6 +5383,32 @@ _No Javadoc found_
 
 
 
+a| https://github.com/quarkusio/quarkus/blob/main/extensions/kubernetes-client/spi/src/main/java/io/quarkus/kubernetes/client/spi/KubernetesDevServiceInfoBuildItem.java[`io.quarkus.kubernetes.client.spi.KubernetesDevServiceInfoBuildItem`, window="_blank"]
+[.description]
+--
+BuildItem packaging the information of the kind test container created
+-- a|`java.lang.String kubeConfig` 
+
+_No Javadoc found_
+
+`java.lang.String containerId` 
+
+_No Javadoc found_
+
+
+
+
+a| https://github.com/quarkusio/quarkus/blob/main/extensions/kubernetes-client/spi/src/main/java/io/quarkus/kubernetes/client/spi/KubernetesDevServiceRequestBuildItem.java[`io.quarkus.kubernetes.client.spi.KubernetesDevServiceRequestBuildItem`, window="_blank"]
+[.description]
+--
+BuildItem managing the Kubernetes DevService Request information for the extension consuming it
+-- a|`java.lang.String flavor` 
+
+_No Javadoc found_
+
+
+
+
 a| https://github.com/quarkusio/quarkus/blob/main/extensions/kubernetes-client/spi/src/main/java/io/quarkus/kubernetes/client/spi/KubernetesResourcesBuildItem.java[`io.quarkus.kubernetes.client.spi.KubernetesResourcesBuildItem`, window="_blank"]
 [.description]
 --
diff --git a/_generated-doc/latest/infra/quarkus-maven-plugin-goals.adoc b/_generated-doc/latest/infra/quarkus-maven-plugin-goals.adoc
@@ -3837,7 +3837,7 @@ Skip the execution of this mojo
 
 = quarkus:update
 
-Log Quarkus-related recommended updates, such as new Quarkus platform BOM versions and Quarkus extensions versions that aren't managed by the Quarkus platform BOMs.
+Suggest project updates and create a recipe with the possibility to apply it.
 
 [.configuration-reference, cols="70,15,15"]
 |===
@@ -3866,7 +3866,7 @@ a| [[quarkus-maven-plugin-goal-update-noRewrite]] noRewrite
 
 [.description]
 --
-Disable the rewrite feature.
+Disable the rewrite feature. Deprecated: use -Drewrite=false instead
 --
 |`Boolean`
 |`false`
@@ -3875,7 +3875,7 @@ a| [[quarkus-maven-plugin-goal-update-perModule]] perModule
 
 [.description]
 --
-Display information per project module.
+Deprecated: this option was unused
 --
 |`boolean`
 |
@@ -3901,6 +3901,15 @@ a| [[quarkus-maven-plugin-goal-update-repos]] repos
 |`List` (required)
 |`${project.remoteProjectRepositories}`
 
+a| [[quarkus-maven-plugin-goal-update-rewrite]] rewrite
+
+[.description]
+--
+Run the suggested update recipe for this project.
+--
+|`Boolean`
+|
+
 a| [[quarkus-maven-plugin-goal-update-additionalUpdateRecipes]] additionalUpdateRecipes
 
 [.description]
@@ -3914,7 +3923,7 @@ a| [[quarkus-maven-plugin-goal-update-rewriteDryRun]] rewriteDryRun
 
 [.description]
 --
-Rewrite in dry-mode.
+Do a dry run the suggested update recipe for this project.
 --
 |`Boolean`
 |`false`
diff --git a/_guides/_attributes.adoc b/_guides/_attributes.adoc
@@ -1,7 +1,7 @@
 // Common attributes.
 // --> No blank lines (it ends the document header)
 :project-name: Quarkus
-:quarkus-version: 3.19.1
+:quarkus-version: 3.19.2
 :quarkus-platform-groupid: io.quarkus.platform
 // .
 :maven-version: 3.9.9
@@ -10,7 +10,7 @@
 :graalvm-flavor: jdk-21
 :mandrel-flavor: jdk-21
 :surefire-version: 3.5.2
-:gradle-version: 8.12
+:gradle-version: 8.13
 :elasticsearch-version: 8.15.0
 :elasticsearch-image: docker.io/elastic/elasticsearch:8.15.0
 :opensearch-image: docker.io/opensearchproject/opensearch:2.16.0
diff --git a/_guides/appcds.adoc b/_guides/appcds.adoc
@@ -105,7 +105,7 @@ If you are building an application that will target JDK 24+ you can take advanta
 -Dquarkus.package.jar.appcds.use-aot=true
 ----
 
-The result of this flag (plus the `-Dquarkus.package.jar.appcds.use-aot=true` original one) is the creation of an AOT cache file
+The result of this flag (plus the `-Dquarkus.package.jar.appcds.enabled=true` original one) is the creation of an AOT cache file
 named `app.aot`.
 
 You can use this AOT cache when launching the application like so:
diff --git a/_guides/centralized-log-management.adoc b/_guides/centralized-log-management.adoc
@@ -111,10 +111,10 @@ and specify the host and port of your Logstash endpoint. To be ECS compliant, sp
 [source, properties]
 ----
 # to keep the logs in the usual format in the console
-quarkus.log.console.json=false
+quarkus.log.console.json.enabled=false
 
 quarkus.log.socket.enable=true
-quarkus.log.socket.json=true
+quarkus.log.socket.json.enabled=true
 quarkus.log.socket.endpoint=localhost:4560
 
 # to have the exception serialized into a single text element
diff --git a/_guides/kubernetes-dev-services.adoc b/_guides/kubernetes-dev-services.adoc
@@ -10,10 +10,11 @@ include::_attributes.adoc[]
 :topics: dev-services,kubernetes,testing,dev-mode
 :extensions: io.quarkus:quarkus-kubernetes-client
 
-Dev Services for Kubernetes automatically starts a Kubernetes API server in dev mode and when running tests.
-So you don't have to start a Kubernetes cluster manually.
+Dev Services for Kubernetes automatically starts a Kubernetes API server (plus the required etcd) in dev mode and when running tests. So you don't have to start it manually.
 The application is configured automatically.
 
+The following https://github.com/dajudge/kindcontainer?tab=readme-ov-file#container-flavors[testcontainers] are supported: https://kind.sigs.k8s.io/[kind], https://k3s.io/[k3s] or api only(default)
+
 == Enabling / Disabling Dev Services for Kubernetes
 
 Dev Services for Kubernetes is automatically enabled unless:
@@ -23,9 +24,9 @@ Dev Services for Kubernetes is automatically enabled unless:
 - a valid Kube config file is found and `quarkus.kubernetes-client.devservices.override-kubeconfig` is not set to `true`
 - you include the `quarkus-test-kubernetes-client` dependency
 
-Dev Services for Kubernetes relies on Docker to start the API server.
-If your environment does not support Docker, you will need to start the Kubernetes cluster manually, or connect to an already running Kubernetes cluster.
-You can configure the Kubernetes cluster access using either a Kube config file or the various properties available in the https://github.com/quarkusio/quarkus/blob/main/extensions/kubernetes-client/runtime-internal/src/main/java/io/quarkus/kubernetes/client/runtime/KubernetesClientBuildConfig.java[KubernetesClientBuildConfig] class.
+NOTE: Dev Services for Kubernetes relies on a container engine: Docker or Podman to start the server.
+If your environment does not support such a container engine, you will have to start a Kubernetes cluster running in a VM, in the cloud, etc.
+In this case, you can configure the Kubernetes cluster access using either a Kube config file or the various properties available in the https://github.com/quarkusio/quarkus/blob/main/extensions/kubernetes-client/runtime-internal/src/main/java/io/quarkus/kubernetes/client/runtime/KubernetesClientBuildConfig.java[KubernetesClientBuildConfig] class.
 
 == Shared cluster
 
@@ -41,6 +42,51 @@ The default service name is `kubernetes`.
 Sharing is enabled by default in dev mode, but disabled in test mode.
 You can disable the sharing with `quarkus.kubernetes-client.devservices.shared=false`.
 
+== What else for the developers
+
+If you would like to develop test cases running top of the kubernetes cluster (launched as test container by the Dev Service), then add the following dependencies to your pom file
+
+[source,xml,role="primary asciidoc-tabs-target-sync-cli asciidoc-tabs-target-sync-maven"]
+.pom.xml
+----
+<dependency>
+    <groupId>io.quarkus</groupId>
+    <artifactId>quarkus-kubernetes-client</artifactId>
+</dependency>
+----
+
+and set the Quarkus properties to select the flavor, or kube version.
+
+Then you will be able to create a Fabric8 Kubernetes Client object able to perform many kube tasks as detailed part of this https://github.com/fabric8io/kubernetes-client/blob/main/doc/CHEATSHEET.md[cheat sheet].
+
+.Simple Bean Example
+[source,java]
+----
+package org.acme;
+
+import org.junit.jupiter.api.Test;
+
+import io.fabric8.kubernetes.api.model.*;
+import io.fabric8.kubernetes.client.KubernetesClient;
+import io.quarkus.test.junit.QuarkusTest;
+
+@QuarkusTest
+public class ArgocdExtensionDevModeTest {
+
+    @Inject
+    private KubernetesClient client;
+
+    @Test
+    public void testCreatePod() {
+        client.resource(new PodBuilder()
+           .withMetadata(<METADATA_OBJECT>)
+           .withSpec(<SPEC_OBJECT>)
+           .build())
+           .inNamespace(<USER_NAMESPACE>)
+           .create();
+    }
+----
+
 == Configuring the cluster
 
 Dev Services for Kubernetes provides three different flavors of Kubernetes cluster. Each flavor supports different Kubernetes API versions.
@@ -52,7 +98,7 @@ quarkus.kubernetes-client.devservices.flavor=api-only # k3s or kind
 quarkus.kubernetes-client.devservices.api-version=1.22
 ----
 
-`api-only` only starts a Kubernetes API Server. If you need a fully-featured Kubernetes cluster that can spin up Pods, you can use `k3s` or `kind`. Note that they both requires to run in Docker privileged mode.
+`api-only` only starts a Kubernetes API Server (plus the required etcd). If you need a fully-featured Kubernetes cluster that can spin up Pods, you can use `k3s` or `kind`. `k3s` requires to start the container with `privileged mode`. The `kind` test container supports now to use podman rootless or rootfull.
 
 If `api-version` is not set, the latest version for the given flavor will be used. Otherwise, the version must match a https://github.com/dajudge/kindcontainer/blob/master/k8s-versions.json[version supported by the given flavor].
 
diff --git a/_guides/logging.adoc b/_guides/logging.adoc
@@ -420,8 +420,8 @@ This can be achieved using different profiles, as shown in the following configu
 +
 [source, properties]
 ----
-%dev.quarkus.log.console.json=false
-%test.quarkus.log.console.json=false
+%dev.quarkus.log.console.json.enabled=false
+%test.quarkus.log.console.json.enabled=false
 ----
 
 ===== Configuration
diff --git a/_guides/rest-client.adoc b/_guides/rest-client.adoc
@@ -2117,7 +2117,7 @@ To change this behavior, set the `quarkus.rest-client.scope` property to the ful
 
 == Further reading
 
- * link:https://download.eclipse.org/microprofile/microprofile-rest-client-2.0/microprofile-rest-client-spec-2.0.html[MicroProfile Rest Client specification]
+ * link:https://download.eclipse.org/microprofile/microprofile-rest-client-4.0/microprofile-rest-client-spec-4.0.html[MicroProfile Rest Client specification]
 
 == Configuration Reference
 
diff --git a/_guides/security-cors.adoc b/_guides/security-cors.adoc
@@ -26,7 +26,7 @@ To enforce CORS policies in your application, enable the Quarkus CORS filter by
 
 [source, properties]
 ----
-quarkus.http.cors=true
+quarkus.http.cors.enabled=true
 ----
 
 The filter intercepts all incoming HTTP requests to identify cross-origin requests and applies the configured policy.
@@ -44,7 +44,7 @@ The following example shows a complete CORS filter configuration, including a re
 
 [source, properties]
 ----
-quarkus.http.cors=true <1>
+quarkus.http.cors.enabled=true <1>
 quarkus.http.cors.origins=http://example.com,http://www.example.io,/https://([a-z0-9\\-_]+)\\\\.app\\\\.mydomain\\\\.com/ <2>
 quarkus.http.cors.methods=GET,PUT,POST <3>
 quarkus.http.cors.headers=X-Custom <4>
@@ -80,7 +80,7 @@ To simplify development, consider allowing all origins in development mode only:
 
 [source, properties]
 ----
-quarkus.http.cors=true
+quarkus.http.cors.enabled=true
 %dev.quarkus.http.cors.origins=/.*/
 ----
 
diff --git a/_guides/security-jpa.adoc b/_guides/security-jpa.adoc
diff --git a/_guides/security-testing.adoc b/_guides/security-testing.adoc
