ContextQMD
Back to External Dns

Ingress source

docs/sources/ingress.md

0.21.01.8 KB
Original Source

Ingress source

The ingress source creates DNS entries based on Ingress.networking.k8s.io resources.

Filtering the Ingresses considered

The --ingress-class flag filters Ingress resources by a set of ingress classes. The flag may be specified multiple times in order to allow multiple ingress classes.

This source supports the --label-filter flag, which filters Ingress resources by a set of labels.

Domain names

The domain names of the DNS entries created from an Ingress are sourced from the following places:

  1. Iterates over the Ingress's spec.rules, adding any non-empty host.

This behavior is suppressed if the --ignore-ingress-rules-spec flag was specified or the Ingress had an external-dns.alpha.kubernetes.io/ingress-hostname-source: annotation-only annotation.

  1. Iterates over the Ingress's spec.tls, adding each member of hosts.

This behavior is suppressed if the --ignore-ingress-tls-spec flag was specified or the Ingress had an external-dns.alpha.kubernetes.io/ingress-hostname-source: annotation-only annotation,

  1. Adds the hostnames from any external-dns.alpha.kubernetes.io/hostname annotation.

This behavior is suppressed if the --ignore-hostname-annotation flag was specified or the Ingress had an external-dns.alpha.kubernetes.io/ingress-hostname-source: defined-hosts-only annotation.

  1. If no DNS entries were produced for an Ingress by the previous steps or the --combine-fqdn-annotation flag was specified, then adds hostnames generated from any--fqdn-template flag.

Targets

The targets of the DNS entries created from an Ingress are sourced from the following places:

  1. If the Ingress has an external-dns.alpha.kubernetes.io/target annotation, uses the values from that.

  2. Otherwise, iterates over the Ingress's status.loadBalancer.ingress, adding each non-empty ip and hostname.