Instale a CLI Kf

Este documento descreve como instalar a CLI do 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 do Kf e estabelecer ligação ao cluster do Kf, pode executar qualquer um dos comandos do Kf. Para ver uma lista completa dos comandos Kf disponíveis, consulte a referência de comandos Kf.

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 estabelecer ligação ao cluster:

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

Instale a CLI

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.11.28/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.11.28/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.11.28/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.11.28/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.

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.11.28/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.11.28/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.11.28/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.11.28/kf-windows.exe kf.exe
```

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.11.28
  Server version:                   v1.31.1-gke.2105000
  kf["app.kubernetes.io/version"]:  v2.11.28
...