Configurar o balanceador de carga

Selecione uma versão da documentação:

É possível configurar um balanceador de carga para o AlloyDB Omni usando o orquestrador de RPM.

Limitações

Considere as seguintes limitações:

  • O endpoint é limitado ao ReadWrite. Os endpoints somente leitura serão aceitos no futuro.

Antes de começar

Antes de configurar o balanceador de carga, verifique se você atende aos seguintes requisitos:

  • Para definir nós do balanceador de carga, no arquivo de especificação da implantação, inclua um grupo load_balancer_nodes que contenha os nomes de host ou endereços IP das VMs dedicadas do balanceador de carga:

    alloydbomni:
      vars:
        ...
      children:
        load_balancer_nodes:
          hosts:
            lb-node-1:
            lb-node-2:
    
  • Para configurar o firewall, permita o seguinte tráfego de entrada:

    • Em VMs dedicadas do balanceador de carga:

      • Porta 5432 (TCP): para tráfego de banco de dados HAProxy.

      • Porta 6432 (TCP): para tráfego de pool de conexões PgBouncer, se aplicável.

      • Protocolo VRRP: para eleição de líder keepalived e verificações de integridade.

    • Em nós de banco de dados:

      • Porta 8086 (HTTP): para verificações de integridade do balanceador de carga.
  • Se você estiver usando o Google Cloud ambiente, defina ENVIRONMENT_TYPE como gcp. Em seguida, autentique sua conta da CLI gcloud executando gcloud auth login como usuário root. Além disso, a conta autenticada precisa ter as seguintes permissões:

    • compute.instances.get
    • compute.instances.list
    • compute.instances.updateNetworkInterface

Configurar o balanceador de carga

O orquestrador de RPM usa o HAProxy para distribuir o tráfego e o Keepalived para fornecer alta disponibilidade com um IP virtual (VIP).

Atualizar a especificação do recurso

No arquivo de especificação DBCluster, adicione dbLoadBalancerOptions, que garante que o gerenciador de clusters e o orquestrador saibam como gerenciar os endpoints do balanceador de carga.

DBCluster:
  metadata:
    name: DBCLUSTER_NAME
  spec:
    primarySpec:
      # ... other primary settings ...
      dbLoadBalancerOptions:
        ENVIRONMENT_TYPE::
          loadBalancerIP: "VIRTUAL_IP"
          loadBalancerType: "internal"
          loadBalancerInterface: "VIRTUAL_IP_INTERFACE"

Substitua:

  • ENVIRONMENT_TYPE: determina o ambiente em que o cluster está configurado: onprem ou gcp.

  • DBCLUSTER_NAME: o nome do cluster de banco de dados do AlloyDB Omni, por exemplo, my-db-cluster.

  • VIRTUAL_IP: endereço IP estático usado para o IP virtual flutuante. Os aplicativos cliente de banco de dados usam o endereço IP definido aqui. Para garantir que o Keepalived possa transmitir protocolos de resolução de endereço não solicitados (GARPs, na sigla em inglês) com êxito, esse endereço IP precisa atender às seguintes condições: ele precisa estar disponível, não pode fazer loopback e, no caso de ambientes on-premise, pertence à mesma sub-rede que as interfaces de nó principal.

  • VIRTUAL_IP_INTERFACE: interface de rede em que VIRTUAL_IP está configurado. O valor padrão é eth0.

Aplique a configuração

Aplique as mudanças de configuração usando a interface do orquestrador de sua preferência.

Ansible

Execute o playbook de inicialização usando os arquivos de especificação de inventário e recursos:

ansible-playbook DBCLUSTER_PLAYBOOK -i "DEPLOYMENT_SPECIFICATION" \
      -e resource_spec="DBCLUSTER_SPECIFICATION"

Substitua as seguintes variáveis:

  • DBCLUSTER_PLAYBOOK: caminho para o playbook criado para o cluster de banco de dados em Criar um cluster.

  • DEPLOYMENT_SPECIFICATION: caminho para a especificação da implantação criada em Instalar componentes do AlloyDB Omni.

  • DBCLUSTER_SPECIFICATION: caminho para as especificações do cluster.

alloydbctl

Aplique as especificações de recursos e implantação:

alloydbctl apply -d "DEPLOYMENT_SPECIFICATION" -r "DBCLUSTER_SPECIFICATION"

Substitua as seguintes variáveis:

  • DEPLOYMENT_SPECIFICATION: caminho para a especificação da implantação criada em Instalar componentes do AlloyDB Omni.

  • DBCLUSTER_SPECIFICATION: caminho para as especificações do cluster.

Verificar o balanceador de carga

Depois que o orquestrador de RPM concluir a configuração, verifique se é possível se conectar ao cluster de banco de dados usando o VIP:

psql -h VIRTUAL_IP -U postgres

Substitua VIRTUAL_IP pelo endereço IP configurado no campo loadBalancerIP.

O balanceador de carga encaminha automaticamente sua conexão para o nó principal atual.