Fazer upgrade do Config Sync

Nesta página, explicamos como fazer upgrade da versão do Config Sync instalada nos clusters.

Fazer upgrade manual do Config Sync

Para permanecer na janela de suporte, recomendamos que você faça upgrade pelo menos a cada nove meses. No entanto, é possível fazer upgrade com mais frequência para receber os recursos e as atualizações de segurança mais recentes.

Fazer upgrade de uma versão sem suporte

Se a sua versão do Config Sync não tiver suporte, tente fazer upgrade usando uma das seguintes opções:

  • (Recomendado) Faça um upgrade passo a passo com incrementos de, no máximo, duas versões secundárias por vez. Por exemplo, se você estiver na versão N-4 (uma versão sem suporte), faça upgrade para N-2 (uma versão com suporte) e em seguida para N (uma versão com suporte). Essa abordagem é o método mais seguro para fazer upgrade, mas só funciona se o primeiro upgrade incremental for para uma versão com suporte.
  • Faça upgrade diretamente para uma versão com suporte. Se não for possível fazer um upgrade por etapas, tente fazer upgrade diretamente para uma versão com suporte. Por exemplo, se você estiver na versão N-6 (uma versão sem suporte), a tentativa de fazer um upgrade incremental para a N-4 (uma versão sem suporte) não vai funcionar. Nesse cenário, tente fazer upgrade diretamente para N-2 (a versão com suporte mais antiga).
  • Se a versão do Config Sync estiver significativamente desatualizada e as opções anteriores não funcionarem, desinstale e reinstale o Config Sync.

Fazer upgrade do Config Sync

Antes de fazer upgrade do Config Sync, consulte as notas da versão para detalhes sobre o que foi alterado entre as versões.

Para fazer upgrade do Config Sync, siga estas etapas:

Console

  1. No console Google Cloud , acesse a página Configuração na seção Recursos.

    Acessar a configuração

  2. Na guia Configurações, ao lado do cluster com a versão do Config Sync que você quer atualizar, selecione Editar configuração do cluster.
  3. Na lista suspensa Versão, selecione a versão em que você quer fazer upgrade.
  4. Clique em Fazer upgrade do Config Sync.

gcloud

  1. (Opcional) Se você quiser verificar qual versão do Config Sync está instalada nos clusters antes do upgrade, execute o seguinte comando:

    gcloud beta container fleet config-management version
    
  2. Execute este comando:

    gcloud beta container fleet config-management upgrade \
        --version=VERSION \
        --membership=MEMBERSHIP_NAME
    

    Substitua:

    • VERSION: a versão para a qual você quer fazer upgrade
    • MEMBERSHIP_NAME: o nome da assinatura da frota que você escolheu quando registrou o cluster. Para encontrar o nome da assinatura, execute gcloud container fleet memberships list.

Fazer upgrade automático do Config Sync

Desativar upgrades automáticos

Para desativar os upgrades automáticos do Config Sync, siga estas etapas:

gcloud

Remova o campo upgrades do arquivo apply spec da Google Cloud CLI.

Terraform

Defina o campo configmanagement.management como MANAGEMENT_MANUAL no recurso google_gke_hub_feature_membership.

Config Connector

Defina o campo configmanagement.management como MANAGEMENT_MANUAL no recurso GKEHubFeatureMembership.