Skip to main content
New to Testkube? Unleash the power of cloud native testing in Kubernetes with Testkube. Get Started >

Testkube Installation Overview

Overview

Testkube contains two main components:

  1. The Testkube Control Plane, which includes the Dashboard, Storage for Results/Logs/Artifacts, User/Role mgmt, Insights, 3rd party integrations, etc.

  2. The Testkube Agent, which executes your tests, collects test execution logs/results and listens for Kubernetes Events.

    The Agent is Open-Source and can be deployed both Standalone and connected to the Control Plane.

    The agent is always deployed by you in your own infrastructure.

Testkube Components

Deployment Options

You can deploy Testkube in one of the following ways:

Deployment Option   Licensing           Agent                Control Plane           Dashboard        CLI     
On-Prem Control PlaneCommercialHosted by youHosted by you
Cloud Control PlaneCommercialHosted by youHosted by Testkube
Standalone AgentOpen SourceHosted by you

The high-level deployment architecture and how to get started with each of these is described below.

note

An architectural overview of Testkube and its components is available in the Architecture Reference.

On-Prem Control Plane

Testkube with the On-Prem Control Plane runs entirely in your infrastructure and can also run in air-gapped environments. The default installation deploys both the Control Plane and a single Testkube Agent within the same namespace.

You can install a preconfigured version of Testkube On-Prem with the CLI for an out-of-the-box experience or install with Helm for more configurability in production scenarios.

In either case, you will need to request a trial license that will be required during the installation process.

A high-level deployment architecture for Testkube On-Prem is shown below.

Deployment with single agent

tip

Check out Helm Components to see all the actual components used by Testkube.

On-Prem Multicluster

If you want to install Testkube On-Prem with the Control Plane in one namespace and multiple agents in any number of other namespaces or clusters, you can first install the control plane without an agent and then an agent that joins Testkube.

Deployment with federated agents

info

Read more about Multi-cluster deployments at Multicluster

Cloud Control Plane

When using the Testkube Cloud Control Plane, the Control Plane is managed by the Testkube team, you only have to install the Testkube Agent in your infrastructure wherever you want to run your tests.

To get started, visit https://app.testkube.io and sign up for a trial account. During the onboarding you will be prompted to create an initial Testkube Environment, which will provide you with the required CLI/Helm commands to deploy the corresponding Testkube Agent in your infrastructure - Read More

A high-level deployment architecture for the Testkube Cloud Control Plane is shown below.

Deployment with managed control plane

info

Even when using the Testkube Cloud Control Plane, your actual tests are never run or stored on our servers, only test logs and artifacts will be stored.

Standalone Agent

The Testkube Agent is Open Source and can be deployed without being connected to the Testkube Control Plane. All management and test execution tasks are done through the Testkube CLI.

Deployment with standalone agent