From 31f06153f66a688c96d330dba98a63d44908af72 Mon Sep 17 00:00:00 2001 From: Jeff Wenzbauer Date: Wed, 22 Feb 2023 13:45:19 -0700 Subject: [PATCH] add documentation about canonical hosted zones --- docs/tutorials/aws.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/tutorials/aws.md b/docs/tutorials/aws.md index b4dac44cc..b0c91cd83 100644 --- a/docs/tutorials/aws.md +++ b/docs/tutorials/aws.md @@ -837,6 +837,14 @@ You can configure Route53 to associate DNS records with healthchecks for automat Note: ExternalDNS does not support creating healthchecks, and assumes that `` already exists. +## Canonical Hosted Zones + +When creating ALIAS type records in Route53 it is required that external-dns be aware of the canonical hosted zone in which +the specified hostname is created. External-dns is able to automatically identify the canonical hosted zone for many +hostnames based upon known hostname suffixes which are defined in [aws.go](../../provider/aws/aws.go). If a hostname +does not have a known suffix then the suffix can be added into `aws.go` or the [target-hosted-zone annotation](#target-hosted-zone) +can be used to manually define the ID of the canonical hosted zone. + ## Govcloud caveats Due to the special nature with how Route53 runs in Govcloud, there are a few tweaks in the deployment settings.