DNS setup quickstart

You are currently viewing version 1.8 of the Apigee hybrid documentation. This version is end of life. You should upgrade to a newer version. For more information, see Supported versions.

Version 1.8 (unsupported)

   Supported versions:

• v1.12 (latest)                        
• v1.11                         
• v1.10                                        
• List of supported versions

   Unsupported versions:

• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

This topic offers an example showing how to use Google Cloud DNS to configure a DNS zone with a record set that points to your Apigee hybrid ingress IP address.

Note: If you already have your own domain and DNS zone to use, you do not need to do these steps. You can simply configure your own zone with a new record set pointing to your ingress load balancer.

Get a registered domain

You can register a domain name through Google Domains or another domain registrar of your choice.

Create a managed zone and record set

This section explains how to create a DNS zone and record set in Google Cloud DNS.

1. Create a managed zone and record set for your domain. This is the address you will use to make API proxy calls to hybrid.
   1. Create a managed public zone. For instructions, see Create a managed public zone.
   2. Create a new record set with the following selections. For instructions, see Create a new record.
      • DNS Name: The name of the endpoint external API calls communicate with, like api-services or example-endpoint
      • Resource Record Type: A
      • TTL and TTL Unit: Accept defaults
      • IP Address: The static IP you created
2. In the Zone details view, copy the DNS name of the A record you just created and save it to a DOMAIN environment variable. Be careful to not include the period at the end.

   

   export DOMAIN=dns_name_of_record

Add your DNS servers to Cloud DNS

In this step, you copy the DNS servers from your domain to Google Cloud DNS. Doing so allows Google Cloud to manage the DNS for your Google Cloud Project.

3. The Zone details view lists four DNS servers as the NS data for your new zone. Copy the DNS record data as shown in the following example:

   

Configure your domain to use the Google Cloud name servers

Go to your domain registrar and edit your domain's DNS settings to use the Google Cloud Name servers.

The following screenshot shows an example of entering the Google Cloud name servers in Google Domains:

Google Cloud DNS now manages the DNS records for your domain.