Instale 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. Para uma lista completa dos comandos Kf disponíveis, consulte a referência do comando 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.11.27/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.11.27/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.11.27/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.11.27/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.11.27/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.11.27/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.11.27/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.11.27/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.11.27
  Server version:                   v1.31.1-gke.2105000
  kf["app.kubernetes.io/version"]:  v2.11.27
...
```