Installa l'interfaccia a riga di comando Kf

Questo documento descrive come installare l'interfaccia a riga di comando Kf. In genere, l'interfaccia a riga di comando Kf viene installata 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 effettuato la connessione al cluster Kf, puoi eseguire uno qualsiasi dei comandi Kf. Per un elenco completo dei comandi Kf disponibili, consulta la documentazione di riferimento per i 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 Kf completa. Ciò significa che devi eseguire il comando seguente per connetterti al cluster:

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 nel sistema. Segui le istruzioni nella scheda Cloud Shell per installarla in modo autonomo.
```
gsutil cp gs://kf-releases/v2.11.21/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.11.21/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.11.21/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 attuale. Aggiungila al percorso se vuoi effettuare chiamate da qualsiasi posizione diversa dalla directory corrente.
```
gsutil cp gs://kf-releases/v2.11.21/kf-windows.exe kf.exe
```

Esegui l'upgrade dell'interfaccia a riga di comando

Se disponi già di un'installazione dell'interfaccia a riga di comando Kf, puoi utilizzare la seguente procedura per eseguire 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 nel sistema. Segui le istruzioni nella scheda Cloud Shell per installarla in modo autonomo.
```
gsutil cp gs://kf-releases/v2.11.21/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.11.21/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.11.21/kf-linux ~/bin/kf
chmod a+x ~/bin/kf
echo "export PATH=$HOME/bin:$PATH" >> ~/.bashrc
source ~/.bashrc
```
Windows
Verrà scaricato kf nella directory attuale. Aggiungila al percorso se vuoi effettuare chiamate da qualsiasi posizione diversa dalla directory corrente.
```
gsutil cp gs://kf-releases/v2.11.21/kf-windows.exe kf.exe
```
Convalida la corrispondenza delle versioni dell'interfaccia a riga di comando Kf e del server Kf:
- 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.11.21
  Server version:                   v1.21.6-gke.1500
  kf["app.kubernetes.io/version"]:  v2.11.21
...
```