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 que a versão atual do Kf pode fazer upgrade para o Kf v2.6.1.
  • Faça upgrade para o Kf v2.6.1.
  • 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.5.4
  Server version:                   v1.21.3-gke.2001
  kf["app.kubernetes.io/version"]:  v2.5.4
...

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

Se o valor do servidor do Kf for mais antigo do que v2.5.x, faça primeiro um upgrade incremental para o Kf v2.5.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ê.

  1. Aplique o yaml do operador:

    kubectl apply -f "https://storage.googleapis.com/kf-releases/v2.6.1/operator.yaml"

Fazer upgrade de dependências Kf

  1. Fazer upgrade do Tekton:

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

  2. 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.
  1. Faça upgrade do Config Connector.

    1. Faça o download do arquivo .tar exigido do operador do 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.6.1

  1. 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.6.1/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.6.1/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.6.1/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.6.1/kf-windows.exe kf.exe
  2. 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.6.1
      Server version:                   v1.21.3-gke.2001
      kf["app.kubernetes.io/version"]:  v2.6.1
    ...
    

Verificar se o Kf foi atualizado

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