KloudBuster Docker Container Quick Start Guide¶
The recommended way to install KloudBuster is using Docker as it is the simplest.
Prerequisites¶
This quick start guide assumes you have already installed Docker. All command line examples below are based on Linux (which could be either native or in a VM) and require Internet access to Docker Hub.
1. Pull latest Docker container image¶
KloudBuster is available as a container in Docker Hub at berrypatch/kloudbuster
$ docker pull berrypatch/kloudbuster
2. Get the openrc file from your OpenStack Horizon dashboard¶
Using the Horizon dashboard, download the openrc file (Project|Compute|API Access then click on “Download OpenStack RC File”). It is best to use the admin user to run KloudBuster as much as possible (otherwise there are restrictions on what you can do). Instructions below assume a copy of that file is saved under the local directory with the name “admin-openrc.sh”
We assume in the below example that you have an openrc file available called “admin-openrc.sh” in the local directory and that the corresponding OpenStack password is “admin”.
3. Running the KloudBuster CLI¶
If you do not really need a Web UI or REST interface, you can simply run KloudBuster scale test straight from CLI in the container.
docker run -v $PWD:/opt/kb --rm berrypatch/kloudbuster kloudbuster --version
docker run -v $PWD:/opt/kb --rm berrypatch/kloudbuster kloudbuster -h
Run the default HTTP data plane scale test¶
The default HTTP scale test is described here.
docker run --rm -v $PWD:/opt/kb berrypatch/kloudbuster kloudbuster --rc /opt/kb/admin-openrc.sh --passwd admin
Run the default storage scale test¶
The default storage scale test is described here.
docker run --rm -v $PWD:/opt/kb berrypatch/kloudbuster kloudbuster --rc /opt/kb/admin-openrc.sh --passwd admin --storage
Run KloudBuster with a custom configuration¶
To get a copy of the default KloudBuster configuration and store it to a file called “kb.cfg”:
docker run --rm berrypatch/kloudbuster kloudbuster --show-config >/opt/kb/kb.cfg
less kb.cfg
You can then edit kb.cfg and modify it appropriately. To run KloudBuster with the custom configuration, simply pass it to container after mapping the host local directory to “/opt/kb” (for example):
docker run --rm -t -v $PWD:/opt/kb berrypatch/kloudbuster kloudbuster --rc /opt/kb/admin-openrc.sh --passwd admin --config /opt/kb/kb.cfg
5. Running KloudBuster as a WebUI/REST Server¶
By default KloudbBuster will listen on port 8080 in the container. This port must be mapped to a host level port using the -p argument. For example, to use the same port number at the host level:
docker run -d -p 8080:8080 --rm berrypatch/kloudbuster kb_start_server
The first port number is the host listen port (any port of your choice) while the second one after the column is the container listen port (always 8080 for KloudBuster). For example, to use port 9090 on the host and map it to the KloudBuster port in the container, you would use -p 9090:8080
To stop the KloudBuster container, you can use the “docker kill <id>” command.
Assuming the host port used is 8080, the Web UI URL to use from any browser is:
http://<host_ip>:8080
The KloudBuster REST base URL is the above URL with “/api” appended:
http://<host_ip>:8080/api