Sync documentation of main branch

Author: actions-user

_generated-doc/main/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[]
@@ -81231,7 +81231,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[]
@@ -82346,7 +82346,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[]

_generated-doc/main/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[]

_generated-doc/main/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[]

_generated-doc/main/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[]

_generated-doc/main/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[]
@@ -1448,7 +1448,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[]

_generated-doc/main/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[]
@@ -1448,7 +1448,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[]

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

@@ -5386,7 +5386,7 @@ _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]
 --
-_No Javadoc found_
+BuildItem packaging the information of the kind test container created
 -- a|`java.lang.String kubeConfig` 
 
 _No Javadoc found_
@@ -5398,6 +5398,17 @@ _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]
 --

_versions/main/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].
 

_versions/main/guides/testing-components.adoc

@@ -232,6 +232,59 @@ public class FooTest {
 Sometimes you need the full control over the bean attributes and maybe even configure the default mock behavior.
 You can use the mock configurator API via the `QuarkusComponentTestExtensionBuilder#mock()` method.
 
+== Nested Tests
+
+JUnit 5 https://junit.org/junit5/docs/current/user-guide/#writing-tests-nested[@Nested tests] may help to structure more complex test scenarios.
+However, only basic use cases are tested with `@QuarkusComponentTest`.
+
+.Nested test
+[source, java]
+----
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+import jakarta.inject.Inject;
+import io.quarkus.test.InjectMock;
+import io.quarkus.test.component.TestConfigProperty;
+import io.quarkus.test.component.QuarkusComponentTest;
+import org.junit.jupiter.api.Test;
+import org.mockito.Mockito;
+
+@QuarkusComponentTest <1>
+@TestConfigProperty(key = "bar", value = "true") <2>
+public class FooTest {
+
+    @Inject
+    Foo foo; <3>
+
+    @InjectMock
+    Charlie charlieMock; <4>
+    
+    @Nested
+    class PingTest {
+    
+       @Test
+       public void testPing() {
+          Mockito.when(charlieMock.ping()).thenReturn("OK");
+          assertEquals("OK", foo.ping());
+       }
+    }
+    
+    @Nested
+    class PongTest {
+    
+       @Test
+       public void testPong() {
+          Mockito.when(charlieMock.pong()).thenReturn("NOK");
+          assertEquals("NOK", foo.pong());
+       }
+    }
+}
+----
+<1> The `QuarkusComponentTest` annotation registers the JUnit extension.
+<2> Sets a configuration property for the test.
+<3> The test injects the component under the test. `Foo` injects `Charlie`.
+<4> The test also injects a mock for `Charlie`. The injected reference is an "unconfigured" Mockito mock.
+
 == Configuration
 
 You can set the configuration properties for a test with the `@io.quarkus.test.component.TestConfigProperty` annotation or with the `QuarkusComponentTestExtensionBuilder#configProperty(String, String)` method.
@@ -240,6 +293,8 @@ If you only need to use the default values for missing config properties, then t
 It is also possible to set configuration properties for a test method with the `@io.quarkus.test.component.TestConfigProperty` annotation.
 However, if the test instance lifecycle is `Lifecycle#_PER_CLASS` this annotation can only be used on the test class and is ignored on test methods.
 
+NOTE: `@io.quarkus.test.component.TestConfigProperty` declared on a `@Nested` test class is always ignored.
+
 CDI beans are also automatically registered for all injected https://smallrye.io/smallrye-config/Main/config/mappings/[Config Mappings]. The mappings are populated with the test configuration properties.
 
 == Mocking CDI Interceptors