Testkube Runner with local Kubernetes
Only want to try Testkube On-Prem? The local trial creates its own cluster, so you can skip this page.
The Testkube Runner uses Kubernetes as its runtime environment, which requires you to have access to a Kubernetes cluster either running locally on your machine or remotely in some cloud provider like AWS, Google, Azure, etc.
Installing a Lightweight Kubernetes Distribution
There are a number of lightweight Kubernetes distributions that you can install under Docker, all of them require Docker to be installed, so make sure that is up and running before moving on (download Docker Desktop from https://www.docker.com/products/docker-desktop/).
Recommended Kubernetes distributions for local Testkube evaluation are:
- kind - https://kind.sigs.k8s.io/
- minikube - https://minikube.sigs.k8s.io/
- k3s - https://k3s.io/
A detailed tutorial on how to run Testkube with kind is available at Testing in KinD: Using Testkube with Kubernetes in Docker
Installing kind under MacOS or Windows
kind is a tool for running local Kubernetes clusters using Docker container “nodes”. Read all about how to quickly get started with kind at https://kind.sigs.k8s.io/docs/user/quick-start/.
Installation of kind is straight-forward, instructions for MacOS and Windows are shown below.
- Install Kind on MacOS
- Install Kind on Windows
First install kind using brew:
brew install kind
Then create a default cluster where you will install the Testkube Runner:
kind create cluster
Make sure you have Chocolatey installed, then run
choco install kind
Then create a default cluster where you will install the Testkube Runner:
kind create cluster
That's it. Now install the Testkube Runner in this cluster.
Using the Kubernetes Distribution Included with Docker Desktop
Docker Desktop comes with a built-in version of Kubernetes - Read More. If you enable this feature you will have a local Kubernetes cluster available and should be all set - install the Testkube Runner in it.