Registrar um balanceador de carga interno

Esta página fornece informações sobre como configurar um balanceador de carga de rede de passagem interna ou um balanceador de carga de aplicativo interno (pré-lançamento) para que ele seja registrado automaticamente no Diretório de serviços.

Ao criar o balanceador de carga, é possível registrá-lo como um endpoint em um namespace e serviço do Diretório de serviços de sua escolha. Os aplicativos clientes podem usar o Diretório de serviços (usando HTTP ou gRPC) e/ou DNS (se você tiver criado uma zona de DNS do Diretório de serviços) para determinar o endereço do serviço de balanceador de carga interno e se conectar a ele diretamente.

Limitações

A integração do Diretório de serviços com o balanceamento de carga interno tem as seguintes limitações:

  • O registro automático só se aplica a balanceadores de carga internos e de rede. É possível registrar serviços de balanceamento de carga do Google Kubernetes Engine usando a integração do GKE. É possível registrar balanceadores de carga globais e entradas e gateways do Google Kubernetes Engine chamando a API do Diretório de serviços.
  • O registro automático só pode ser usado no momento da criação da regra de encaminhamento. O registro automático usando a atualização da CLI do Google Cloud para uma regra de encaminhamento já existente não está disponível.
  • É possível registrar balanceadores de carga internos no Diretório de serviços nos projetos de host ou de serviço de uma configuração de rede VPC compartilhada. No entanto, todos os componentes e back-ends de balanceamento de carga precisam existir no mesmo projeto. Para mais detalhes, consulte as limitações do balanceamento de carga interno.
  • O Diretório de serviços não oferece conectividade, o que significa que, embora ele armazene o endereço IP virtual do balanceador de carga interno, procurar o balanceador de carga interno no Diretório de serviços não garante que você possa se conectar ao endereço IP virtual.

Antes de começar

Estas instruções exigem o seguinte:

  • Você já precisa ter um namespace e um serviço do Diretório de serviços. Caso contrário, crie um namespace e um serviço usando o procedimento em Configurar o Diretório de serviços.

    O namespace e o serviço do diretório de serviços precisam estar no mesmo projeto e região que a regra de encaminhamento do balanceador de carga interno que você está criando.

  • Você já deve ter configurado os recursos necessários para criar uma regra de encaminhamento do balanceador de carga interno.

Configurar regras de encaminhamento para registrar um balanceador de carga interno no Diretório de serviços

É necessário configurar uma regra de encaminhamento para registrar o balanceador de carga interno no Diretório de serviços. Para registrar um balanceador de carga de rede de passagem interna ou um balanceador de carga de aplicativo interno, consulte as seções a seguir.

Registrar um balanceador de carga de rede de passagem interna

Para registrar um balanceador de carga de rede de passagem interna, execute o comando gcloud compute forwarding-rules create e defina a sinalização service-directory-registration:

gcloud compute forwarding-rules create FORWARDING_RULE_NAME \
    --region=REGION \
    --load-balancing-scheme=INTERNAL \
    --network=NETWORK_NAME \
    --subnet=SUBNET_NAME \
    --address=RESERVED_IP_ADDRESS \
    --ip-protocol=PROTOCOL_TYPE \
    --ports=PORT_NUMBER \
    --backend-service=BACKEND_SERVICE_NAME \
    --backend-service-region=REGION \
    --service-directory-registration=SD_SERVICE_NAME

Substitua:

  • FORWARDING_RULE_NAME: um nome para a regra de encaminhamento que você quer criar.
  • REGION: a região onde criar a regra de encaminhamento
  • NETWORK_NAME: a rede em que se aplica essa regra de encaminhamento.
  • SUBNET_NAME: a sub-rede em que se aplica essa regra de encaminhamento
  • RESERVED_IP_ADDRESS: o endereço IP que a regra de encaminhamento veicula.
  • PROTOCOL_TYPE: o protocolo IP que a regra veicula
  • PORT_NUMBER: uma lista de portas separadas por vírgula
  • BACKEND_SERVICE_NAME: serviço de back-end de destino que recebe o tráfego.
  • SD_SERVICE_NAME: o nome totalmente qualificado do serviço de diretório de serviços em que você quer registrar o endpoint. Ele precisa estar no mesmo projeto e região que a regra de encaminhamento que está sendo criada. Por exemplo: projects/PROJECT/locations/REGION/namespaces/NAMESPACE_NAME/services/SERVICE_NAME.

Registrar um balanceador de carga de aplicativo interno

Para registrar um balanceador de carga de aplicativo interno regional, execute o comando gcloud compute forwarding-rules create e defina a sinalização service-directory-registration:

gcloud beta compute forwarding-rules create FORWARDING_RULE_NAME \
    --region=REGION \
    --load-balancing-scheme=INTERNAL_MANAGED \
    --network=NETWORK_NAME \
    --address=RESERVED_IP_ADDRESS \
    --target-https-proxy=PROXY_NAME \
    --target-https-proxy-region=PROXY_REGION \
    --ports=PORT_NUMBER \
    --service-directory-registration=SD_SERVICE_NAME

Substitua:

  • FORWARDING_RULE_NAME: um nome para a regra de encaminhamento que você quer criar.
  • REGION: a região onde criar a regra de encaminhamento
  • NETWORK_NAME: rede em que se aplica essa regra de encaminhamento
  • RESERVED_IP_ADDRESS: o endereço IP que a regra de encaminhamento veicula.
  • PROXY_NAME: proxy de destino que recebe o tráfego
  • PROXY_REGION: a região do proxy a ser operada
  • PORT_NUMBER: uma lista de portas separadas por vírgula
  • SD_SERVICE_NAME: o nome totalmente qualificado do serviço de diretório de serviços em que você quer registrar o endpoint. Esse serviço precisa estar no mesmo projeto e região que a regra de encaminhamento que está sendo criada. Por exemplo: projects/PROJECT/locations/REGION/namespaces/NAMESPACE_NAME/services/SERVICE_NAME.

Verificar o endpoint

Um ou mais endpoints do Diretório de serviços criados ao registrar um balanceador de carga interno têm as seguintes características:

  • O endpoint tem o mesmo nome da regra de encaminhamento com o número de porta especificado (<forwarding rule name>-<port>). Por exemplo, se você criar uma regra de encaminhamento RULE com --port=8080, vai receber um endpoint chamado RULE-8080. Para a mesma regra, se você especificar duas portas --port=8080, 8081, terá dois endpoints, RULE-8080 e RULE-8081. Se você especificar --port=ALL, o endpoint do Diretório de serviços será registrado com a porta 0. Se você for o proprietário do balanceador de carga interno, é necessário garantir que o autor da chamada da API saiba qual porta se conectar.
  • Não é possível modificar ou excluir o endpoint usando a API pública do Service Directory. O endpoint só é excluído automaticamente quando você exclui a regra de encaminhamento. Isso significa que não é possível excluir o serviço e o namespace em que o endpoint está enquanto a regra de encaminhamento existe.
  • O endpoint em si não é cobrado, mas os detalhes de preços normais se aplicam a qualquer chamada de API para o endpoint.

Para confirmar que o endpoint foi criado, resolva o serviço no Diretório de serviços. Você vai encontrar um endpoint com o mesmo nome da regra de encaminhamento e o número de porta especificado.

Para resolver o serviço no diretório de serviços, faça o seguinte:

gcloud

Execute o comando gcloud service-directory services resolve:

gcloud service-directory services resolve SD_SERVICE_NAME \
    --namespace=SD_NAMESPACE_NAME \
    --location=REGION

Substitua:

  • SD_SERVICE_NAME: o nome do serviço do Diretório de serviços a ser resolvido. Ele precisa estar no nome de namespace do diretório de serviços.
  • SD_NAMESPACE_NAME: o nome que você deu ao namespace que contém o serviço.
  • REGION: a região Google Cloud que contém o namespace. Ela precisa ser a mesma região em que você criou a regra de encaminhamento.

Opcional: criar uma zona do diretório de serviços usando o Cloud DNS

É possível resolver endpoints do Diretório de serviços registrados nessa integração usando o DNS, como qualquer outro endpoint do Diretório de serviços. Para criar uma zona do Diretório de serviços usando o Cloud DNS, consulte Como configurar uma zona do Diretório de serviços.

Para verificar se a zona está configurada corretamente, execute uma consulta DNS da zona do Diretório de serviços. Para instruções sobre como consultar usando o DNS, consulte Como fazer consultas usando o DNS. Se a zona estiver configurada corretamente, o endereço IP do balanceador de carga interno vai aparecer na saída do comando.

Limpeza

Para excluir os recursos que você criou, faça o seguinte:

gcloud

  1. Para excluir a regra de encaminhamento, execute o comando gcloud compute forwarding-rules delete:

    gcloud compute forwarding-rules delete FORWARDING_RULE_NAME \
  --region=REGION \

    Substitua:

    • FORWARDING_RULE_NAME: o nome da regra de encaminhamento criada
    • REGION: a região da regra de encaminhamento.

    Para mais detalhes, consulte Como excluir uma regra de encaminhamento.

    Para confirmar que a exclusão da regra de encaminhamento excluiu automaticamente o endpoint do Diretório de serviços, execute o comando gcloud service-directory services resolve descrito na seção Verificar o endpoint no serviço do Diretório de serviços.

  2. Se você criou uma zona, siga as instruções em Excluir uma zona gerenciada para excluir a zona.

  3. Para excluir o namespace e o serviço do Diretório de serviços, consulte Como excluir recursos.

A seguir