Improve kubernetes dev service documentation and add integration test

Author: LarsSven

docs/src/main/asciidoc/kubernetes-dev-services.adoc

@@ -88,11 +88,22 @@ And then add the following property to your `application.properties`:
 quarkus.kubernetes-client.devservices.manifests=kubernetes/namespace.yaml
 ```
 
+When applying multiple properties, you can apply them as:
+```
+quarkus.kubernetes-client.devservices.manifests[0]=kubernetes/first_manifest.yaml
+quarkus.kubernetes-client.devservices.manifests[1]=kubernetes/second_manifest.yaml
+```
+
 It is also possible to apply manifests from a URL. So the following syntax would also be possible:
 ```
 quarkus.kubernetes-client.devservices.manifests=https://example.com/kubernetes/namespace.yaml
 ```
 
+NOTE: Quarkus will apply the manifests in the order they are specified in the list.
+
+NOTE: Quarkus will await resources such as deployments to be ready before moving on to the next manifest.
+All applied resources are guaranteed to be ready by the time your application finishes startup.
+
 === Deploying helm charts
 `quarkus.kubernetes-client.devservices.manifests` only supports manifests. If you want to deploy a helm chart, you can use the `k3s` flavor and deploy a `HelmChart` manifest. See https://docs.k3s.io/helm for more information on how to use helm charts with k3s.
 

extensions/kubernetes-client/deployment/src/main/java/io/quarkus/kubernetes/client/deployment/DevServicesKubernetesProcessor.java

@@ -230,14 +230,14 @@ public void applyManifests(
                             });
                         }
                     } catch (Exception ex) {
-                        log.errorf("Failed to deploy manifest %s: %s", manifestPath, ex.getMessage());
+                        log.errorf("Failed to apply manifest %s: %s", manifestPath, ex.getMessage());
                     }
                 }
 
                 log.infof("Applied manifest %s.", manifestPath);
             }
         } catch (Exception e) {
-            log.error("Failed to create Kubernetes client while trying to deploy manifests.", e);
+            log.error("Failed to create Kubernetes client while trying to apply manifests.", e);
         }
     }
 

integration-tests/kubernetes-client-devservices/src/main/resources/application.properties

@@ -1 +1,2 @@
-quarkus.kubernetes-client.devservices.manifests=kubernetes/namespace.yaml
+quarkus.kubernetes-client.devservices.manifests[0]=kubernetes/namespace.yaml
+quarkus.kubernetes-client.devservices.manifests[1]=https://k8s.io/examples/admin/namespace-dev.yaml

integration-tests/kubernetes-client-devservices/src/test/java/io/quarkus/kubernetes/client/devservices/it/DevServicesKubernetesTest.java

@@ -26,8 +26,15 @@ public void shouldReturnAllKeys() {
     }
 
     @Test
-    @DisplayName("specified manifest must be applied to the cluster by the dev service")
-    public void manifestIsApplied() {
+    @DisplayName("specified manifest in the resources folder must be applied to the cluster by the dev service")
+    public void resourceManifestIsApplied() {
         Assertions.assertNotNull(kubernetesClient.namespaces().withName("example-namespace").get());
     }
+
+    @Test
+    @DisplayName("specified manifest from a URL must be applied to the cluster by the dev service")
+    public void urlManifestIsApplied() {
+        // Applied by https://k8s.io/examples/admin/namespace-dev.yaml
+        Assertions.assertNotNull(kubernetesClient.namespaces().withName("development").get());
+    }
 }