Gerenciar endereços IP de nós

Este documento fornece orientações sobre o número de endereços IP necessários para clusters de administrador e de usuário no Google Distributed Cloud.

DHCP ou estático

Se a rede tiver um servidor DHCP, configure um cluster de administrador ou de usuário para que ele receba do servidor DHCP os endereços IP dos nós de trabalho. No arquivo de configuração do cluster, defina network.ipMode.type como "dhcp".

Se você preferir especificar endereços IP estáticos para um cluster, defina network.ipMode.type como "estático".

De quantos endereços IP um cluster de administrador precisa?

Um cluster de administrador de alta disponibilidade (HA, na sigla em inglês) precisa ter três endereços IP disponíveis para nós do plano de controle.

Um cluster de administrador gerencia um ou mais clusters de usuário. Se o Controlplane V2 estiver ativado para um cluster de usuário, os nós do plano de controle desse cluster serão executados nele. Os clusters de usuário com o Controlplane V2 ativado não afetam o número de endereços IP necessários para um cluster de administrador.

Se o Controlplane V2 não estiver ativado para um cluster de usuário, o plano de controle dele será executado em um ou mais nós no cluster de administrador (kubeception). No caso do kubeception, o cluster de administrador também precisa de endereços IP para:

  • Para cada cluster de usuário de alta disponibilidade, o cluster de administrador precisa de três nós para executar o plano de controle do cluster de usuário.

  • Para cada cluster de usuário que não seja de alta disponibilidade, o cluster de administrador precisa de um nó para executar o plano de controle do cluster de usuário.

    Antes de adicionar um cluster de usuário quando o Controlplane V2 não estiver ativado, verifique se você tem endereços IP suficientes disponíveis para o cluster de administrador para os nós do plano de controle do cluster de usuário. Se você estiver usando o DHCP, verifique se o servidor DHCP é capaz de fornecer os outros endereços IP.

Exemplos:

Descrição Número de endereços IP
Cluster de administrador de alta disponibilidade que gerencia um cluster de usuário do Controlplane V2
Três nós do plano de controle

3
Cluster de administrador de alta disponibilidade que gerencia um cluster de usuário do kubeception de alta disponibilidade
Três nós do plano de controle + três nós do plano de controle do cluster de usuário

6

O cluster do usuário precisa de quantos endereços IP?

  • Se o plano de controle V2 estiver ativado (por padrão), um ou três nós para executar o plano de controle no cluster de usuário:

    • Um nó para um cluster de usuário que não tem alta disponibilidade (HA)

    • Três nós para um cluster de usuário HA

  • Um endereço IP para cada nó de trabalho (nós que executam suas cargas de trabalho)

  • Um endereço IP adicional a ser usado como um nó temporário durante o upgrade, a atualização e o reparo automático.

Antes de adicionar mais nós de trabalho a um cluster de usuário quando o Controlplane V2 estiver ativado, verifique se você tem endereços IP suficientes disponíveis para o cluster de usuário para os nós do plano de controle. Se você estiver usando o DHCP, verifique se o servidor DHCP pode fornecer os endereços IP extras.

Exemplos:

Descrição Número de endereços IP
Cluster de usuário não HA, plano de controle V2
3 nós de worker + 1 nó do plano de controle + 1 nó extra

5
Cluster de usuário de alta disponibilidade, Controlplane V2
3 nós de trabalho + 3 nós de plano de controle + 1 nó extra

7
Cluster de usuário, kubeception
3 nós de trabalho + 1 nó extra

4

Endereços IP estáticos para um cluster de administrador

Esta seção explica como gerenciar endereços IP estáticos para um cluster de administrador.

É preciso especificar três endereços IP para os nós do plano de controle do cluster de administrador. Especifique esses endereços na seção network.controlPlaneIPBlock do arquivo de configuração do cluster de administrador.

Se você pretende criar clusters de usuário do Kubeception, especifique os endereços IP a serem usados para os nós do plano de controle dos clusters de usuário. Especifique esses endereços em um arquivo de bloco de IP. Em seguida, no arquivo de configuração do cluster de administrador, forneça o caminho do arquivo de bloqueio de IP no campo network.ipMode.ipBlockFilePath.

Por exemplo, suponha que você queira criar dois clusters de usuário do Kubeception: um de alta disponibilidade e outro que não é de alta disponibilidade. O cluster de usuário de alta disponibilidade terá três nós do plano de controle no cluster de administrador, e o cluster de usuário que não é de alta disponibilidade terá um nó do plano de controle no cluster de administrador. Por isso, você precisa especificar quatro endereços IP e um extra para usar nas atualizações.

Veja um exemplo de um arquivo de bloco de IP com cinco endereços IP:

blocks:
  - netmask: 255.255.255.0
    gateway: 172.16.20.1
    ips:
    - ip: 172.16.20.50
      hostname: admin-vm-1
    - ip: 172.16.20.51
      hostname: admin-vm-2
    - ip: 172.16.20.52
      hostname: admin-vm-3
    - ip: 172.16.20.53
      hostname: admin-vm-4
    - ip: 172.16.20.54
      hostname: admin-vm-5

Adicionar endereços IP a um cluster de administrador

Para disponibilizar mais endereços IP para nós no cluster de administrador, adicione endereços ao arquivo de bloco de IP e execute o seguinte comando para atualizar o cluster de administrador:

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG--config ADMIN_CLUSTER_CONFIG

Substitua:

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

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

Endereços IP estáticos para um cluster de usuário

Esta seção explica como gerenciar endereços IP estáticos para um cluster de usuário.

Determinar os endereços IP disponíveis para os nós do cluster de usuário

O arquivo de bloco IP do cluster de usuário é listado como o valor de network.ipMode.ipBlockFilePath na configuração do cluster de usuário. No arquivo de bloco de IP, é possível ver os endereços IP disponíveis para nós de trabalho no cluster de usuário.

Por exemplo, veja um arquivo de bloco de IP que tem quatro endereços IP:

blocks:
  - netmask: 255.255.255.0
    gateway: 172.16.20.1
    ips:
    - ip: 172.16.20.55
      hostname: user-vm-1
    - ip: 172.16.20.56
      hostname: user-vm-2
    - ip: 172.16.20.57
      hostname: user-vm-3
    - ip: 172.16.20.58
      hostname: user-vm-4

O arquivo de bloco de IP não contém endereços para os nós do plano de controle do cluster de usuário. Se o cluster de usuário tiver o Controlplane V2 ativado, os endereços IP dos nós do plano de controle vão estar na seção network.controlPlaneIPBlock do arquivo de configuração do cluster de usuário. Caso contrário, os endereços IP dos nós do plano de controle do cluster de usuário estão no arquivo de bloco de IPs do cluster de administrador.

Adicionar endereços IP a um cluster de usuário

Para disponibilizar mais endereços IP para nós no cluster de usuário, adicione endereços ao arquivo de bloco de IP e execute o seguinte comando para atualizar o cluster de usuário:

gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG--config USER_CLUSTER_CONFIG

Substitua:

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

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