Atualizar o Kf

Este documento descreve como atualizar uma instalação atual do Kf e as dependências dela.

Como parte do procedimento de upgrade, você garante que a instalação do Kf use a versão mais recente do operador Kf:

Confirme que a versão atual do Kf pode fazer upgrade para o Kf v2.5.4.
Faça upgrade para o Kf v2.5.4.
Faça upgrade das dependências (se necessário).

Antes de começar

Você precisará dos seguintes itens:

Um cluster atual com o Kf instalado.
Acesso a uma máquina com gcloud, kf e kubectl instalados.

Como se preparar para o upgrade

Conectar-se ao cluster de destino

gcloud container clusters get-credentials CLUSTER_NAME \
 --zone CLUSTER_ZONE \
 --project CLUSTER_PROJECT_ID

Confirmar se a CLI atual do Kf e as versões do servidor correspondem

Execute kf debug e valide a CLI do Kf e as versões do servidor Kf correspondentes.

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

Se os valores do cliente e do servidor do Kf não corresponderem, mas a versão do servidor for v2.4.x, instale a CLI do Kf v2.5.4 antes de continuar.

Se o valor do servidor do Kf for mais antigo do que v2.4.x, faça primeiro um upgrade incremental para o Kf v2.4.x antes de continuar.

Confirmar se o Kf está normal antes de fazer upgrade

Execute kf doctor para verificar o estado do cluster. Todos os testes devem ser aprovados antes de continuar.

$ kf doctor
...
=== RUN doctor/user
=== RUN doctor/user/ContainerRegistry
--- PASS: doctor/user
   --- PASS: doctor/user/ContainerRegistry
...

Se você encontrar alguma mensagem de erro FAIL ou Error: environment failed checks, siga as orientações na saída kf doctor ou veja o guia de solução de problemas para tentar o comando novamente até ele ser bem-sucedido.

Fazer upgrade do operador

O operador Kf executa upgrades para você.

Aplique o yaml do operador:

Observação: esta operação começa imediatamente, e não é reversível.
```
kubectl apply -f "https://storage.googleapis.com/kf-releases/v2.5.4/operator.yaml"
```

Fazer upgrade de dependências Kf

Fazer upgrade do Tekton:

Observação: o Kf v2.5.4 usa o mesmo Tekton v0.23.0 do Kf v2.4.1. Portanto, não é necessário fazer upgrade.
Faça upgrade para a versão mais recente do Cloud Service Mesh:
1. Siga as etapas no guia de upgrade do Cloud Service Mesh.
Faça upgrade do Config Connector.

Observação: o Kf v2.5.4 usa o mesmo Config Connector v1.46.0 que o Kf v2.4.1. Portanto, não é necessário fazer upgrade.

Fazer upgrade para a CLI do Kf v2.5.4

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
...
```

Verificar se o Kf foi atualizado

Execute doctor para garantir a integridade da versão recém-instalada:
```
kf doctor --retries=20
```
O comando executa verificações de cluster várias vezes. É normal que algumas tentativas falhem enquanto os novos controladores são iniciados.

Se o comando falhar com a mensagem Error: environment failed checks, siga as orientações na saída doctor para resolver o problema e repita o comando até que a operação seja bem-sucedida.

Se as etapas de verificação forem aprovadas, o cluster foi atualizado. Se você tiver problemas, consulte a página de suporte para orientações.