This section guides you through obtaining and configuring your kubeconfig credentials to access the SambaStack Kubernetes cluster and prepare for deployment.

​
Kubeconfig credentials

To interact with the cluster, you need valid kubeconfig credentials. SambaNova provides this file and the associated base64-encoded password.
  1. Save the provided kubeconfig file securely (e.g., ~/kube/).
  2. Decode the base64-encoded password and save it to a YAML file. 
    echo <PASSWORD> | base64 -d > <credentials-file-name>.yaml
    Store both the password and kubeconfig file securely and do not share them with unauthorized users; the password is required to access cluster nodes.
  3. Export the kubeconfig path: 
    export KUBECONFIG=~/path/to/<credentials-file-name>.yaml

​
Example kubeconfig structure

The following sample kubeconfig file shows how clusters, users, and contexts are defined for Kubernetes authentication and access. 
apiVersion: v1
kind: Config
clusters:
  - name: default
    cluster:
      certificate-authority-data: <redacted>
      server: https://<cluster-endpoint>
users:
  - name: sambastack-admin
    user:
      token: <redacted>
contexts:
  - name: default
    context:
      cluster: default
      user: sambastack-admin
      namespace: default
current-context: default

​
Kubeconfig fields

KeywordDescription
apiVersion / kindDefines the type of Kubernetes config.
clustersContains cluster names, endpoints, and certificate authority information.
usersSpecifies users and their authentication method (e.g., token).
contextsMaps a user to a cluster and may include a default namespace.
current-contextThe active context used by kubectl.