To run Kuma on Kubernetes, you need to download a compatible version of Kuma for the machine from which you will be executing the commands.
You can run the following script to automatically detect the operating system and download Kuma:
$ curl -L https://kuma.io/installer.sh |sh -
1
You can also download the distribution manually. Download a distribution for the client host from where you will be executing the commands to access Kubernetes:
Once downloaded, you will find the contents of Kuma in the kuma-0.5.1 folder. In this folder, you will find - among other files - the bin directory that stores the executables for Kuma, including the CLI client kumactl.
Note: On Kubernetes - of all the Kuma binaries in the bin folder - we only need kumactl.
So we enter the bin folder by executing:
$ cd kuma-0.5.1/bin
1
And we can then proceed to install Kuma on Kubernetes with:
We suggest adding the kumactl executable to your PATH so that it's always available in every working directory. Or - alternatively - you can also create link in /usr/local/bin/ by executing:
ln -s ./kumactl /usr/local/bin/kumactl
1
It may take a while for Kubernetes to start the Kuma resources, you can check the status by executing:
Kuma (kuma-cp) will be installed in the newly created kuma-system namespace! Now that Kuma has been installed, you can access the control-plane via either the GUI, kubectl, the HTTP API, or the CLI:
Kuma ships with a read-only GUI that you can use to retrieve Kuma resources. By default the GUI listens on port 5683.
To access Kuma we need to first port-forward the GUI service with:
You can use the kumactl CLI to perform read-only operations on Kuma resources. The kumactl binary is a client to the Kuma HTTP API, you will need to first port-forward the API service with: