github.com/openshift/installer@v1.4.17/docs/user/gcp/dns.md (about)

     1  # DNS Setup
     2  
     3  Google's Cloud DNS service is used by the OpenShift installer to configure cluster DNS resolution and provide name lookup
     4  for the cluster to the outside world. To use OpenShift, you must have created a public zone in Google Cloud DNS in
     5  the same project as your OpenShift cluster. You must also ensure the zone is "authoritative" for the domain. There are
     6  two ways to do this outlined below: root domain and subdomain. A root domain is `example.com`. A subdomain is of
     7  the form `clusters.example.com`.
     8  
     9  The below sections identify how to ensure your DNS zone is authoritative for a domain.
    10  
    11  ## Step 1: Acquire/Identify Domain
    12  
    13  You may skip this step if using an existing domain and registrar. You will move the authoritative DNS to Google Cloud DNS or
    14  submit a delegation request for a subdomain in a later step.
    15  
    16  You can use [Google Domains](https://domains.google.com) to purchase a domain or use your preferred registrar.
    17  
    18  ## Step 2: Create Public Zone
    19  
    20  Whether using a root domain or a subdomain, you must create a public DNS zone.
    21  
    22  [GCP: Creating a Public DNS Zone][create-dns-zone]
    23  
    24  To use the root domain, you'd create the DNS zone with the value `example.com`. To use a subdomain, you'd
    25  create a zone with the value `clusters.example.com`. (Use appropriate domain values for your situation.)
    26  
    27  ### Example: Root Domain
    28  
    29  ![GCP: Create public dns zone](images/public_dns_zone.png)
    30  
    31  ## Step 3: Get Public Nameservers of the DNS Zone
    32  
    33  For either a root domain `example.com` or a subdomain `clusters.example.com`, you must extract the new
    34  authoritative nameservers from the DNS zone records.
    35  
    36  [GCP: Getting the Name Servers for a Public DNS Zone][lookup-name-servers]
    37  
    38  ### Example: Root Domain
    39  
    40  ![GCP: Get registrar setup for DNS zone](images/zone_nameserver_records.png)
    41  
    42  ## Step 4a: Root Domain - Update Registrar
    43  
    44  Each registrar requires a slightly different procedure. Using the four nameserver values from the previous step,
    45  you will update the registrar records to the Google Cloud DNS nameservers.
    46  
    47  If you are migrating your root domain to Google Cloud DNS, you should migrate existing DNS records:
    48  
    49  [GCP: Migrating to Cloud DNS][migrate]
    50  
    51  ## Step 4b: Subdomain - Perform DNS Delegation
    52  
    53  For a subdomain of example.com (e.g. clusters.example.com), you must add delegation records to the parent/root domain. This may require a request to your company's IT department or the division which controls the root domain and DNS services for your company.
    54  
    55  [create-dns-zone]: https://cloud.google.com/dns/docs/quickstart
    56  [lookup-name-servers]: https://cloud.google.com/dns/docs/update-name-servers#look_up_your_name_servers
    57  [migrate]: https://cloud.google.com/dns/docs/migrating