Skip to main content

Configure custom DNS for IOMETE Data Plane

This document aims to provide you with a straightforward, step-by-step approach to setting up a DNS name for your IOMETE data plane, enhancing its accessibility and ease of use.


Understanding the Basics

Before we dive into the technical steps, let's clarify some key concepts:

  • IOMETE Data Plane: This is the infrastructure component that handles the processing and movement of data within the IOMETE ecosystem.
  • DNS (Domain Name System): DNS translates human-friendly domain names (like www.example.com) into IP addresses that computers use to identify each other on the network.
  • Istio Ingress Gateway: This is a crucial component within the IOMETE setup that directs incoming traffic to the right destinations within your data plane.

Identifying the Istio Ingress Gateway Address

The first step in configuring your DNS is to locate the external IP address of the Istio Ingress Gateway, as all traffic to the IOMETE data-plane goes through it.

If Your Setup Uses a LoadBalancer

IOMETE typically configures the Istio ingress gateway as a LoadBalancer. To find its external address, use the following command in your terminal:

kubectl get svc istio-ingress -n istio-system

This command returns the external address of the ingress gateway.

info

Note this address, as it could be either an IP or a DNS address.

If Your Setup Uses a NodePort

In cases where the gateway is configured as a NodePort, you'll need to identify the IP address of a Kubernetes worker node, ideally the one hosting the Istio ingress gateway.

Creating Your DNS Record

With the external address of the Istio Ingress Gateway in hand, you're ready to create a DNS record. This step involves going to your DNS provider and setting up the record that will point to the IOMETE data plane.

  • For an IP Address: Create an A record with your DNS provider, pointing to the IP address you've identified.
  • For a DNS Name: Create a CNAME record that points to the DNS name of the ingress gateway.

Here's a simplified overview of what to do next:

  1. Access Your DNS Provider: Log into the platform where your domain's DNS settings are managed.
  2. Navigate to DNS Management: Look for the section where you can add or modify DNS records.
  3. Add the Record: Depending on your external address:
    • For an IP address, add an A record pointing to this IP.
    • For a DNS name, add a CNAME record pointing to this name.
  4. Save Changes: Apply and save your changes. DNS propagation can take some time, so it might not work immediately.
tip

Remember, DNS changes can take a while to propagate across the internet, so give it some time before testing.