Instalar a CLI do Kf

Este documento explica como instalar a CLI do Kf. Normalmente, a CLI é 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 seu próprio cluster do GKE.

Depois de instalar a CLI do Kf e se conectar ao cluster do Kf, você já pode 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. 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

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 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
Este comando instala kf na instância do Cloud Shell se você usar bash. Talvez as instruções precisem ser modificadas 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 para o diretório atual. Adicione-o ao caminho se você quiser chamar de outro local que não seja 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 seguinte procedimento para atualizá-la para a versão atual:

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 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
Este comando instala kf na instância do Cloud Shell se você usar bash. Talvez as instruções precisem ser modificadas 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 ao caminho se você quiser chamar de outro local que não seja diretório atual.
```
gcloud storage cp gs://kf-releases/v2.5.4/kf-windows.exe kf.exe
```
Valide a correspondência entre as versões da CLI e do servidor do Kf:
- A versão da CLI está listada em Kf Client.
- A versão do servidor Kf está listada 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
...
```