R10 tag/path update
[dcaegen2/platform/plugins.git] / k8s / plugin_testing_blueprints / blueprints / README.md
1 # Blueprints for testing the DCAE Kubernetes plugin
2 The blueprints in this directory are designed as test cases for the DCAE
3 Kubernetes Cloudify plugin (`k8splugin`).  Each blueprint tests a single
4 feature, or small set of features, supported by the plugin.
5
6 The testing strategy here is simple and not very automated.  Deploying a DCAE
7 component using a Cloudify blueprint typically has a number of effects (creating a
8 Kubernetes deployment, creating a Kubernetes service, populating configuration information
9 into Consul, mounting certain volumes on a container, and so forth).  For now at least, we use a
10 manual process to verify that deployment has had the expected effects:
11 - we use `kubectl` to checkthat the expected Kubernetes artifacts are created
12 -  we look into Consul to see that the appropriateconfiguration information has been populated (including configuration information that comes
13 from DMaaP and policy where the blueprint calls for it)
14 - we `kubectl exec` into the container to verify that the expected environment variables have been set and the expected volumes are mounted and have the correct content
15
16 All of the blueprints deploy the `nginx` image from the public Docker Hub.  The blueprints
17 will generally deploy the `nginx` Web server so that it serves the default Web page on port 80
18 of the container and on a NodePort if the blueprint specifies an external port address.
19 Some of the blueprints set up TLS.  The expected result is that the appropriate directories
20 will be created and will hold the TLS artifacts.   We don't actually configure `nginx` to use
21 TLS.