ExternalDNS

DNSexternal-dns

Kubernetes controller that writes Services and Ingresses into an external DNS provider.

Provider: default
Kind: DNS
Category: Edge
Official docs: https://kubernetes-sigs.github.io/external-dns/latest/

Properties · 4 set by this component

property	type	values	required	kind default	this component
anycast	boolean	—	no	false	▸ false
deletesRecords · component property	boolean	—	no	false	inherited
geoRouting	boolean	—	no	false	▸ false
healthChecked	boolean	—	no	false	▸ false
managed	boolean	—	no	true	▸ false
policy · component property	enum	upsert-only \| sync	no	upsert-only	inherited
redundantProviders	boolean	—	no	false	inherited
registry · component property	enum	txt \| noop	no	txt	inherited
ttlSeconds	integer	—	no	—	inherited

Rules that apply · 1

Every rule whose selector covers this component's kind or its category. Whether a rule fires depends on the design: its properties, its edges and its groups.

Shared dependency without redundancyerror

shared-dependency-without-redundancy

The design requires redundant discovery, but this DNS or coordination service, which everything depends on, runs on a single provider or a single replica. Its failure is the whole system's failure.

— all of these hold:
— the design requirement `availability.discoveryRedundant` is true
— any of these hold:
— the node's `redundantProviders` is false
— the node's `replicated` is false

Use it in a design

nodes:
  - { id: "external-dns", component: "external-dns" }

Other DNS products · 33

Alibaba Cloud DNSalibaba-dnsalibabaclouddns Alibaba Cloud Domain Namesalibaba-domainsalibabaclouddns Alibaba Cloud DNS PrivateZonealibaba-private-zonealibabaclouddns Amazon Application Recovery Controller (ARC)aws-application-recovery-controllerawsdns Amazon Route 53 Global Resolveraws-route53-global-resolverawsdns Amazon Route 53 Resolver endpointaws-route53-resolverawsdns Amazon Route 53route53awsdns Azure DNSazure-dnsazuredns Azure DNS Private Resolverazure-dns-private-resolverazuredns Azure Private DNSazure-private-dnsazuredns Azure Traffic Managerazure-traffic-managerazuredns Cloudflare DNScloudflare-dnscloudflaredns Cloudflare Internal DNScloudflare-internal-dnscloudflaredns Cloudflare Registrarcloudflare-registrarcloudflaredns Cloudflare Secondary DNScloudflare-secondary-dnscloudflaredns BIND 9binddns CoreDNScorednsdns Generic DNSdnsdns DNSdns-resolverdns dnsmasqdnsmasqdns Knot DNSknot-dnsdns IBM NS1 Connectns1dns Pi-holepi-holedns PowerDNS Authoritative Serverpowerdnsdns Unboundunbounddns DigitalOcean DNSdigitalocean-dnsdigitaloceandns Google Cloud DNSgoogle-cloud-dnsgcpdns Cloud Domainsgoogle-cloud-domainsgcpdns IBM Cloud DNS Servicesibm-dns-servicesibmdns DNS Private Zoneoci-dns-private-zoneocidns DNS Public Zoneoci-dns-zoneocidns Traffic Management Steering Policyoci-traffic-managementocidns OpenStack Designateopenstack-designateopenstackdns

Source

1# yaml-language-server: $schema=../../schema/component.schema.json
2# ExternalDNS: a Kubernetes controller that "synchronizes exposed Kubernetes Services and Ingresses
3# with DNS providers". It is not a DNS server; it writes records into Route 53, Cloud DNS and the
4# rest. It marks the records it owns with TXT registry entries keyed by --txt-owner-id, and deleting a
5# record needs --policy=sync, so the default upsert-only policy never removes one ("ExternalDNS").
6schemaVersion: "1"
7type: "component"
8id: "external-dns"
9kind: "dns"
10provider: "default"
11docs: "https://kubernetes-sigs.github.io/external-dns/latest/"
12defaults:
13  managed: false
14  anycast: false
15  geoRouting: false
16  healthChecked: false
17properties:
18  policy:
19    type: "enum"
20    values: ["upsert-only", "sync"]
21    default: "upsert-only"
22  registry:
23    type: "enum"
24    values: ["txt", "noop"]
25    default: "txt"
26  deletesRecords:
27    type: "boolean"
28    default: false

The same page as markdown, for an agent: /catalogue/components/external-dns.md