Kubernetes

    To install and run Kuma on Kubernetes execute the following steps:

    To run Kuma on Kubernetes, you need to download a compatible version of Kuma for the machine where you will be executing the commands.

    • CentOS
    • Debian
    • Once downloaded, we can extract the content of the archive with:

    Note: On Kubernetes - of all the Kuma binaries in the folder - we only need kumactl.

    1. $ kumactl install control-plane | kubectl apply -f -

    By executing this operation, a new kuma-system namespace will be created.

    On Kubernetes, we can start a simple service by executing the following command:

    Note that two things are happening in the YAML file:

    • We are including a kuma.io/sidecar-injection: enabled label in the Namespace to automatically inject Kuma sidecars into every Pod belonging to the namespace.
    • We are adding a kuma.io/mesh: default annotation to determine on what Mesh the service belongs.
    1. $ echo "apiVersion: kuma.io/v1alpha1
    2. kind: Mesh
    3. metadata:
    4.   name: default
    5. spec:
    6.   mtls:
    8.     ca:
    9.       builtin: {}" | kubectl apply -f -

    You can configure kumactl to point to any remote kuma-cp instance by running:

    You can now review the entities created by Kuma by using the CLI. For example you can list the Meshes:

    1. $ kumactl get meshes

    and you can list the data-planes that have been registered, and their status: