# Kubectl installieren und konfigurieren auf macOS LLMS index: [llms.txt](/llms.txt) --- ## Bevor Sie beginnen Um kubectl zu verwenden darf die kubectl-Version nicht mehr als eine Minor-Version Unterschied zu deinem Cluster aufweisen. Zum Beispiel: eine Client-Version v1.36 kann mit folgenden Versionen kommunizieren v1.35, v1.36, und v1.37. Die Verwendung der neuesten kompatiblen Version von kubectl hilft, unvorhergesehene Probleme zu vermeiden. ## Kubectl auf macOS installieren Um kubectl auf macOS zu installieren, gibt es die folgenden Möglichkeiten: - [Bevor Sie beginnen](#-heading-prerequisites-) - [Kubectl auf macOS installieren](#kubectl-auf-macos-installieren) - [Kubectl Binary mit curl auf macOS installieren](#kubectl-binary-mit-curl-auf-macos-installieren) - [Mit Homebrew auf macOS installieren](#mit-homebrew-auf-macos-installieren) - [Mit Macports auf macOS installieren](#mit-macports-auf-macos-installieren) - [Kubectl Konfiguration verifizieren](#kubectl-konfiguration-verifizieren) - [Optionale kubectl Konfigurationen und Plugins](#optionale-kubectl-konfigurationen-und-plugins) - [Shell Autovervollständigung einbinden](#shell-autovervollständigung-einbinden) - [`kubectl-convert` Plugin installieren](#kubectl-convert-plugin-installieren) - [Nächste Schritte](#-heading-whatsnext-) ### Kubectl Binary mit curl auf macOS installieren 1. Das aktuellste Release downloaden: 

   curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl"
   

   curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl"

Hinweis:

Um eine spezifische Version herunterzuladen, ersetze $(curl -L -s https://dl.k8s.io/release/stable.txt) mit der spezifischen Version

Um zum Beispiel Version 1.36.0 auf Intel macOS herunterzuladen:

curl -LO "https://dl.k8s.io/release/v1.36.0/bin/darwin/amd64/kubectl"

Für macOS auf Apple Silicon (z.B. M1/M2):

curl -LO "https://dl.k8s.io/release/v1.36.0/bin/darwin/arm64/kubectl"
2. Binary validieren (optional) Download der kubectl Checksum-Datei: 

   curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl.sha256"
   

   curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl.sha256"
Kubectl Binary mit der Checksum-Datei validieren: ```bash echo "$(cat kubectl.sha256) kubectl" | shasum -a 256 --check ``` Wenn Valide, dann sieht die Ausgabe wie folgt aus: ```console kubectl: OK ``` Falls die Validierung fehlschlägt, beendet sich `shasum` mit einem "nonzero"-Status und gibt einen Fehler aus, welcher so aussehen könnte: ```bash kubectl: FAILED shasum: WARNING: 1 computed checksum did NOT match ```

Hinweis:

Lade von der kubectl Binary und Checksum-Datei immer die selben Versionen herunter.
3. Kubectl Binary ausführbar machen. ```bash chmod +x ./kubectl ``` 4. Kubectl Binary zu einem Ordner in Ihrem `PATH` verschieben. ```bash sudo mv ./kubectl /usr/local/bin/kubectl sudo chown root: /usr/local/bin/kubectl ```

Hinweis:

Stelle sicher, dass /usr/local/bin in deiner PATH Umgebungsvariable gesetzt ist.
5. Prüfen ob die installierte Version die aktuellste Version ist: ```bash kubectl version --client ```

Hinweis:

Der oben stehende Befehl wirft folgende Warnung:

WARNING: This version information is deprecated and will be replaced with the output from kubectl version --short.

Diese Warnung kann ignoriert werden. Prüfe lediglich die kubectl Version, welche installiert wurde.

Oder benutzte diesen Befehl für eine detailliertere Ansicht: ```cmd kubectl version --client --output=yaml ``` 6. Nach Installation des Plugins, die Installationsdateien aufräumen: ```bash rm kubectl kubectl.sha256 ``` ### Mit Homebrew auf macOS installieren Wenn macOS und [Homebrew](https://brew.sh/) als Paketmanager benutzt wird, kann kubectl über diesen installiert werden. 1. Führe den Installationsbefehl aus: ```bash brew install kubectl ``` oder ```bash brew install kubernetes-cli ``` 2. Prüfen ob die installierte Version die aktuellste Version ist: ```bash kubectl version --client ``` ### Mit Macports auf macOS installieren Wenn macOS und [Macports](https://macports.org/) als Paketmanager benutzt wird, kann kubectl über diesen installiert werden. 1. Führe den Installationsbefehl aus: ```bash sudo port selfupdate sudo port install kubectl ``` 2. Prüfen ob die installierte Version die aktuellste Version ist: ```bash kubectl version --client ``` ## Kubectl Konfiguration verifizieren

Um mithilfe von kubectl ein Cluster zu finden und darauf zuzugreifen benötigt es eine kubeconfig Datei, welche automatisch angelegt wird, wenn ein Cluster mit Hilfe der kube-up.sh oder erfolgreich ein Cluster mit Minicube erstellt wurde. Standardmäßig liegt die kubectl Konfigurationsdatei unter folgendem Pfad ~/.kube/config.

Um zu überprüfen ob kubectl korrekt konfiguriert ist, kann der Cluster-Status abgefragt werden:

kubectl cluster-info

Wenn als Antwort eine URL ausgegeben wird, ist kubectl korrekt konfiguriert und kann auf das Cluster zugreifen.

Falls eine Nachricht ähnlich wie die Folgende zu sehen ist, ist kubectl nicht korrekt konfiguriert oder nicht in der Lage das Cluster zu erreichen.

The connection to the server <server-name:port> was refused - did you specify the right host or port?

Wenn zum Beispiel versucht wird ein Kubernetes Cluster lokal auf dem Laptop zu starten, muss ein Tool wie zum Beispiel Minikube zuerst installiert werden. Danach können die oben erwähnten Befehle erneut ausgeführt werden.

Falls kubectl cluster-info eine URL zurück gibt, aber nicht auf das Cluster zugreifen kann, prüfe ob kubectl korrekt konfiguriert wurde:

kubectl cluster-info dump
## Optionale kubectl Konfigurationen und Plugins ### Shell Autovervollständigung einbinden kubectl stellt Autovervollständigungen für Bash, Zsh, Fish und Powershell zur Verfügung, mit welchem Kommandozeilenbefehle beschleunigt werden können. Untenstehend ist beschrieben, wie die Autovervollständigungen für Fish und Zsh eingebunden werden.

Hinweis:

Autovervollständigung für Fish benötigt kubectl 1.23 oder neuer.

Das kubectl Autovervollständigungsskript für Fish kann mit folgendem Befehl kubectl completion fish generiert werden. Mit dem Befehl kubectl completion fish | source wird die Autovervollständigung in der aktuellen Sitzung aktiviert.

Um die Autovervollständigung in allen Sitzungen einzurichten, muss folgender Befehl in die ~/.config/fish/config.fish Datei eingetragen werden:

kubectl completion fish | source

Nach dem Neuladen der Shell, sollte die kubectl Autovervollständigung funktionieren.

Das kubectl Autovervollständigungsskript für Zsh kann mit folgendem Befehl kubectl completion zsh generiert werden. Mit dem Befehl kubectl completion zsh | source wird die Autovervollständigung in der aktuellen Sitzung aktiviert.

Um die Autovervollständigung in allen Sitzungen einzurichten, muss folgender Befehl in die ~/.zshrc Datei eingetragen werden:

source <(kubectl completion zsh)

Falls ein Alias für kubectl eingerichtet wurde, funktioniert die kubectl Autovervollständung automatisch.

Nach dem Neuladen der Shell, sollte die kubectl Autovervollständigung funktionieren.

Sollte ein Fehler auftreten wie dieser: 2: command not found: compdef, muss bitte folgendes am Anfang der ~/.zshrc Datei eingefügt werden:

autoload -Uz compinit
compinit
### `kubectl-convert` Plugin installieren

Ein Plugin für das Kubernetes Kommandozeilentool kubectl, welches es ermöglicht Manifeste von einer Version der Kubernetes API zu einer anderen zu konvertieren. Kann zum Beispiel hilfreich sein, Manifeste zu einer nicht als veraltet (deprecated) markierten API Version mit einem neuerem Kubernetes Release zu migrieren. Weitere Infos finden Sich unter: zu nicht veralteten APIs migrieren

1. Neueste Version des Kommandozeilenbefehls herunterladen: 

   curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl-convert"
   

   curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl-convert"
2. Binär-Datei validieren (optional) Download der kubectl-convert Checksum-Datei: 

   curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl-convert.sha256"
   

   curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl-convert.sha256"
Validierung der kubectl-convert Binary mit der Checksum-Datei: ```bash echo "$(cat kubectl-convert.sha256) kubectl-convert" | shasum -a 256 --check ``` Wenn Valide, dann sieht die Ausgabe wie folgt aus: ```console kubectl-convert: OK ``` Falls die Validierung fehlschlägt, beendet sich `shasum` mit einem "nonzero"-Status und gibt einen Fehler aus, welcher so aussehen könnte: ```bash kubectl-convert: FAILED shasum: WARNING: 1 computed checksum did NOT match ```

Hinweis:

  Lade von der kubectl Binary und Checksum-Datei immer die selben Versionen herunter.
3. Kubectl-convert Binary ausführbar machen ```bash chmod +x ./kubectl-convert ``` 4. Kubectl-convert Binary zu einem Ordner in `PATH` Umgebungsvariable verschieben. ```bash sudo mv ./kubectl-convert /usr/local/bin/kubectl-convert sudo chown root: /usr/local/bin/kubectl-convert ```

Hinweis:

Stelle sicher, dass `/usr/local/bin` in der PATH Umgebungsvariable gesetzt ist.
5. Verifizieren, dass das Pluign erfolgreich installiert wurde: ```shell kubectl convert --help ``` Wenn kein Fehler ausgegeben wird, ist das Plugin erfolgreich installiert worden. 6. Nach Installation des Plugins, die Installationsdateien aufräumen: ```bash rm kubectl-convert kubectl-convert.sha256 ``` ## Nächste Schritte