Fazer upgrade do Kf no Google Cloud

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 se a versão atual do Kf pode fazer upgrade para o Kf v2.9.0.
Faça upgrade para o Kf v2.9.0.
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.

Prepare-se 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.7.3
  Server version:                   v1.21.6-gke.1500
  kf["app.kubernetes.io/version"]:  v2.7.3
...

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

Se o valor do servidor do Kf for mais antigo do que v2.6.x, faça primeiro um upgrade incremental para o Kf v2.6.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.9.0/operator.yaml"
```

Fazer upgrade de dependências Kf

Fazer upgrade do Tekton:

kubectl apply -f "https://storage.googleapis.com/tekton-releases/pipeline/previous/v0.32.1/release.yaml"

Faça upgrade para o Cloud Service Mesh v1.12:
1. Siga as etapas no guia de upgrade do Cloud Service Mesh.

Fazer upgrade/instalar o Config Connector:

Para fazer upgrade do Kf v2.8: Siga as etapas da etapa "Instalar o Config Connector" em Kf Install

Para fazer upgrade do Kf v2.7:
1. Faça o download do arquivo .tar exigido do operador do Config Connector:
  
  Observação: mantenha uma cópia do pacote de instalação. Ele é necessário para desinstalar o Config Connector.
2. Extraia o arquivo tar:
```
tar zxvf release-bundle.tar.gz
```
3. Instale o operador do Config Connector no cluster.
```
kubectl apply -f operator-system/configconnector-operator.yaml
```

Fazer upgrade para a CLI do Kf v2.7.3

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.9.0/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.9.0/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.9.0/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.9.0/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.9.0
  Server version:                   v1.21.6-gke.1500
  kf["app.kubernetes.io/version"]:  v2.9.0
...
```

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.