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 su cui è in esecuzione Kf. Ciò significa che puoi iniziare a utilizzare i comandi Kf senza dover prima creare il tuo cluster GKE.

Dopo aver installato l'interfaccia a riga di comando Kf e aver eseguito la connessione al cluster Kf, puoi eseguire qualsiasi comando Kf. Per un elenco completo dei comandi Kf disponibili, consulta il riferimento ai comandi Kf.

Prima di iniziare

Prima di poter utilizzare l'interfaccia a riga di comando di Kf, devi avere accesso a un cluster GKE su cui è in esecuzione un'installazione completa di Kf. Ciò significa che hai eseguito il seguente comando 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 la CLI di Kf per tutti gli utenti del sistema. Segui le istruzioni nella scheda Cloud Shell per installarlo solo per te.
```
gcloud storage 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.
```
gcloud storage 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 nell'istanza Cloud Shell. Se utilizzi bash, le istruzioni potrebbero dover essere modificate per altre shell.
```
mkdir -p ~/bin
gcloud storage 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 chiamarla da un punto diverso dalla directory corrente.
```
gcloud storage cp gs://kf-releases/v2.10.0/kf-windows.exe kf.exe
```

Esegui l'upgrade dell'interfaccia a riga di comando

Se hai già installato l'interfaccia a riga di comando Kf, puoi utilizzare la procedura riportata di seguito per eseguire l'upgrade alla versione corrente.

Installa l'interfaccia a riga di comando:
Linux
Questo comando installa la CLI di Kf per tutti gli utenti del sistema. Segui le istruzioni nella scheda Cloud Shell per installarlo solo per te.
```
gcloud storage 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.
```
gcloud storage 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 nell'istanza Cloud Shell. Se utilizzi bash, le istruzioni potrebbero dover essere modificate per altre shell.
```
mkdir -p ~/bin
gcloud storage 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
Verrà scaricato kf nella directory corrente. Aggiungila al percorso se vuoi chiamarla da un punto diverso dalla directory corrente.
```
gcloud storage 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 è indicata in Kf Client.
- La versione del server Kf è indicata in 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
...
```