Registrar um balanceador de carga de rede de passagem externa regional

Nesta página, explicamos como configurar um balanceador de carga de rede de passagem externa regional 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 (com HTTP ou gRPC) para determinar o endereço do serviço regional do balanceador de carga de rede de passagem externa e se conectar a ele diretamente.

Limitações

A integração do Diretório de serviços com balanceadores de carga de rede de passagem externa regionais tem as seguintes limitações:

  • O registro automático é compatível apenas com balanceadores de carga externos da camada 4. É possível registrar os serviços de balanceamento de carga do Google Kubernetes Engine usando a integração do GKE. É possível registrar outros balanceadores de carga externos, balanceadores de carga globais e entradas e gateways do Google Kubernetes Engine chamando a API do Diretório de serviços.
  • Você só pode usar o registro automático no momento da criação da regra de encaminhamento. O registro automático usando a atualização da Google Cloud CLI para uma regra de encaminhamento já existente não está disponível.
  • Diretório de serviços não oferece conectividade. Isso significa que, embora ele armazene o endereço IP virtual do balanceador de carga de rede de passagem externa regional, a pesquisa desse balanceador 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 Service Directory precisam estar no mesmo projeto e região que a regra de encaminhamento do balanceador de carga de rede de passagem externa regional que você está criando.

  • Você já precisa ter configurado os recursos necessários para criar uma regra de encaminhamento de balanceador de carga de rede de passagem externa regional.

    Para informações sobre como criar um balanceador de carga de rede de passagem externa regional, consulte Configurar um balanceador de carga de rede de passagem externa regional.

Configurar regras de encaminhamento para registrar um balanceador de carga de rede de passagem externa regional no Diretório de serviços

É necessário configurar uma regra de encaminhamento para registrar o balanceador de carga de rede de passagem externa regional no Diretório de serviços. Para registrar um balanceador de carga de rede de passagem externa regional, consulte a seção a seguir.

Registrar um balanceador de carga de rede de passagem externa regional

Para registrar um balanceador de carga de rede de passagem externa regional, execute o comando gcloud compute forwarding-rules create e defina a flag service-directory-registration:

gcloud beta compute forwarding-rules create FORWARDING_RULE_NAME \
    --region=REGION \
    --load-balancing-scheme=EXTERNAL \
    --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
  • RESERVED_IP_ADDRESS: o endereço IP que a regra de encaminhamento veicula.
  • PROTOCOL_TYPE: o protocolo IP que a regra disponibilizará
  • 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. 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

Os endpoints do Service Directory criados ao registrar um balanceador de carga de rede de passagem regional externa têm as seguintes características:

  • O endpoint tem o mesmo nome da regra de encaminhamento com o número da 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ê especificou duas portas --port=8080, 8081, vai receber 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 de rede de passagem regional externa, verifique se o chamador da API sabe a porta a ser usada para conexão.
  • Não é possível modificar ou excluir o endpoint usando a API pública do Diretório de serviços. 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 reside enquanto a regra de encaminhamento existir.
  • O endpoint em si não é cobrado, mas os detalhes de preços normais se aplicam a todas as chamadas de API para o endpoint.

Para confirmar se 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 da porta especificado.

Para resolver o serviço no Diretório de serviços, 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 seu serviço.
  • REGION: a Google Cloud região que contém o namespace. Ela precisa ser a mesma região em que você criou a regra de encaminhamento.

Limpeza

Para excluir os recursos criados, siga estas etapas.

  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 que você criou
    • 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 do serviço do Diretório de serviços.

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

A seguir