We have several images in our GitHub namespace https://github.com/sclorg/. We want to easy test all these images under an OpenShift 4.X environment and execute the basic use cases there whether those images running well in an OpenShift 4.X cluster (especially v4.3 and v4.4)

The playboook deploy-and-test.yml perform these actions:

• clone upstream image repository to /tmp/rhscl_openshift_dir
• check if vars directory contains <upstream_name>.yml file
• deploy an image specified in the <upstream_name>.yml file by variable deployment
• test an image by variable check_curl_output
• test and image by script defined in variable test_exec_command and check output defined by variable expected_exec_result

Nowadays, we are able to test these containers:

• s2i-nodejs-container
• cakephp-ex
• s2i-ruby-container
• s2i-python-container
• s2i-perl-container
• httpd-container
• postgresql-container
• mysql-container
• nginx-container

The tests are executed by ansible-playbook command. Install it by dnf command:

$ sudo dnf install -y ansible

To test RHSCL image under OpenShift 4.X environment you have to download at least OpenShift Client v4.3. The steps below will install the latest OpenShift Client 4 version.

$ mkdir -p ~/ocp4-client
$ curl -o ~/ocp4-client/ocp4-client.tar.gz https://mirror.openshift.com/pub/openshift-v4/clients/ocp-dev-preview/latest-4.4/openshift-client-linux.tar.gz
$ tar -xzvf ~/ocp4-client.tar.gz
$ export PATH="${HOME}/ocp4-client:${PATH}"

Before running playbook you have to export KUBECONFIG variable, by a command:

export KUBECONFIG=<path_to_directory>/kubeconfig

Testing run by a command: ansible-playbook deploy-and-test.yml

or simply by make command:

make ocp4-tests

To test only one container, run it by a command:

make ocp4-tests GITHUB_REPO=<upstream_github_repo_name>

In order to create a new test go through these steps.

1. Go to directory vars
2. Copy file template-container.yml to the new one, like foobar.yml
3. Fill all variables in the file like, deployment, pod_name, test_command, expected_results, test_command_2, expected_results_2.
4. Add the newest test info deploy-and-test.yaml file, task Clone and test upstream container repositories
5. For more examples, see already existing tests