Windows Server DNS Setup Guide¶

This document describes how to configure DNS for ARTESCA as mentioned in the General DNS Setup on Windows Server 2022.

This assumes a multi-node environment. In this context, it is recommended to have Virtual IPs (VIPs) for the ARTESCA Workload Plane servers. This way, you can have a single entry point for the ARTESCA Workload Plane services.

Note

This document is describing a basic configuration. If your configuration is more complex, you may need to adjust the steps according to your needs.

To retrieve the IP addresses of the ARTESCA workload plane servers, you can use the following command on the bootstrap node:

[artesca-os@bootstrap ~]$

sudo kubectl exec -n kube-system -c salt-master \
  --kubeconfig /etc/kubernetes/admin.conf \
  $(sudo kubectl --kubeconfig /etc/kubernetes/admin.conf \
    get pods -n kube-system -l app=salt-master -o name) \
  -- salt '*' metalk8s_network.get_portmap_ips

node-1:
   - 127.0.0.1
   - <node-1 data IP 1>
   - <node-1 data IP 2>
node-2:
   - 127.0.0.1
   - <node-2 data IP 1>
   - <node-2 data IP 2>
node-3:
   - 127.0.0.1
   - <node-3 data IP 1>
   - <node-3 data IP 2>

Note

127.0.0.1 should not be used as an IP address to configure DNS.

Important

This document assumes that you have already installed the DNS role on your Windows Server 2022.

To configure DNS for ARTESCA, follow these steps:

Open the DNS Manager on your Windows Server 2022.
Right-click Forward Lookup Zones and select New Zone.
Set it to primary zone.
Type the name of the zone.

Note

In the following image, the zone name is base.domain as an example. Replace it with your actual domain name.
To enable the wizards described below, configure the Reverse Lookup Zone.

Right-click Reverse Lookup Zones and select New Zone.
In the Network ID field, enter the subnet of the ARTESCA workload plane.

Note

In the following image, the network ID is 10.0.0 as an example. Replace it with your actual subnet. The Reverse lookup zone name will be automatically generated.
Now we will configure the A record for the ARTESCA workload plane.

Right-click the Forward Lookup Zone zone you created in the previous step and select New Host (A or AAAA).
In the Name field, enter artesca-cluster.

In the IP address field, enter one of the IP addresses of the workload plane ARTESCA server. It can also be a VIP if you have configured it.

Click Create associated pointer (PTR) record. Since we created the reverse lookup zone, this will create the PTR record for us.

Note

In the following image, the IP address is 10.0.0.1 as an example. Replace it with the actual IP or VIP address of your server.
Repeat the two previous steps for each IP or VIP you have to configure.
Now we will configure the CNAME records for the ARTESCA workload plane as referred to in the General DNS Setup.

Right-click the Forward Lookup Zone zone you created and select New Alias (CNAME).
In the Alias name field, enter the name you want to configure.

In the Fully qualified domain name (FQDN) for target host field, enter the name you used in the A record. You can use the Browse button to select the name from the list.

Note

In the following image, the FQDN is artesca-cluster.base.domain as an example. Replace it with the actual FQDN of your server.
Repeat the two previous steps for each CNAME record you have to configure.

Now you have configured DNS for ARTESCA. You can now proceed with the deployment.