Fazer upgrade do Config Sync

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

Fazer upgrade automático do Config Sync

É possível configurar o Config Sync para fazer upgrade automático para versões mais recentes nos clusters do GKE no Google Cloud.

Ativar os upgrades automáticos para o Config Sync ajuda a simplificar a experiência de gerenciamento. O Google assume a responsabilidade de fazer upgrade automático das versões do Config Sync e supervisionar o ciclo de vida dos componentes. A ativação dos upgrades automáticos oferece os seguintes benefícios:

  • Menor sobrecarga de manutenção: evite monitorar versões mais recentes do Config Sync e fazer upgrade manual do Config Sync nos clusters.
  • Permaneça nas versões com suporte: o Google mantém a versão compatível mais recente nos seus clusters, garantindo que você não esteja usando uma versão sem suporte do Config Sync.
  • Maior confiabilidade: o Google gerencia os componentes do Config Sync e reconcilia os componentes em caso de alterações.

Versões do Config Sync e canais de lançamento do GKE

O Config Sync escolhe a versão a ser atualizada com base no canal de lançamento do cluster do Google Kubernetes Engine. Um cluster que não usa um canal de lançamento do GKE é tratado como um cluster que usa o canal de lançamento estável do GKE.

É possível usar upgrades automáticos para garantir que o Config Sync seja atualizado nos clusters automaticamente. Quando uma nova versão do Config Sync está disponível em um canal de lançamento, o Config Sync faz upgrade da versão do Config Sync que corresponde ao canal de lançamento do cluster. O canal rápido oferece a versão mais recente do Config Sync assim que estiver disponível. O canal "Regular" oferece a versão mais recente do Config Sync em breve. O Canal Stable oferece a versão mais recente do Config Sync somente depois de ser validado nos canais rápido e normal.

Para mais informações sobre canais de lançamento, consulte Sobre canais de lançamento.

A tabela a seguir mostra a versão atual do Config Sync disponível em cada canal de lançamento:

Canal de lançamento

Versão do Config Sync

Rápido

1.18

Normal

1.17

Estável (ou sem canal)

1.16

Ativar upgrades automáticos

Ative os upgrades automáticos para garantir que o Config Sync seja atualizado nos clusters automaticamente em toda a frota.

Só é possível ativar upgrades automáticos nos clusters do GKE no Google Cloud com o GKE Enterprise ativado.

Para instalar o Config Sync e ativar upgrades automáticos, siga as instruções em Instalar o Config Sync.

Para ativar upgrades automáticos em um cluster que já tenha o Config Sync instalado, siga as seguintes etapas:

  1. Confirme se o cluster do GKE está registrado em um canal de lançamento. Se o cluster do GKE não estiver inscrito em um canal de lançamento, o Config Sync vai fazer upgrade automático como se o cluster estivesse usando o canal de lançamento Stable do GKE.
  2. Se você ainda não configurou o Config Sync para enviar métricas ao Cloud Monitoring, conceda permissões de gravação de métricas. Isso é necessário para upgrades automáticos.
  3. Verifique se o Config Sync está em uma versão compatível:

    Console

    1. No console do 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 para o qual você quer fazer upgrade, clique em 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 de fazer upgrade, execute o seguinte comando:

      gcloud beta container fleet config-management
      
    2. Para fazer upgrade do Config Sync, execute o seguinte 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.
  4. Ative os upgrades automáticos do Config Sync: =

    Console

    Ativar upgrades automáticos em clusters individuais

    Para ativar upgrades automáticos em clusters individuais, conclua as etapas a seguir:

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

      Acessar a configuração

    2. Clique em Configurações do Config Sync.
    3. Selecione Editar configuração do cluster para o cluster que você quer atualizar.
    4. No painel de configurações exibido, selecione Upgrades automáticos.
    5. Clique em Alterar configurações do Config Sync. Na guia Configurações, após alguns minutos, será exibido Sim na coluna Upgrades automáticos do cluster. que você selecionou.

    Ativar os upgrades automáticos como padrão da frota

    Para ativar upgrades automáticos em toda a frota de clusters, siga estas etapas:

    1. No console do Google Cloud, acesse a página Gerenciador de recursos.

      Acessar o gerenciador de recursos

    2. No painel Config Sync, clique em Configurar.

    3. Para mudar as configurações padrão, clique em Personalizar configurações da frota.

    4. Na caixa de diálogo exibida, selecione Upgrades automáticos.

    5. Clique em Salvar.

    6. Opcional: sincronize os clusters atuais com as configurações padrão:

      1. Acesse a página Gerenciador de recursos.

        Acessar o gerenciador de recursos

      2. No painel Config Sync, clique em View details.

      3. Na lista Clusters na frota, selecione os clusters que você quer sincronizar.

      4. Clique em Sincronizar com as configurações da frota e em Confirmar na caixa de diálogo de confirmação mostrada. Esta operação leva alguns minutos para ser concluída.

    gcloud

    Para ativar upgrades automáticos em um cluster individual, siga estas etapas:

    1. Faça o update da Google Cloud CLI para a versão mais recente.

      gcloud components update
      
    2. Atualize o arquivo apply spec atual do Config Sync para incluir o campo upgrades: auto, por exemplo:

      applySpecVersion: 1
      spec:
        upgrades: auto
        configSync:
          enabled: true
      # other fields intentionally omitted
      
    3. Aplique o arquivo apply-spec.yaml atualizado:

      gcloud beta container fleet config-management apply \
          --membership=MEMBERSHIP_NAME \
          --config=CONFIG_YAML_PATH \
          --project=PROJECT_ID
      

      Substitua:

      • MEMBERSHIP_NAME: o nome da assinatura da frota escolhida ao registrar o cluster. É possível encontrar o nome com gcloud container fleet memberships list.
      • CONFIG_YAML_PATH: o caminho para o arquivo apply-spec.yaml.
      • PROJECT_ID: o ID do projeto.
    4. Confirme se o upgrade automático está ativado:

      gcloud beta container fleet config-management status \
        --project=PROJECT_ID
      

      Substitua PROJECT_ID pelo ID do projeto.

      A coluna Upgrades exibe "auto" para clusters com upgrades automáticos ativados. Se ocorrer um erro ao ativar os upgrades automáticos, a coluna Status exibirá ERROR com uma mensagem de erro detalhada.

Mudar o canal de lançamento

Para informações sobre como alterar o canal de lançamento do cluster, consulte Alterar o canal de lançamento do cluster na documentação do GKE. Se os upgrades automáticos do Config Sync estiverem ativados, considere o seguinte ao alterar seu canal de lançamento:

  • Se você mudar o canal de lançamento para um menos estável (por exemplo, de estável para rápido), o Config Sync vai fazer upgrade automático da versão mais recente com suporte no canal de lançamento original para a versão mais recente. compatível com o novo canal de lançamento.
  • Se você mudar o canal de lançamento para um mais estável (por exemplo, de rápido para estável), o Config Sync não vai fazer downgrade das versões. Com o tempo, a versão mais recente compatível com o canal de lançamento original será promovida para o novo canal. À medida que as versões mais recentes forem disponibilizadas no novo canal de lançamento, o Config Sync fará upgrade automático normalmente.
  • Se você cancelar a inscrição em um canal de lançamento, isso não vai afetar os upgrades automáticos do Config Sync. A versão do Config Sync será atualizada como se o cluster fosse inscrito no canal de lançamento Stable.

Fazer upgrade manual 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. Se você precisar fazer upgrade de uma versão não compatível do Config Sync, faça um upgrade passo a passo com incrementos para, no máximo, três versões secundárias por vez. Por exemplo, se a versão atual do Config Sync for 1.10.0, faça upgrade para a versão 1.13.0 e depois para a versão 1.16.0.

Para fazer upgrade do Config Sync, siga estas etapas:

Console

  1. No console do 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.