Version: 0.7

Create a Cluster DNS Zone

It's a common requirement to expose Kubernetes services, either publicly or internally, using a public domain. Kore automatically installs and configures the ExternalDNS application in each managed Kubernetes cluster. ExternalDNS automatically creates DNS records in managed DNS zones when a domain is configured on Kubernetes Ingress objects.

Kore administrators can register shared DNS zones and Kore will automatically create unique child DNS zones for all teams and clusters. This lets developers easily expose their applications on any domain registered in Kore. Teams can create additional DNS zones to be used in their clusters.

For more information on ExternalDNS, see the kubernetes-sigs/external-dns GitHub project.

This topic gives instructions for creating a cluster DNS zone.

Clouds and DNS providers#

CloudDNS ProviderStatus
AWSAWS Route 53Supported
AzureAzureDNSSupported
GCPGoogle Cloud DNSComing soon

About shared DNS zones#

Only Kore administrators can create shared DNS zones.

The main purpose of shared DNS zones is convenience. Particularly in non-production environments, it can be beneficial to have readily available DNS zones to be used for application endpoints. Teams can still register one or more custom DNS zones for each of their clusters.

For each shared DNS zone, Kore automatically creates the following child DNS zone for each managed Kubernetes cluster:

cluster_name.team_name.shared_DNS_zone_name

Example

If you have:

  • A shared DNS zone: teams.mycompany.com
  • A team: myteam
  • A cluster in AWS: dev

Then:

  • Kore creates a DNS zone created in AWS Route 53 called dev.myteam.teams.mycompany.com.
  • ExternalDNS can automatically use this DNS zone to create subdomains with the required CNAME or A records.

You can find these DNS zones on the team's page under DNS.

DNS Zones on the team page

Create a cluster DNS zone#

Team administrators can create a cluster DNS zone. A cluster DNS zone can be only assigned to a single cluster.

You can register any domain that you own, or whose parent domain you own, and for which you have access to set up DNS zone delegation.

To create a cluster DNS zone:

  1. On the Team page, navigate to DNS.

  2. Click the New button, and then fill out the required fields:

    • Domain: The name of the cluster DNS zone, for example app1.myproject.com
    • DNS provider: The provider in which the DNS zone for this domain will be created.
    • Cluster: Select the cluster to which this DNS zone will belong.
    note

    The cluster and the DNS provider must belong to the same cloud provider.

  3. Click Save.

    On the DNS page, an Action required label appears next to the DNS zone you created.

  1. Click Action required and follow the instructions on how to complete the setup of the NS record on the parent DNS zone.

    DNS Zone instructions

Once the NS records have been set up, it typically takes 5-30 minutes to propagate through DNS (sometimes longer). Kore will continue checking for correct setup. You can wait on this page or return later to verify this has completed.