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 il tuo cluster GKE.

Dopo aver installato l'interfaccia a riga di comando Kf e aver eseguito 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 dei 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 hai eseguito il seguente comando per connetterti al cluster:

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

Installare l'interfaccia a riga di comando

  1. 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 installarla solo per te.

    gcloud storage cp gs://kf-releases/v2.6.1/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.6.1/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 di Cloud Shell. Se utilizzi bash, potrebbe essere necessario modificare le istruzioni per altre shell.

    mkdir -p ~/bin
gcloud storage cp gs://kf-releases/v2.6.1/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 directory diversa da quella corrente.

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

Eseguire l'upgrade dell'interfaccia a riga di comando

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 l'interfaccia a riga di comando Kf per tutti gli utenti del sistema. Segui le istruzioni nella scheda Cloud Shell per installarla solo per te.

    gcloud storage cp gs://kf-releases/v2.6.1/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.6.1/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 di Cloud Shell. Se utilizzi bash, potrebbe essere necessario modificare le istruzioni per altre shell.

    mkdir -p ~/bin
gcloud storage cp gs://kf-releases/v2.6.1/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 directory diversa da quella corrente.

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

  2. 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 in Kf Client.
    • La versione del server Kf è elencata in kf["app.kubernetes.io/version"].
    $ kf debug
...
Version:
  Kf Client:                        v2.6.1
  Server version:                   v1.21.3-gke.2001
  kf["app.kubernetes.io/version"]:  v2.6.1
...