X-Git-Url: https://gerrit.akraino.org/r/gitweb?a=blobdiff_plain;f=docker%2FREADME.rst;h=1deab89cc423efa3a4ee0bfcebc4bda0ad475afd;hb=b4b3a0e950a01f3ed9eedda7480cffecc989bdf1;hp=12c75becb58af9ff13ef576938f4d5c5ea4b921d;hpb=b40ded325740684f73b7b2da7c86fb37cebb4cfb;p=validation.git diff --git a/docker/README.rst b/docker/README.rst index 12c75be..1deab89 100644 --- a/docker/README.rst +++ b/docker/README.rst @@ -228,7 +228,7 @@ Example: .. code-block:: console - docker run -ti akraino/validation:kube-conformance-v1.11 + docker run -ti akraino/validation:kube-conformance-v1.15 By default, the container will run the `run_e2e.sh` script. If you want to enter the container, add */bin/sh* at the end of the command above @@ -274,3 +274,78 @@ want to enter the container, add */bin/sh* at the end of the command above. Normally, this conainer is not used directly, but instead leveraged via sonobuoy. + +The openstack container +======================= + +Building and pushing the container +---------------------------------- + +To build just the openstack container, use the command: + +.. code-block:: console + + make openstack-build [ REGISTRY= NAME=] + +To both build and push the container, use the command: + +.. code-block:: console + + make openstack [ REGISTRY= NAME=] + +Using the container +------------------- + +The openstack image is meant to be ran from a server that has access to the +openstack deployment (jenkins slave, jumpserver, etc). + +Before running the image, copy openstack deployment environment variables +(openrc) to a local folder (e.g. /root/openrc). + +Container needs to be started with the openrc file mounted. Optionally, test +cases can be excluded from execution via a mounted blacklist file. + +The results folder can be mounted as well; this way the logs are +stored on the local server. + +.. code-block:: console + + docker run -ti -v /home/jenkins/openrc:/root/openrc \ + -v /home/jenkins/blacklist.txt:/opt/akraino/validation/tests/openstack/tempest/blacklist.txt \ + -v /home/jenkins/openstack_results:/opt/akraino/results/ \ + akraino/validation:openstack-latest + +The helm container +================== + +Building and pushing the container +---------------------------------- + +To build just the helm container, use the command: + +.. code-block:: console + + make helm-build [ REGISTRY= NAME=] + +To both build and push the container, use the command: + +.. code-block:: console + + make helm [ REGISTRY= NAME=] + +Using the container +------------------- + +Container needs to be started with the SSH key file mounted. Users +credentials can be provided via a mounted variables.yaml file. + +The results folder can be mounted as well; this way the logs are +stored on the local server. + +.. code-block:: console + + docker run -ti -v /home/jenkins/openrc:/root/openrc \ + -v /home/foobar/.ssh/id_rsa:/root/.ssh/id_rsa \ + -v /home/foobar/variables.yaml:/opt/akraino/validation/tests/variables.yaml \ + -v /home/foobar/helm_results:/opt/akraino/results/ \ + akraino/validation:helm-latest