Tapping into Kubernetes

Everything you need to tap into the underlying Kubernetes layer of Orka.

Your Orka environment is a Kubernetes cluster with tiller installed and configured. To manage it, you need to install kubectl and create a kube account for your Orka environment. Optionally, you can also install helm locally to tap into tiller.

Your kube account is basically a Kubernetes service account for your Orka environment. It's limited to the sandbox namespace and comes with a default RBAC configuration.

  1. Install kubectl locally or upgrade your existing installation. For example:
brew install kubectl


brew upgrade kubectl
  1. Create a kube account and export the kubeconfig. Alternatively, if you already have a kube account, get the respective kubeconfig and export it.
orka kube create --account <NAME> -y


orka kube get --account <NAME> -y
  1. Export the resulting kubeconfig and verify that kubectl is configured properly.
export KUBECONFIG=$(pwd)/kubeconfig-orka

kubectl config view

If configured properly, you will see a similar output:

apiVersion: v1
- cluster:
    certificate-authority-data: DATA+OMITTED
  name: kubernetes
- context:
    cluster: kubernetes
    namespace: sandbox
    user: mykubeuser
  name: mykubeuser@kubernetes
current-context: mykubeuser@kubernetes
kind: Config
preferences: {}
- name: mykubeuser
    token: eyJhbGciOiJSUz...


Kubeconfig lost?

Sometimes, after a system or a terminal restart, you might need to re-get and re-export the kubeconfig for your account. Run orka kube get --account NAME -y followed by export KUBECONFIG=$(pwd)/kubeconfig-orka.

  1. (Optional) Install or upgrade helm, and verify the installation.
brew install helm


brew upgrade helm


helm env


IMPORTANT: Helm version

Use Helm 3. Older versions of Helm rely on Tiller and might not work as expected.

Run helm version to check your Helm version.

HELM_NAMESPACE must be set to sandbox.

What's next

Check the limitations imposed by the RBAC configuration and start using kubectl and helm to manage your cluster.

Β© 2019-2023 Copyright MacStadium, Inc. – Documentation built with readme.com. Orka is a registered trademark of MacStadium, Inc.