External DNS
This section describes how to use external-dns
to maintain your DNS records
You require a DNS record when setting up a custom domain for your cluster. You can either create one manually, or set up the external-dns
service to manage your DNS record automatically.
If you choose to use external-dns
to maintain your DNS records, the external-dns
will take care of pointing the DNS record to the ingress of the cluster automatically.
The following example shows how to configure external-dns
to manage DNS records in AWS Route 53 automatically:
Open the
kommander.yaml
file:If you do not have a
kommander.yaml
file, initialize the configuration file, so you can edit it in the following steps. WARNING: Initialize this file only ONCE, otherwise you will overwrite previous customizations.If you have initialized the configuration file already, open the
kommander.yaml
with the editor of your choice.
Adjust the
app
section of yourkommander.yaml
file to include these values:CODEapps: external-dns: enabled: true values: | aws: credentials: secretKey: <secret-key> accessKey: <access-key> region: <provider-region> preferCNAME: true policy: upsert-only txtPrefix: local- domainFilters: - <example.com>
In the same
app
section, adjust thetraefik
section to include the following:CODEtraefik: enabled: true values: | service: annotations: external-dns.alpha.kubernetes.io/hostname: <mycluster.example.com>
Refer to the external-dns documentation for more information, as well as further instructions on how to configure external-dns
to use other DNS providers like Google Cloud DNS, CloudFlare, or on-site providers.
Kommander managed clusters
To configure external DNS for attached clusters, the External DNS application must be enabled in the Kommander Workspace.
Configure External DNS using the UI
Select the workspace your cluster is attached to from the top navigation bar.
Navigate to the Applications overview.
Search for the External DNS application and select Enable from the three-dot menu on the bottom right of the application card.
On the enable page, you can apply a specific configuration. Select Download File, which provides a default example you can adjust to your needs. Once all changes are made, its content can either be copied and pasted into the text field or uploaded using the Upload File button.
Here is an example configuration. Refer to external-dns documentation for more information:
aws:
credentials:
secretKey: <secret-key>
accessKey: <access-key>
region: <provider-region>
preferCNAME: true
policy: upsert-only
txtPrefix: local-
domainFilters:
- <example.com>