Zum Inhalt

kubectl config

Zeigt und ändert die kubeconfig: welche Cluster kubectl kennt, welcher aktiv ist und welcher Namespace als Standard gilt.

kubectl-config output

Syntax

kubectl config UNTERBEFEHL [OPTIONEN]

Optionen

Option Beschreibung
view Die Konfiguration zeigen (Schlüssel werden ausgeblendet)
get-contexts Alle Kontexte auflisten (Cluster, Benutzer, Namespace); * markiert den aktiven
current-context Den aktiven Kontext zeigen
use-context NAME Zu einem anderen Cluster wechseln
set-context --current --namespace=NS Den Standard-Namespace des aktiven Kontexts setzen
rename-context ALT NEU Einem Kontext einen besseren Namen geben
--kubeconfig DATEI Eine andere Datei nutzen (funktioniert auch bei jedem anderen kubectl-Befehl)

Beispiele

Die Kontexte auflisten:

kubectl config get-contexts
CURRENT   NAME      CLUSTER   AUTHINFO   NAMESPACE
*         default   default   default

Die Konfiguration zeigen:

kubectl config view
apiVersion: v1
clusters:
- cluster:
    certificate-authority-data: DATA+OMITTED
    server: https://127.0.0.1:6443
  name: default
contexts:
- context:
    cluster: default
    user: default
  name: default
current-context: default
kind: Config
users:
- name: default
  user:
    client-certificate-data: DATA+OMITTED
    client-key-data: DATA+OMITTED

status zum Standard-Namespace machen:

kubectl config set-context --current --namespace=status
kubectl get pods
Context "default" modified.
NAME                  READY   STATUS    RESTARTS   AGE
web-9bc5f7f5b-8ptw2   1/1     Running   0          2h
web-9bc5f7f5b-m8l96   1/1     Running   0          2h

Dem Kontext einen klaren Namen geben:

kubectl config rename-context default tuxdex-srv
kubectl config current-context
Context "default" renamed to "tuxdex-srv".
tuxdex-srv

Wann brauche ich das?

  • Um zu prüfen, mit welchem Cluster du sprichst, bevor du etwas änderst
  • Um zwischen Test- und Produktionscluster zu wechseln
  • Um nicht bei jedem Befehl -n status tippen zu müssen

Mehrere Dateien auf einmal

KUBECONFIG=~/.kube/config:~/.kube/prod.yaml fasst mehrere Dateien zusammen. kubectl config view --flatten schreibt sie als eine.

Wissen, wo du bist

Ein Befehl für den Testcluster kann die Produktion treffen, wenn der falsche Kontext aktiv ist. Gib Kontexten klare Namen (rename-context default tuxdex-srv) und prüfe mit kubectl config current-context.

Unterschiede zwischen Distributionen

Debian Ubuntu RHEL Arch
kubectl bei k3s dabei; sonst Repository pkgs.k8s.io, dann sudo apt install kubectl bei k3s dabei; sonst Repository pkgs.k8s.io oder sudo snap install kubectl --classic bei k3s dabei; sonst Repository pkgs.k8s.io, dann sudo dnf install kubectl bei k3s dabei; sonst sudo pacman -S kubectl

Verwandte Befehle

kubectl get · k3s · k9s