Islet DNSaaS - DNS as a Service for Data Lake tenants

This document describes implementation of DNSaaS records in Data Lake.

DNS as a Service (DNSaaS) provides functionality of managing configuration of user’s domains. Managing configuration means that the user is capable of creating, updating and deleting the following DNS records:

../_images/1.png

The end user can only access DNS configuration management on Data Lake via OpenStack web dashboard – Horizon.

DNS records management is performed on the level of an OpenStack project.

Since the purpose of DNSaaS is to deal with external domain names, the internal name resolution (name resolution for private IP addresses within user’s projects) is not covered by this documentation.

What Are We Going To Cover

  • The concept of DNS as a Service on Destination Earth Data Lake

  • How to form a name of a new record within a DNS zone

  • General steps to create a new DNS record

  • Understanding the parameters used to create a new record

  • Managing records

  • How to update a record

  • How to delete a record

  • Known limitations

The concept of DNS as a Service on DEDL

  1. Every bridge has a domain under data.destination-earth.eu of form: bridge_name.data.destination-earth.eu

  2. Central bridge also has data.destination-earth.eu itself. All of the requirements and functions apply to it.

  3. This is the only allowed domain for zones to be created. Other DNS zones outside of data.destination-earth.eu are not supported.

  1. Zones and sub-zones are created only through a request to DestinE Help Desk.

Possible formats of the names are

  • tenant_name.bridge.data.destination-earth.eu and

  • tenant_name.data.destination-earth.eu.

  1. DEDL users can create, modify, and delete records in their zones.

How to form a name of a new record within a DNS zone

You only can create records in the current DNS Zone assigned to your tenant (project). To form a name of the record set, add its name in front of the zone name:

<your_record_name>.<tenant_name>.<bridge_name>.destination-earth.eu.

If your account were support_team, the complete name on CENTRAL cloud could be

support_team.central.data.destination-earth.eu

Note that since we are using the CENTRAL cloud, the name of the bridge may be omitted.

General steps to create a new DNS record

The steps are:

  1. Login in your tenant with your web browser

  2. Select DNS in left section

  3. Select Zones

../_images/image-2024-08-14-09-33-20-378.png
  1. Click on your tenant Zone.

../_images/image-2024-08-14-09-32-36-124.png
  1. Select your zone and tap on “Records Sets”.

  2. Click on “Create Record Set” button and provide the needed information to create the new record in the Zone. As an example:

../_images/image-2024-08-14-09-33-44-379.png

The records you define for the existing subdomains propagate through the Internet within a few seconds.

Understanding the parameters used

We assumed that the Floating IP address of your server is 217.71.193.139.

The types of other parameters are:

Type

Type of record (for example A, MX, etc.)

Name

Name of the record

Each time a name of domain or a server is added or edited, add dot ‘.’ at the end of the entry. For example:

exampledomain.com.
mail.exampledomain.com.
Description

Free text description

TTL

Time To Live in seconds - a period of time between refreshing cache in DNS serves.

Records

Desired record value (there may be more than one - one per line):

  • for records of Type A put IP address

  • for records of Type MX put name of a mail server which hosts e-mails for the domain

  • for records of Type CNAME put original name which is to be aliased

Managing records

Anytime you want to review, edit or delete records in your domain, visit OpenStack dashboard, ProjectDNSZones.

../_images/image-2024-08-14-09-58-11-171.png

After clicking the domain name of your interest, choose Record Sets tab and see the list of all records.

For a chosen entry, you will be able to choose two options from the right side:

../_images/update_delete_record.png
Update

You will be able to update the TTL and/or IP of the record.

Delete

Will eliminate that record.

How to update a record

This is quite similar to the entry screen, but you can change only two options, TTL and the IP of the record.

../_images/image-2024-08-14-09-59-48-648.png

How to delete a record

../_images/image-2024-08-14-10-00-24-072.png

Select Delete Record Set and get the following screen:

../_images/image-2024-08-14-10-00-34-426.png

As a result, you will see one record less:

../_images/image-2024-08-14-10-00-42-800.png

You can check it from the Terminal as well:

../_images/image-2024-08-14-10-01-49-379.png

Limitations

There are the following limitations in OpenStack DNSaaS:

  • You cannot manage NS records for your domain. Therefore

    • you cannot add additional secondary name servers

    • you are unable to delegate subdomains to external servers

  • Even though you are able to configure reverse DNS for your domain, this configuration will have no effect since reverse DNS for IP pools are managed on DNS servers other than OpenStack DNSaaS.