Atualizar um cluster

10

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:

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 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;

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

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.

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 (visualização)

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.

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 (visualização)

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.

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 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.

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 configuração do MetalLB (visualização)

É 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.