Atualizar um cluster

Version 1.11 

• Versão mais recente
• Versão 1.16
• Versões anteriores (sem suporte)

Nesta página, você verá quais configurações podem ser atualizadas no cluster de administrador e nos clusters de usuário.

Normalmente, você altera uma única configuração em um arquivo de configuração e executa o comando gkectl update com os parâmetros apropriados. Para atualizar várias configurações, altere uma configuração de cada vez e execute o comando repetidamente.

O comando gkectl update tem um dos seguintes formulários, junto com os parâmetros apropriados para o recurso que você quer atualizar:

• gkectl update credentials: use para atualizar as credenciais do cluster.

• gkectl update admin: execute este comando depois de fazer uma alteração no arquivo de configuração do cluster de administrador para atualizar o cluster de administrador.

• gkectl update cluster: execute este comando depois de fazer uma alteração no arquivo de configuração do cluster de usuário para atualizar o cluster de usuário.

O que pode e o que não pode ser atualizado nos clusters

Muitos recursos no cluster de administrador e de usuário não podem ser atualizados após a criação do cluster.

Para ver as configurações que podem ser atualizadas no cluster de administrador, execute:

gkectl update admin --help

Para ver quais configurações podem ser atualizadas em um cluster de usuário, execute:

gkectl update cluster --help

Atualizações do cluster de administrador

É possível atualizar vários recursos do cluster de administrador.

Alocar endereços IP estáticos adicionais

Se a configuração usar endereços IP estáticos, verifique quantos você está usando e adicione outros, se necessário, ao fazer upgrade de uma estação de trabalho ou de um cluster de administrador.

Ativar ou desativar o redimensionamento de nós para os nós do plano de controle de um cluster de usuário

É possível ativar ou desativar o redimensionamento automático dos nós do plano de controle para o cluster do usuário. Esses nós estão no cluster de administrador.

Ativar ou desativar o backup do cluster

Para um cluster de administrador, é possível ativar o backup do cluster ou desativar o backup do cluster.

Ativar ou desativar métricas de recursos do vSphere

Se você alterar o valor de stackdriver.disableVsphereResourceMetrics no arquivo de configuração do cluster de administrador, execute este comando para atualizar sua configuração:

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG_FILE

Atualizar a referência de certificado do vCenter para o cluster de administrador

Se o certificado do vCenter tiver sido alterado, atualize a referência do certificado do vCenter. Você precisa atualizar o cluster de administrador e todos os clusters de usuário.

Ativar o redimensionamento automático dos nós de complemento para o cluster de administrador (visualização)

É possível ativar ou desativar o redimensionamento automático dos nós de complemento para o cluster de administrador.

Ativar ou desativar o reparo automático de nós para o cluster de administrador (visualização)

Para ativar ou desativar o reparo automático de nós para o cluster de administrador, altere a configuração apropriada no arquivo de configuração do cluster de administrador e execute o comando gkectl update admin.

• Ativar o reparo de nós e a verificação de integridade em um cluster de administrador atual

• Ativar o reparo de nós e a verificação de integridade em um cluster de administrador atual

Ativar ou desativar grupos antiafinidade (visualização)

Se você alterar o valor de antiAffinityGroups.enabled no arquivo de configuração do cluster de administrador, execute o seguinte comando para atualizar a configuração:

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG_FILE

Substitua:

• ADMIN_CLUSTER_KUBECONFIG: o caminho do arquivo kubeconfig. É possível omitir essa sinalização se o arquivo estiver no diretório atual e tiver o nome kubeconfig;

• ADMIN_CLUSTER_CONFIG_FILE: o caminho do arquivo de configuração do cluster de administrador. É possível omitir essa sinalização se o arquivo estiver no diretório atual e tiver o nome admin-cluster.yaml;

Observação: se você alterar as configurações antiAffinityGroups, isso acionará a recriação dos nós de complemento do cluster de administrador e do cluster de usuário. de plano de controle no cluster de administrador por meio de uma atualização gradual para que as regras de antiafinidade da máquina virtual correspondentes e os rótulos de nó possam ser atualizados de acordo. Esse processo pode causar interrupção temporária nas cargas de trabalho do sistema em execução nesses nós. Tenha cuidado ao fazer alterações desse tipo.

Ativar ou desativar a geração de registros dos Registros de auditoria do Cloud para o cluster de administrador

Para ativar a geração de registros nos Registros de auditoria do Cloud, preencha a seção cloudAuditLogging no arquivo de configuração do cluster de administrador e atualize o cluster.

Para desativar a geração de registros nos Registros de auditoria do Cloud, remova a seção cloudAuditLogging do arquivo de configuração do cluster de administrador e atualize o cluster.

Esta seção será necessária no cluster de administrador se você quiser gerenciar o ciclo de vida dos clusters de usuário no console do Google Cloud.

Para atualizar o cluster:

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG_FILE

Substitua:

• ADMIN_CLUSTER_KUBECONFIG: o caminho do arquivo kubeconfig do cluster de administrador.

• ADMIN_CLUSTER_CONFIG_FILE: o caminho do arquivo de configuração do cluster de administrador.

Ativar ou desativar a geração de registros e o monitoramento para o cluster de administrador

Para ativar o Cloud Logging e o Cloud Monitoring, preencha a seção stackdriver no arquivo de configuração do cluster de administrador e, em seguida, atualize o cluster.

Para desativar o Cloud Logging e o Cloud Monitoring, remova a seção stackdriver do arquivo de configuração do cluster de administrador e atualize o cluster.

Esta seção será necessária no cluster de administrador se você quiser gerenciar o ciclo de vida dos clusters de usuário no console do Google Cloud.

Para atualizar o cluster:

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG_FILE

Substitua:

• ADMIN_CLUSTER_KUBECONFIG: o caminho do arquivo kubeconfig do cluster de administrador.

• ADMIN_CLUSTER_CONFIG_FILE: o caminho do arquivo de configuração do cluster de administrador.

Registrar um cluster de administrador

Ao criar um cluster de administrador pela primeira vez, você pode registrá-lo preenchendo a seção gkeConnect no arquivo de configuração do cluster de administrador antes de criá-lo. Se você não registrou o cluster no momento da criação, é possível registrar um cluster editando o arquivo de configuração para adicionar a seção gkeConnect e executar o comando gkectl update admin.

Esta seção será necessária no cluster de administrador se você quiser gerenciar o ciclo de vida dos clusters de usuário no console do Google Cloud.

Alternar uma chave de conta de serviço connect-register para o cluster de administrador

Para alternar uma chave da conta de serviço connect-register:

1. Crie um novo arquivo de chave da conta de serviço de connect-register.

2. Edite o campo gkeConnect.registerServiceAccountKeyPath no arquivo de configuração do cluster de administrador para apontar para o caminho do novo arquivo de chave.

3. Execute o comando gkectl update admin.

Atualizações de cluster de usuário

Para atualizar os clusters de usuário, edite a configuração no arquivo de configuração do usuário e execute gkectl update cluster com os parâmetros apropriados. Veja as alterações que você pode fazer nos clusters de usuário.

Alocar endereços IP estáticos adicionais

Se a sua configuração usa endereços IP estáticos, você precisa verificar quantos estão usando e adicionar outros, se necessário, ao fazer uma destas alterações:

• Redimensionar um cluster de usuário.

• Criar ou atualizar um pool de nós.

• Fazer upgrade de um cluster de usuários.

Redimensionar um cluster de usuário atualizando as configurações de nodePool

É possível redimensionar um cluster de usuário atualizando o valor replicas na seção nodePools e executando o comando gkectl update cluster.

Ativar ou desativar métricas de recursos do vSphere

É possível ativar ou desativar as métricas de recursos do vSphere no arquivo de configuração do cluster de usuário e, em seguida, executar o comando gkectl update cluster.

Atualizar a referência de certificado do vCenter para clusters de usuários

Se o certificado do vCenter tiver sido alterado, atualize a referência do certificado do vCenter. Você precisa atualizar o cluster de administrador e todos os clusters de usuário.

Registrar um cluster de usuário

Ao criar um cluster, é possível registrá-lo preenchendo a seção gkeConnect no arquivo de configuração do cluster de usuário antes de criá-lo. Se você não registrou o cluster no momento da criação, é possível registrar um cluster de usuário existente editando o arquivo de configuração para adicionar a seção gkeConnect e executar o comando gkectl update cluster.

Ativar ou desativar a geração de registros e o monitoramento para um cluster de usuário (visualização)

Para ativar a geração de registros e o monitoramento, preencha a seção stackdriver no arquivo de configuração do cluster de usuário e, em seguida, atualize o cluster.

Para desativar a geração de registros e o monitoramento, remova a seção stackdriver do arquivo de configuração do cluster de usuário e atualize o cluster.

Para atualizar o cluster:

gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config USER_CLUSTER_CONFIG_FILE

Substitua:

• ADMIN_CLUSTER_KUBECONFIG: o caminho do arquivo kubeconfig do cluster de administrador.

• USER_CLUSTER_CONFIG_FILE: o caminho do arquivo de configuração do cluster de usuário.

Ativar ou desativar o reparo automático de nós para clusters de usuários

Para ativar ou desativar o reparo automático de nós para o usuário, altere a configuração apropriada no arquivo de configuração do cluster de usuário e execute o comando gkectl update cluster.

• Ativar o reparo de nós e a verificação de integridade em um cluster de usuário

• Ativar o reparo de nós e a verificação de integridade em um cluster de usuário

Como redimensionar automaticamente um nó em um cluster de usuário

Para ativar o redimensionamento automático de um nó em um cluster de usuário, edite o arquivo de configuração do cluster e execute o comando gkectl update.

Ativar ou desativar a geração de registros de auditoria na nuvem em um cluster de usuário

É possível ativar o registro de auditoria em nuvem ou desativar o registro de auditoria em nuvem.

Desativar driver CSI do vSphere

Por padrão, o driver CSI do vSphere está ativado. É possível desativar o driver CSI do vSphere.

Alternar uma chave de conta de serviço connect-register para um cluster de usuário

Para alternar uma chave da conta de serviço connect-register:

1. Crie um novo arquivo de chave da conta de serviço de connect-register.

2. Edite o campo gkeConnect.registerServiceAccountKeyPath no arquivo de configuração do cluster de usuário para apontar para o caminho do novo arquivo de chave.

3. Execute o comando gkectl update cluster.

Atualizar a configuração do Windows Server para usar o containerd e o Windows Dataplane V2

Se a configuração incluir um pool de nós de nós do Windows Server, observe que o Docker e o Flannel terão o uso suspenso em uma versão futura. Recomendamos que você atualize seus clusters de usuário agora para usar o containerd e o Windows Dataplane V2.

Antes de iniciar essa atualização, seu vSwitch, especificado por network.vCenter.networkName no arquivo de configuração do cluster de usuário, precisa ter o aprendizado MAC ativado.

Para fazer isso, siga estas etapas:

1. Defina enableWindowsDataplaneV2 como true no arquivo de configuração do cluster de usuário.

   Observação: durante o upgrade do cluster do Flannel para o Windows Dataplane V2, os pods em execução nos nós que usam o Flannel não podem se comunicar com aqueles que estão em execução nos nós recém-criados.

2. Execute o comando gkectl update cluster.

Atualizar configuração do MetalLB

É possível atualizar os pools de endereços do MetalLB no arquivo de configuração do cluster de usuário. Também é possível ativar ou desativar o MetalLB em qualquer pool de nós atualizando o valor enableLoadBalancer na seção nodePools. Faça as alterações aplicáveis no arquivo de configuração e chame gkectl update cluster:

gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONIFG --config USER_CLUSTER_CONFIG

Substitua:

• ADMIN_CLUSTER_KUBECONFIG: o caminho do arquivo kubeconfig do cluster de administrador.

• USER_CLUSTER_CONFIG_FILE: o caminho do arquivo de configuração do cluster de usuário.