GuidesAPI ReferenceJoin the Mailing ListMake a Suggestion

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: [email protected]
current-context: [email protected]
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.

Did this page help you?

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