Você está visualizando a documentação de uma versão anterior do GKE On-Prem. Veja a documentação mais recente.

Como configurar IPs estáticos

Nesta página, explicamos como configurar IPs estáticos para uso com clusters do GKE On-Prem.

Visão geral

Durante a instalação, você gera um arquivo de configuração do GKE On-Prem. O arquivo de configuração gerado inclui dois campos ipblockfilepath:

  • admincluster.ipblockfilepath
  • usercluster.ipblockfilepath

O ipblockfilepath aceita o caminho para um arquivo YAML que contém uma configuração hostconfig, descrita abaixo.

Se você quiser usar IPs estáticos, precisará criar dois arquivos YAML na sua estação de trabalho de administrador: um contendo um hostconfig a ser usado pelo cluster de administrador e outro para ser usado pelos clusters de usuário.

Antes de começar

  • Você precisa de um mínimo de N + 4 pares de IP/nome do host na configuração de IP do cluster de administrador, em que N é o número de clusters de usuário que você planeja criar.
  • Opte por criar um cluster de usuário de alta disponibilidade. Um cluster de usuário de alta disponibilidade usa três planos de controle de usuário. Cada VM que executa um plano de controle do usuário requer seu próprio IP estático.

Exemplo

Veja a seguir um exemplo de arquivo hostconfig com três hosts. Seu arquivo pode ter uma aparência diferente dependendo do ambiente. Por exemplo, você pode expandir a matriz ips com mais pares ip/hostname:

hostconfig:
  dns: 8.8.8.8 # IPv4 address of DNS server used by nodes
  tod: 192.138.210.214 # IPv4 address of the NTP server used by the nodes
blocks:
  - netmask: 255.255.252.0
    gateway: 110.116.232.1
    ips:
    - ip: 10.116.232.23
      hostname: host1.enterprise.net  # will be trimmed to host1
    - ip: 10.116.232.65
      hostname: host2.enterprise.net  # will be trimmed to host2
    - ip: 10.116.232.66
      hostname: host3.enterprise.net  # will be trimmed to host3

O arquivo YAML contém duas seções, hostconfig e blocks.

hostconfig

hostconfig contém parâmetros de rede que se aplicam estaticamente a todos os nós do cluster de usuário. hostconfig configura dois valores:

  • dns: endereço IP do servidor DNS a ser usado para nós.
  • tod: endereço IP do servidor de horário.

blocks

blocks contém uma matriz de blocos de endereços IP estáticos. Atualmente, o GKE On-Prem considera apenas o primeiro bloco para alocação de IP. Cada bloco representa uma rede e os respectivos endereços IP dentro dela.

netmask e gateway

netmask e gateway representam a máscara de rede e o gateway padrão a serem usados nos nós.

blocks:
  - netmask: 255.255.252.0
    gateway: 110.116.232.1

ips

Uma matriz ips lista os IPs alocados. Cada objeto na matriz contém um endereço IPv4 e seu nome do host:

blocks:
...
  ips:
  - ip: [IPV4_ADDRESS]
    hostname: [HOSTNAME]
  - ip: [IPV4_ADDRESS]
    hostname: [HOSTNAME]
  - ip: [IPV4_ADDRESS]
    hostname: [HOSTNAME]
...

O GKE On-Prem monitora endereços IP gratuitos e atribuídos dentro desse bloco e aloca um endereço IP disponível para cada nó em um cluster de usuário. Verifique se o número de endereços IP na matriz é estritamente maior que o número de nós no cluster de usuário e se cada endereço IP é exclusivo à rede do ambiente.

hostname, interpretado como o nome do host local sem o domínio. Se você especificar um nome de domínio totalmente qualificado (FQDN), o nome de domínio será cortado. Por exemplo, host1.enterprise.net torna-se host1. Os valores hostname precisam estar em letras minúsculas.

Como criar arquivo hostconfig

Para criar os arquivos hostconfig a partir da estação de trabalho do administrador:

  1. Copie o seguinte modelo para um arquivo YAML:

    hostconfig:
      dns:
      tod:
    blocks:
      - netmask:
        gateway:
        ips:
        - ip:
          hostname:
        - ip:
          hostname:
        - ip:
          hostname:
    
  2. Salve os arquivos por nomes diferentes, como admin-cluster-hostconfig.yaml e user-cluster-hostconfig.yaml.

  3. Durante a instalação, modifique os campos admincluster.ipblockfilepath e usercluster.ipblockfilepath do arquivo de configuração com os arquivos apropriados.

Resolver problemas

Para mais informações, consulte Solução de problemas.