Installing K10 on IBM Cloud

Prerequisites

Before installing K10 on IBM Cloud Kubernetes Service (IKS), please ensure that the install prerequisites are met.

Installing K10

Note

Support for IBM Cloud's IKS is currently in preview. Please contact support if you have any questions.

To install on IKS, you need to specify your Classic infrastructure API key and user name. How To obtain Classic infrastructure API key.

Helm 3

Helm 2

$ helm install k10 kasten/k10 --namespace=kasten-io \
    --set secrets.ibmSoftLayerApiUsername=<API user name> \
    --set secrets.ibmSoftLayerApiKey=<API key>

$ helm install kasten/k10 --name=k10 --namespace=kasten-io \
    --set secrets.ibmSoftLayerApiUsername=<API user name> \
    --set secrets.ibmSoftLayerApiKey=<API key>

Validating the Install

To validate that K10 has been installed properly, the following command can be run in K10's namespace (the install default is kasten-io) to watch for the status of all K10 pods:

$ kubectl get pods --namespace kasten-io --watch

It may take a couple of minutes for all pods to come up but all pods should ultimately display the status of Running.

$ kubectl get pods --namespace kasten-io
NAMESPACE     NAME                                    READY   STATUS    RESTARTS   AGE
kasten-io     aggregatedapis-svc-b45d98bb5-w54pr      1/1     Running   0          1m26s
kasten-io     auth-svc-8549fc9c59-9c9fb               1/1     Running   0          1m26s
kasten-io     catalog-svc-f64666fdf-5t5tv             2/2     Running   0          1m26s
...

In the unlikely scenario that pods that are stuck in any other state, please follow the support documentation to debug further.

Validate Dashboard Access

By default, the K10 dashboard will not be exposed externally. To establish a connection to it, use the following kubectl command to forward a local port to the K10 ingress port:

$ kubectl --namespace kasten-io port-forward service/gateway 8080:8000

The K10 dashboard will be available at http://127.0.0.1:8080/k10/#/.

For a complete list of options for accessing the Kasten K10 dashboard through a LoadBalancer, Ingress or OpenShift Route you can use the instructions here.