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.

Updated about a year ago

Tapping into Kubernetes

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

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.

© 2019-2020 Copyright MacStadium, Inc. – Documentation built with readme.io. Orka is a registered trademark of MacStadium, Inc.