Zum Hauptinhalt springen

Mit dem Cluster verbinden

Sie greifen über den Kubernetes-Client kubectl und eine Kubeconfig-Datei auf Ihr Cluster zu. Die Datei erzeugen Sie in der ccloud; sie enthält ein Client-Zertifikat mit Administratorrechten und ist sieben Tage gültig.

Voraussetzungen​

1. kubectl prüfen​

kubectl version --client

kubectl unterstützt eine Minor-Version Abweichung nach oben und unten zur Cluster-Version. Bei einem Cluster mit Version 1.36 sind die Client-Versionen 1.35 bis 1.37 geeignet.

2. Kubeconfig erzeugen​

Öffnen Sie das Cluster in der ccloud und laden Sie die Kubeconfig herunter. Notieren Sie sich das Datum: Die Datei ist ab dem Download sieben Tage gültig.

EigenschaftWert
AnmeldeverfahrenClient-Zertifikat, signiert von der Zertifizierungsstelle Ihres Clusters
Benutzercustomer-admin
Rechtecluster-admin – uneingeschränkter Zugriff auf das gesamte Cluster
Gültigkeit7 Tage ab Erzeugung

Jeder Abruf erzeugt eine neue Datei mit neuem Zertifikat. Ältere Dateien bleiben bis zu ihrem Ablauf gültig.

Warnung

Ein ausgegebenes Zertifikat bleibt bis zu seinem Ablauf gültig. Behandeln Sie die Datei wie ein Passwort: nicht in Versionsverwaltungen einchecken, nicht über unverschlüsselte Kanäle weitergeben, nach Gebrauch löschen.

chmod 600 /<pfad>/<cluster-name>-kubeconfig.yaml

Für Anwendungen und CI-Pipelines, die dauerhaft und mit eingeschränkten Rechten zugreifen sollen, legen Sie im Cluster einen eigenen ServiceAccount an, siehe RoleBindings einrichten.

3. kubectl auf die Datei verweisen​

kubectl --kubeconfig=/<pfad>/<cluster-name>-kubeconfig.yaml get nodes

Damit der Pfad nicht bei jedem Aufruf nötig ist, setzen Sie die Umgebungsvariable KUBECONFIG:

export KUBECONFIG=/<pfad>/<cluster-name>-kubeconfig.yaml

4. Verbindung prüfen​

BefehlZweck
kubectl config get-contextsListet die Kontexte der Datei auf
kubectl cluster-infoZeigt die Adresse der Control Plane
kubectl versionZeigt die Version von Client und Server
kubectl get nodesListet alle Nodes des Clusters auf

Bei kubectl get nodes sollten alle Nodes den Status Ready aufweisen:

NAME                                  STATUS   ROLES           AGE   VERSION
ks12345-control-plane-abcde Ready control-plane 20m v1.36.5
ks12345-md-node-pool-1-xyz12-fghij Ready <none> 15m v1.36.5

Mehrere Cluster verwalten​

# Verfügbare Kontexte auflisten
kubectl config get-contexts

# Kontext wechseln
kubectl config use-context <kontext-name>

# Standard-Namespace für den aktuellen Kontext setzen
kubectl config set-context --current --namespace=<namespace>

Fehlersuche​

SymptomMögliche Ursache
error: You must be logged in to the server (Unauthorized)Das Zertifikat ist abgelaufen – erzeugen Sie eine neue Kubeconfig
The connection to the server ... was refusedDas Cluster ist noch nicht vollständig bereitgestellt
Unable to connect to the server: dial tcp ... i/o timeoutIhr Netzwerk oder Ihre Firewall blockiert den Zugriff auf den API-Endpunkt
Nodes im Status NotReadySiehe Node Remediation
Warnung zur VersionsabweichungIhre kubectl-Version weicht um mehr als eine Minor-Version ab

Nächste Schritte​