Testkube On-Prem with CLI

This step-by-step tutorial provides you with a simplified Testkube On Prem installation that deploys both the Testkube Control Plane and Agent within the same namespace. It does not create Ingress configuration as it is mainly designed for local installations that allow you to quickly try out and evaluate the solution. It comes with a preconfigured admin account, Organization and Environment for running your tests.

1. Prerequisites

Before you can get started with the quickstart deployment, you will need the following:

• Access to a Kubernetes cluster.
• The helm CLI to generate the required Kubernetes YAML configurations.
• The kubectl CLI to run commands against Kubernetes clusters.
• The Testkube CLI for the quickstarter. For instructions, see the next section.

You will need to request a trial license that will be required during the installation process.

info

Using a license helps us ensure you have an optimal installation and product experience with Testkube. Don’t worry, you won’t have to talk to a sales rep or enter any credit-card details to get going, but if you need our help we’ll be much better prepared!

2. Install the Testkube CLI

You can choose one of the following methods to install the CLI:

MacOS

Run the following command to install the Testkube CLI with brew on MacOS:

brew install testkube

Windows

Run the following commands to install the Testkube CLI with Chocolatey on Windows.

choco source add --name=kubeshop_repo --source=https://chocolatey.kubeshop.io/chocolatey
choco install testkube -y

Ubuntu

Run the following commands to install the Testkube CLI on Ubuntu:

wget -qO - https://repo.testkube.io/key.pub | sudo apt-key add -
echo "deb https://repo.testkube.io/linux linux main" | sudo tee -a /etc/apt/sources.list
sudo apt-get update
sudo apt-get install -y testkube

Script

Run the following command to install the Testkube CLI with curl:

curl -sSLf https://get.testkube.io | sh

Manual Download

1. Download the binary for the version and platform of your choice here.
2. Unpack it. For example, in Linux use tar -zxvf testkube_1.5.1_Linux_x86_64.tar.gz.
3. Move it to a location in the PATH. For example:

mv  testkube_1.5.1_Linux_x86_64/kubectl-testkube /usr/local/bin/kubectl-testkube

For Windows, you will need to unpack the binary and add it to the %PATH% as well.

3. Run the Testkube Installer

The installer will complete these steps:

• Check if you have chosen the right Kubernetes environment.
• Ask for some information, such as the trial license requested as noted above.
• Install Testkubes Control Plane and Agent, both within the same namespace.

The whole process takes 3-5 minutes and can be started with the following command:

testkube init demo

Once installed, you will be asked if you want to testkube dashboard to conveniently access all relevant services on your localhost. You can always execute this yourself afterward should you close this terminal after installation. The admin in this demo has the following e-mail and password: admin@example.com/password.

info

In case of issues with license please try testkube diag license command for license validation.

Happy testing!