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. For example:
brew install 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 helm and verify the installation.
brew install helm

helm env

$HELM_NAMESPACE must be set to sandbox.

See Helm (& Tiller) for more information.

What's next

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

Updated 17 days 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.