Atualize o Config Sync

Esta página explica como atualizar a versão do Config Sync instalada nos seus clusters.

Atualize manualmente o Config Sync

Para permanecer dentro da janela de apoio técnico, recomendamos que faça a atualização, pelo menos, a cada nove meses. No entanto, pode atualizar com mais frequência para receber as funcionalidades e as atualizações de segurança mais recentes.

Atualize a partir de uma versão não suportada

Se a sua versão do Config Sync não for suportada, pode tentar atualizá-la através de uma das seguintes opções:

• (Recomendado) Faça uma atualização passo a passo com incrementos de, no máximo, duas versões secundárias de cada vez. Por exemplo, se estiver na versão N-4 (uma versão não suportada), deve atualizar para a versão N-2 (uma versão suportada) e, em seguida, pode atualizar para a versão N (uma versão suportada). Esta abordagem é o método mais seguro para atualizar, mas só funciona se a primeira atualização incremental for para uma versão suportada.
• Atualize diretamente para uma versão suportada. Se não conseguir fazer uma atualização passo a passo, pode tentar atualizar diretamente para uma versão suportada. Por exemplo, se estiver na versão N-6 (uma versão não suportada), tentar fazer uma atualização incremental para N-4 (uma versão não suportada) não funciona. Neste cenário, pode tentar atualizar diretamente para a versão N-2 (a versão suportada mais antiga).
• Se a versão do Config Sync estiver significativamente desatualizada e as opções anteriores não funcionarem, pode desinstalar e reinstalar o Config Sync.

Atualize o Config Sync

Antes de atualizar o Config Sync, consulte as notas de lançamento para ver detalhes sobre o que mudou entre as versões.

Nota: se usar o Config Controller para instalar e gerir o Config Sync, não precisa de fazer a atualização manualmente. O Config Controller é um serviço gerido, pelo que a Google o atualiza automaticamente. Para ver detalhes sobre as alterações do Config Controller, consulte as notas de lançamento do Config Controller.

Para atualizar o Config Sync, conclua os passos seguintes:

consola

1. Na Google Cloud consola, aceda à página Configuração na secção Funcionalidades.

   Aceda à configuração

2. No separador Definições, junto ao cluster cuja versão do Config Sync quer atualizar, selecione Editar configuração do cluster.
3. Na lista pendente Versão, selecione a versão para a qual quer fazer a atualização.
4. Clique em Atualizar sincronização de configuração.

gcloud

1. (Opcional) Se quiser verificar que versão do Config Sync está instalada nos seus clusters antes de fazer a atualização, execute o seguinte comando:

   gcloud beta container fleet config-management version
   

2. Execute o seguinte comando:

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

   Substitua o seguinte:

   • VERSION: a versão para a qual quer atualizar.
   • MEMBERSHIP_NAME: o nome do membro da frota que escolheu quando registou o cluster. Pode encontrar o nome da subscrição executando o comando gcloud container fleet memberships list.

Atualize automaticamente o Config Sync

Aviso: a funcionalidade de atualização automática do Config Sync está indisponível a partir da versão 1.21.0 do Config Sync. Já não pode configurar as definições de atualização automática e tem de atualizar manualmente a versão do Config Sync. Se usar atualmente atualizações automáticas, tem primeiro de desativar as atualizações automáticas antes de poder atualizar manualmente o Config Sync.

Pré-visualização

Este produto ou funcionalidade está sujeito aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. Os produtos e as funcionalidades pré-GA estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

Desative as atualizações automáticas

Para desativar as atualizações automáticas do Config Sync, conclua os seguintes passos:

Importante: não pode desativar as atualizações automáticas do Config Sync através da Google Cloud consola. Em alternativa, use as instruções da CLI gcloud ou do Terraform.

gcloud

Remova o campo upgrades do ficheiro CLI do Google Cloudapply spec.

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 as atualizações automáticas do Config Sync, uma vez que o Terraform não consegue detetar a alteração.

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 as atualizações automáticas do Config Sync e faz com que os campos sejam geridos externamente em vez de geridos pelo Config Connector.