Installa l'interfaccia a riga di comando Kf

Questo documento descrive come installare l'interfaccia a riga di comando Kf. In genere installi l'interfaccia a riga di comando Kf quando hai già accesso a un cluster GKE che esegue Kf. Ciò significa che puoi iniziare a utilizzare i comandi Kf senza dover prima creare un tuo cluster GKE.

Dopo aver installato l'interfaccia a riga di comando Kf e aver connesso al cluster Kf, puoi eseguire uno qualsiasi dei comandi Kf. Per un elenco completo dei comandi Kf disponibili, consulta la documentazione di riferimento sui comandi Kf.

Prima di iniziare

Prima di poter utilizzare l'interfaccia a riga di comando Kf, devi avere accesso a un cluster GKE che esegue un'installazione completa di Kf. Ciò significa che per connetterti al cluster hai eseguito questo comando:

gcloud container clusters get-credentials CLUSTER_NAME \
    --project=CLUSTER_PROJECT_ID \
    --zone=CLUSTER_LOCATION

Installa l'interfaccia a riga di comando

Installa l'interfaccia a riga di comando Kf:
Linux
Questo comando installa l'interfaccia a riga di comando Kf per tutti gli utenti del sistema. Segui le istruzioni nella scheda Cloud Shell per installarlo autonomamente.
```
gsutil cp gs://kf-releases/v2.10.0/kf-linux /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf
```
Mac
Questo comando installa kf per tutti gli utenti del sistema.
```
gsutil cp gs://kf-releases/v2.10.0/kf-darwin /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf
```
Cloud Shell
Questo comando installa kf sulla tua istanza di Cloud Shell se utilizzi bash. Potrebbe essere necessario modificare le istruzioni per altre shell.
```
mkdir -p ~/bin
gsutil cp gs://kf-releases/v2.10.0/kf-linux ~/bin/kf
chmod a+x ~/bin/kf
echo "export PATH=$HOME/bin:$PATH" >> ~/.bashrc
source ~/.bashrc
```
Windows
Questo comando scarica kf nella directory corrente. Aggiungila al percorso se vuoi effettuare una chiamata da qualsiasi posizione diversa dalla directory attuale.
```
gsutil cp gs://kf-releases/v2.10.0/kf-windows.exe kf.exe
```

Esegui l'upgrade dell'interfaccia a riga di comando

Se hai già un'installazione dell'interfaccia a riga di comando Kf, puoi utilizzare la seguente procedura per eseguirne l'upgrade alla versione attuale.

Installa l'interfaccia a riga di comando:
Linux
Questo comando installa l'interfaccia a riga di comando Kf per tutti gli utenti del sistema. Segui le istruzioni nella scheda Cloud Shell per installarlo autonomamente.
```
gsutil cp gs://kf-releases/v2.10.0/kf-linux /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf
```
Mac
Questo comando installa kf per tutti gli utenti del sistema.
```
gsutil cp gs://kf-releases/v2.10.0/kf-darwin /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf
```
Cloud Shell
Questo comando installa kf sulla tua istanza di Cloud Shell se utilizzi bash. Potrebbe essere necessario modificare le istruzioni per altre shell.
```
mkdir -p ~/bin
gsutil cp gs://kf-releases/v2.10.0/kf-linux ~/bin/kf
chmod a+x ~/bin/kf
echo "export PATH=$HOME/bin:$PATH" >> ~/.bashrc
source ~/.bashrc
```
Windows
Questa operazione scarica kf nella directory corrente. Aggiungila al percorso se vuoi effettuare una chiamata da qualsiasi posizione diversa dalla directory attuale.
```
gsutil cp gs://kf-releases/v2.10.0/kf-windows.exe kf.exe
```
Verifica che le versioni dell'interfaccia a riga di comando Kf e del server Kf corrispondano:
- La versione dell'interfaccia a riga di comando è elencata sotto Kf Client.
- La versione del server Kf è indicata sotto kf["app.kubernetes.io/version"].
```
$ kf debug
...
Version:
  Kf Client:                        v2.10.0
  Server version:                   v1.21.6-gke.1500
  kf["app.kubernetes.io/version"]:  v2.10.0
...
```