Instalar 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. Ou seja, é possível começar a usar comandos do Kf sem precisar criar primeiro seu cluster do GKE.

Depois de instalar a CLI do Kf e se conectar ao cluster do Kf, é possível executar qualquer comando do Kf. Veja uma lista completa dos comandos do Kf disponíveis em Referência de comandos 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. Ou seja, você executou o comando a seguir 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.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 usuários 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

    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.5.4/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.5.4/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.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 usuários 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

    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.5.4/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.5.4/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.5.4
  Server version:                   v1.20.6-gke.1000
  kf["app.kubernetes.io/version"]:  v2.5.4
...