From 730fa7b95a19c49df8b22cff4157caa574deab5d Mon Sep 17 00:00:00 2001 From: PseudoResonance <75700a85-1205-4740-aebf-4413a352e81b@otake.pw> Date: Sat, 18 Oct 2025 21:49:46 -0700 Subject: [PATCH 1/2] docs: clarify hostname annotation behavior --- docs/annotations/annotations.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/annotations/annotations.md b/docs/annotations/annotations.md index 343079d31f..71c40f441d 100644 --- a/docs/annotations/annotations.md +++ b/docs/annotations/annotations.md @@ -64,7 +64,7 @@ Otherwise, use the `IP` of each of the `Service`'s `Endpoints`'s `Addresses`. ## external-dns.alpha.kubernetes.io/hostname -Specifies the domain for the resource's DNS records. +Specifies additional domains for the resource's DNS records. Multiple hostnames can be specified through a comma-separated list, e.g. `svc.mydomain1.com,svc.mydomain2.com`. @@ -73,7 +73,8 @@ For `Pods`, uses the `Pod`'s `Status.PodIP`, unless they are `hostNetwork: true` Notes: -- This annotation `overrides` any automatically derived hostnames (e.g., from Ingress.spec.rules[].host). +- This annotation adds extra hostnames alongside any automatically derived hostnames (e.g., from Ingress.spec.rules[].host). +- The [`ingress-hostname-source`](#external-dnsalphakubernetesioingress-hostname-source) annotation may be used to control the behavior of the `hostname` annotation. - Hostnames must match the domain filter set in ExternalDNS (e.g., --domain-filter=example.com). - This is an alpha annotation — subject to change; newer versions may support alternatives or deprecate it. - This annotation is helpful for: From ece2f7b864dc0da40604af707e080c87adfc15d8 Mon Sep 17 00:00:00 2001 From: Josh <2635f0d1-2818-4dac-aae0-7043ff60c14e@otake.pw> Date: Mon, 20 Oct 2025 18:17:15 -0700 Subject: [PATCH 2/2] docs: specify how hostname annotation behavior can be configured Co-authored-by: Michel Loiseleur <97035654+mloiseleur@users.noreply.github.com> --- docs/annotations/annotations.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/annotations/annotations.md b/docs/annotations/annotations.md index 71c40f441d..24f90dd0f1 100644 --- a/docs/annotations/annotations.md +++ b/docs/annotations/annotations.md @@ -73,8 +73,8 @@ For `Pods`, uses the `Pod`'s `Status.PodIP`, unless they are `hostNetwork: true` Notes: -- This annotation adds extra hostnames alongside any automatically derived hostnames (e.g., from Ingress.spec.rules[].host). -- The [`ingress-hostname-source`](#external-dnsalphakubernetesioingress-hostname-source) annotation may be used to control the behavior of the `hostname` annotation. +- This annotation can override or add extra hostnames alongside any automatically derived hostnames (e.g., from Ingress.spec.rules[].host). +- The [`ingress-hostname-source`](#external-dnsalphakubernetesioingress-hostname-source) annotation may be used to specify where to get the domain for an `Ingress` resource. - Hostnames must match the domain filter set in ExternalDNS (e.g., --domain-filter=example.com). - This is an alpha annotation — subject to change; newer versions may support alternatives or deprecate it. - This annotation is helpful for: