OpenShift QE Tools

(Working in Progress) - use at your own discretion

A bunch of scripts and tools to ease monitoring, testing and health checking OpenShift 3.x clusters.

0. Requirements

Python 3

If using RHEL, follow this guide to install python3.

Having installed python3, install the required modules to run the scripts:

cd openshift-qe-tools
python3 -m pip install -r requirements.txt

1. Router

Inside the router path we have scripts to check the health of OpenShift routes.

test-routes.py

Simple script to check if all your routes are ok. It basically queries the router API and pings every route to check its returned HTTP status code. If something isn't right you'll see colorful WARN and ERROR messages in your console.

How to use

Simply call python3 -m router.test-routes from the root directory. The script will use the default system:admin user and will login at your local cluster. For more details about usage use:

$ python3 -m router.test-routes -h

usage: test-routes.py [-h] [-u USER] [-p PASSWORD] [--url URL]
                      [--skip-login [SKIP_LOGIN]] [-k [IGNORE_SELFSIGN]]

check every route within an OpenShift cluster

optional arguments:
  -h, --help            show this help message and exit
  -u USER               the cluster user admin to login
  -p PASSWORD           the cluster admin password
  --url URL             the cluster URL
  --skip-login [SKIP_LOGIN]
                        completely skip oc login (you must be logged in)
  -k [IGNORE_SELFSIGN]  ignores self-signed certificates when connecting to
                        routes and OpenShift API