Installazione dell'interfaccia a riga di comando Kf

Questo documento descrive come installare l'interfaccia a riga di comando Kf. In genere, l'installazione di Kf CLI viene eseguita 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 il tuo cluster GKE.

Dopo aver installato Kf CLI e aver eseguito la connessione al cluster Kf, puoi eseguire qualsiasi comando Kf. Consulta Kf Command Reference per un elenco completo dei comandi Kf disponibili.

Prima di iniziare

Prima di poter utilizzare la CLI di Kf, devi avere accesso a un cluster GKE che esegue 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 la CLI

  1. Installa l'interfaccia a riga di comando Kf:

    Linux

    Questo comando installa la CLI 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.5.4/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.5.4/kf-darwin /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf

    Cloud Shell

    Questo comando installa kf sull'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.5.4/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. Aggiungilo al percorso se vuoi chiamarlo da una posizione diversa dalla directory corrente.

    gcloud storage cp gs://kf-releases/v2.5.4/kf-windows.exe kf.exe

Esegui l'upgrade della CLI

Se hai già installato l'interfaccia a riga di comando Kf, puoi utilizzare la seguente procedura per eseguire l'upgrade alla versione attuale:

  1. Installa l'interfaccia a riga di comando:

    Linux

    Questo comando installa la CLI 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.5.4/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.5.4/kf-darwin /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf

    Cloud Shell

    Questo comando installa kf sull'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.5.4/kf-linux ~/bin/kf
chmod a+x ~/bin/kf
echo "export PATH=$HOME/bin:$PATH" >> ~/.bashrc
source ~/.bashrc

    Windows

    Viene scaricato kf nella directory corrente. Aggiungilo al percorso se vuoi chiamarlo da una posizione diversa dalla directory corrente.

    gcloud storage cp gs://kf-releases/v2.5.4/kf-windows.exe kf.exe

  2. Convalida che le versioni dell'interfaccia a riga di comando Kf e del server Kf corrispondano:

    • La versione della CLI è elencata in Kf Client.
    • La versione del server Kf è elencata in kf["app.kubernetes.io/version"].
    $ kf debug
...
Version:
  Kf Client:                        v2.5.4
  Server version:                   v1.20.6-gke.1000
  kf["app.kubernetes.io/version"]:  v2.5.4
...