Instale a CLI Kf

Este documento descreve como instalar a CLI Kf. Normalmente, instala a CLI Kf quando já tem acesso a um cluster do GKE que executa o Kf. Isto significa que pode começar a usar os comandos Kf sem ter de criar primeiro o seu próprio cluster do GKE.

Depois de instalar a CLI Kf e estabelecer ligação ao cluster do Kf, pode executar qualquer um dos comandos do Kf. Consulte o Kf Command Reference para ver uma lista completa dos comandos Kf disponíveis.

Antes de começar

Antes de poder usar a CLI Kf, tem de ter acesso a um cluster do GKE que execute uma instalação completa do Kf. Isto significa que executou o seguinte comando para se ligar ao cluster:

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

Instale a CLI

  1. Instale a CLI Kf:

    Linux

    Este comando instala a CLI do Kf para todos os utilizadores no sistema. Siga as instruções no separador do Cloud Shell para o instalar apenas para si.

    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

    Este comando instala o kf para todos os utilizadores no 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

    Este comando instala o kf na sua instância do Cloud Shell se usar o bash. Caso contrário, pode ter de modificar as instruções para outras shells.

    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

    Este comando transfere kf para o diretório atual. Adicione-o ao caminho se quiser chamá-lo a partir de qualquer outro local que não seja o diretório atual.

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

Atualize a CLI

Se tiver uma instalação existente da CLI do Kf, pode usar o procedimento seguinte para a atualizar para a versão atual:

  1. Instale a CLI:

    Linux

    Este comando instala a CLI do Kf para todos os utilizadores no sistema. Siga as instruções no separador do Cloud Shell para o instalar apenas para si.

    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

    Este comando instala o kf para todos os utilizadores no 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

    Este comando instala o kf na sua instância do Cloud Shell se usar o bash. Caso contrário, pode ter de modificar as instruções para outras shells.

    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

    Esta ação transfere kf para o diretório atual. Adicione-o ao caminho se quiser chamá-lo a partir de qualquer outro local que não seja o diretório atual.

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

  2. Valide se as versões da CLI Kf e do servidor Kf correspondem:

    • A versão da CLI é apresentada em Kf Client.
    • A versão do servidor Kf é apresentada em 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
...