Instale a CLI do Kf:

Este documento descreve como instalar a CLI do Kf. Normalmente, a CLI do Kf é instalada quando você já tem acesso a um cluster do GKE que executa o Kf. Isso significa que você pode começar a usar comandos do Kf sem precisar criar primeiro o próprio cluster do GKE.

Depois de instalar a CLI do Kf e se conectar ao cluster do Kf, você já pode executar qualquer comando do Kf. Confira uma lista completa dos comandos do Kf disponíveis na referência de comando do Kf.

Antes de começar

Antes de usar a CLI do Kf, você precisa ter acesso a um cluster do GKE que esteja executando uma instalação completa do Kf. Isso significa que você executou o seguinte comando para se conectar ao cluster:

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

Instalar a CLI

  1. Instale a CLI do Kf:

    Linux

    Este comando instala a CLI do Kf para todos os usuários no sistema. Siga as instruções na guia do Cloud Shell para instalá-lo só para você.

    gcloud storage cp gs://kf-releases/v2.9.0/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 usuários no sistema.

    gcloud storage cp gs://kf-releases/v2.9.0/kf-darwin /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf

    Cloud Shell

    O comando vai instalar o kf na instância do Cloud Shell se você usar bash. Talvez seja necessário mudar as instruções para outros shells.

    mkdir -p ~/bin
gcloud storage cp gs://kf-releases/v2.9.0/kf-linux ~/bin/kf
chmod a+x ~/bin/kf
echo "export PATH=$HOME/bin:$PATH" >> ~/.bashrc
source ~/.bashrc

    Windows

    Este comando baixa o kf para o diretório atual. Adicione o arquivo ao caminho se você quiser chamá-lo de outro local que não seja o diretório atual.

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

Fazer upgrade da CLI

Se você já tiver uma instalação da CLI do Kf, use o procedimento a seguir para fazer upgrade dela para a versão atual.

  1. Instale a CLI:

    Linux

    Este comando instala a CLI do Kf para todos os usuários no sistema. Siga as instruções na guia do Cloud Shell para instalá-lo só para você.

    gcloud storage cp gs://kf-releases/v2.9.0/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 usuários no sistema.

    gcloud storage cp gs://kf-releases/v2.9.0/kf-darwin /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf

    Cloud Shell

    O comando vai instalar o kf na instância do Cloud Shell se você usar bash. Talvez seja necessário mudar as instruções para outros shells.

    mkdir -p ~/bin
gcloud storage cp gs://kf-releases/v2.9.0/kf-linux ~/bin/kf
chmod a+x ~/bin/kf
echo "export PATH=$HOME/bin:$PATH" >> ~/.bashrc
source ~/.bashrc

    Windows

    Este comando faz o download de kf no diretório atual. Adicione o arquivo ao caminho se você quiser chamá-lo de outro local que não seja o diretório atual.

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

  2. Verifique se a CLI do Kf e o servidor Kf têm a mesma versão:

    • A versão da CLI aparece em Kf Client.
    • A versão do servidor Kf aparece em kf["app.kubernetes.io/version"].
    $ kf debug
...
Version:
  Kf Client:                        v2.9.0
  Server version:                   v1.21.6-gke.1500
  kf["app.kubernetes.io/version"]:  v2.9.0
...