You can choose to automatically register your internal load balancer service with Service Directory when you create an internal load balancer. This enables client applications to use Service Directory through HTTP, gRPC, or DNS to resolve the address of the internal load balancer service and connect to it directly.
Registering your internal load balancer with Service Directory lets you do the following:
- Choose custom DNS names to serve the network locations of your
internal load balancers as opposed to DNS accessing your internal load
balancer only through an internally generated DNS name in the
.internal
domain. - Serve multiple internal load balancers from the same DNS domain name, which is otherwise not possible with the current auto-generated DNS records.
- Register internal load balancers directly and automatically in Service Directory providing a single repository for all your services in Google Cloud.
- See standalone services, endpoints, and your internal load balancer endpoints with a single command in the Service Directory API.
- Apply administrative actions like access control to Service Directory resources at the namespace or service level to encompass both your internal load balancer endpoints as well as other backend services.
Register a regional internal Application Load Balancer with Service Directory
To register a regional internal Application Load Balancer, run the gcloud compute forwarding-rules
create
command and
set the service-directory-registration
flag:
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
Replace the following:
FORWARDING_RULE_NAME
: a name for the forwarding rule that you want to createREGION
: the region to create the forwarding rule inNETWORK_NAME
: the network that this forwarding rule applies toRESERVED_IP_ADDRESS
: the IP address that the forwarding rule servesPROXY_NAME
: the target proxy that receives the trafficPROXY_REGION
: the region of the proxy to operate onPORT_NUMBER
: a list of comma-separated portsSD_SERVICE_NAME
: the fully qualified name of the Service Directory service where you want to register the endpoint. This service must be in the same project and region as the forwarding rule being created. For example: projects/PROJECT
/locations/REGION
/namespaces/NAMESPACE_NAME
/services/SERVICE_NAME
.
What's next
- To learn more about Service Directory, see Service Directory overview.
- To learn about limitations of Service Directory integration with
regional internal Application Load Balancer and how to verify the endpoint, see
Register an internal load balancer.