Installation Overview
Testkube contains two main components:
- The Testkube Control Plane which includes the Dashboard, Storage for Results/Artifacts, User/Role mgmt, Insights, etc.
- The Testkube Agent which executes your tests, collects test execution logs/results and listens for Kubernetes Events. The agent is always deployed in your own infrastructure.
You can install as many agents as needed, they can all be managed from a single instance of the Control Plane.
Deployment Options
You can deploy Testkube in one of the following ways:
- Testkube On-Prem - the Control Plane is installed and managed by you in your own infrastructure.
- Testkube Cloud - the Control Plane runs in the cloud and managed by the Testkube Team.
- Testkube Open Source - the Agent runs without a Control Plane for single cluster usage scenarios.
High-level deployment architecture and how to get started with each of these is described below.
An architectural overview of Testkube and its components is available in the Architecture Reference.
Testkube On-Prem
Testkube On-Prem 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.
Check out Helm Components to see all the actual components used by Testkube.
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.
Read more about Multi-cluster deployments at Multicluster
Testkube Cloud
When using Testkube Cloud, 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 Testkube Cloud is shown below.
Even when using Testkube Cloud, your actual tests are never run or stored on our servers, only test logs and artifacts will be stored.
Testkube Open Source
The Testkube Agent is in itself Open Source and can be deployed without a control plane or Dashboard. All management and test execution tasks are done through the Testkube CLI.
- Learn more about how the Standalone Agent compares
- Learn more about how to deploy the Standalone Agent.