CogWheel

OpenShift Scale Tests Orchestrator

Dependencies

- Git
- Latest OC client

Run

$ git clone https://github.com/chaitanyaenr/cogwheel.git
$ cd cogwheel
$ cp cogwheel_env.example.sh cogwheel_env.sh 

Options supported by cogwheel:

$ ./cogwheel.sh help

Usage: source cogwheel_env.example.sh; ./cogwheel.sh

Options supported:
	 run_scale_test=str,            str=true or false
	 scale_test_image=str,          str=Image to run
	 cleanup=str,                   str=true or false
	 kubeconfig_path=str,           str=path to the kubeconfig
	 cogwheel_repo_location=str,    str=path to the cogwheel repo
	 properties_file_path=str,      str=path to the properties file
	 capture_prometheus_db=str,     str=true or false
	 prometheus_db_path=str,        str=path to export the prometheus DB

Workload Images and OCP clusters supported:

Workload Image	Description	Privileged	Scale Cluster	Starter	OSD
ravielluri/image:nodevertical	kubelet density focused test which creates max pods per compute node	False	✔️	✔️	✔️
ravielluri/image:mastervertial	control plane density focused test	False	✔️	✔️	✔️
BYO ( Bring your own workload )	Any image which works on OCP cluster	True/False ( False is preferred for it to work on Starter and OSD clusters	NA	NA	NA

Create a properties file ( key=value format ), this gets converted to a configmap for the workload. For example for nodevertical, it's just JOB=nodevertical. Set the environment variables in cogwheel_env.sh, source it and run cogwheel:

$ source cogwheel_env.sh
$ ./cogwheel.sh

Using pbench for running cogwheel and prometheus tarball storage

Assuming that the pbench - https://github.com/distributed-system-analysis/pbench is installed on the host on which cogwheel is running, kickoff cogwheel using pbench:

$ source cogwheel_env.sh
$ pbench-user-benchmark -C <Test name> -- <cogwheel_dir>/coghweel.sh

Assuming that the pbench server is up and keys are setup correctly, move the results to the pbench server:

$ pbench-move-results --prefix=<prefix for the results>

Look for the cogwheel controller hostname for results at https://<pbench_server>/results.

Credits

Created my free logo at LogoMakr.com.