Step 5: Configure your DNS

You are currently viewing version 1.3 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.3 (unsupported)

   Supported versions:

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

   Unsupported versions:

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

Reserve a static IP

Follow the steps below to create a static IP address for the runtime load balancer. This address exposes the hybrid runtime to API proxy requests coming from outside the cluster.

Note: It's important to create a static IP address, because when pods are restored or when you upgrade, it's possible that the external IP will change, causing an interruption in API traffic. By creating a static IP, the address exposed outside the cluster address will never change unless you release it.

1. Open the Google Cloud console and log in with the account you created in Step 1: Create a Google Cloud account.
2. Select the project that you created in Step 2: Create a Google Cloud project.
3. If you have not already done so, enable the Cloud DNS API. See Enabling APIs.
4. Create a static IP address:
   Note: The static IP address will be the IP address that is exposed outside the cluster, so give it a name that makes sense to you for that purpose. For example: apigee-loadbalancer

   • If you are on GKE, follow the instructions in Reserving a static external IP address to create a static IP address.

   • If you are on GKE on-prem (Anthos), follow the instructions in the Installing using static IP addresses to create a static IP address.
   • If you are on GKE on AWS (Anthos), you don't need to create a static IP address.
5. Copy the external IP address you just reserved. For example: 34.56.78.90. You will need it in a later step.

Get a registered domain

If you already have a registered domain, you can use it for the Apigee hybrid installation. If not, you can register a domain name through Google Domains or another domain registrar of your choice.

Configure your DNS

Create a new A type record in a zone in your DNS server as follows:

• Specify a DNS zone subdomain name. For example, suppose your zone's parent domain is acme.com, the subdomain name might be myapi. In this example, the address would be: myapi.acme.com.
• Set the A record address to the numeric IP address of your static IP, in dotted decimal format. For example: 34.56.78.90.

If you do not have an existing domain available to use, we provide a quickstart example that shows how to use Google Domains and Google Cloud DNS to create a domain and set up a DNS zone. See DNS quickstart.

1 2 3 4 5 (NEXT) Step 6: Create an environment group