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 ficar dentro da janela de suporte, recomendamos que você faça upgrade pelo menos a cada nove meses. No entanto, você pode fazer upgrade com mais frequência para ter os recursos e as atualizações de segurança mais recentes.

Fazer upgrade de uma versão sem suporte

Se a 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 depois 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 compatível.
• Faça upgrade diretamente para uma versão aceita. Se não for possível fazer um upgrade gradual, tente fazer upgrade diretamente para uma versão compatível. Por exemplo, se você estiver na versão N-6 (sem suporte), não será possível fazer um upgrade incremental para N-4 (sem suporte). Nesse cenário, tente fazer upgrade diretamente para N-2 (a versão mais antiga compatível).
• Se a versão do Config Sync estiver muito 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.

Observação: se você usar o Config Controller para instalar e gerenciar o Config Sync, não será necessário fazer upgrade manualmente. Como o Config Controller é um serviço gerenciado, o Google o atualiza automaticamente. Para detalhes sobre as mudanças no Config Controller, consulte as notas da versão do serviço.

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

Atenção: o recurso de upgrades automáticos do Config Sync não está disponível a partir da versão 1.21.0. Não é mais possível configurar as configurações de upgrade automático. É necessário fazer upgrade manual da versão do Config Sync. Se você usa upgrades automáticos, primeiro desative-os antes de atualizar o Config Sync manualmente.

Pré-lançamento

Este produto ou recurso está sujeito aos "Termos de ofertas pré-GA" na seção "Termos gerais de serviço" dos Termos específicos de serviço. Os produtos e recursos pré-GA estão disponíveis no estado em que se encontram e podem ter suporte limitado. Para mais informações, consulte as descrições das fases de lançamento.

Desativar upgrades automáticos

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

Importante: não é possível desativar os upgrades automáticos do Config Sync no console Google Cloud . Em vez disso, use as instruções da CLI gcloud ou do Terraform.

gcloud

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

Terraform

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

Importante: não remova o campo configmanagement.management do recurso google_gke_hub_feature_membership. A remoção do campo não desativa os upgrades automáticos do Config Sync, já que o Terraform não consegue detectar a mudança.

Config Connector

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

Importante: não remova o campo configmanagement.management do recurso GKEHubFeatureMembership. A remoção do campo não desativa os upgrades automáticos do Config Sync e faz com que os campos sejam gerenciados externamente em vez de pelo Config Connector.