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
- Ein vollständig bereitgestelltes Cluster
- Installiertes
kubectl, siehe offizielle Installationsanleitung
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.
| Eigenschaft | Wert |
|---|---|
| Anmeldeverfahren | Client-Zertifikat, signiert von der Zertifizierungsstelle Ihres Clusters |
| Benutzer | customer-admin |
| Rechte | cluster-admin – uneingeschränkter Zugriff auf das gesamte Cluster |
| Gültigkeit | 7 Tage ab Erzeugung |
Jeder Abruf erzeugt eine neue Datei mit neuem Zertifikat. Ältere Dateien bleiben bis zu ihrem Ablauf gültig.
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
| Befehl | Zweck |
|---|---|
kubectl config get-contexts | Listet die Kontexte der Datei auf |
kubectl cluster-info | Zeigt die Adresse der Control Plane |
kubectl version | Zeigt die Version von Client und Server |
kubectl get nodes | Listet 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
| Symptom | Mö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 refused | Das Cluster ist noch nicht vollständig bereitgestellt |
Unable to connect to the server: dial tcp ... i/o timeout | Ihr Netzwerk oder Ihre Firewall blockiert den Zugriff auf den API-Endpunkt |
Nodes im Status NotReady | Siehe Node Remediation |
| Warnung zur Versionsabweichung | Ihre kubectl-Version weicht um mehr als eine Minor-Version ab |