From acc5aeb7c62042de6bc61f9c4cc5569618b7f8af Mon Sep 17 00:00:00 2001 From: Ewoud Kohl van Wijngaarden Date: Wed, 3 Apr 2024 18:47:32 +0200 Subject: [PATCH] Document dns_nsupdate provider in managing DNS section This takes the idea that there should be a central place with documentation on all DNS providers. Not spread over multiple guides. It starts with the dns_nsupdate provider, but this should be completed with all of the providers. --- ...ssembly_managing-dns-on-smart-proxies.adoc | 2 ++ .../con_managing-dns-by-using-smartproxy.adoc | 4 ++-- .../proc_configuring-dns-nsupdate.adoc | 20 +++++++++++++++++++ 3 files changed, 24 insertions(+), 2 deletions(-) create mode 100644 guides/common/modules/proc_configuring-dns-nsupdate.adoc diff --git a/guides/common/assembly_managing-dns-on-smart-proxies.adoc b/guides/common/assembly_managing-dns-on-smart-proxies.adoc index e1e8111c184..6c67e212d59 100644 --- a/guides/common/assembly_managing-dns-on-smart-proxies.adoc +++ b/guides/common/assembly_managing-dns-on-smart-proxies.adoc @@ -1,5 +1,7 @@ include::modules/con_managing-dns-by-using-smartproxy.adoc[] +include::modules/proc_configuring-dns-nsupdate.adoc[leveloffset=+1] + ifndef::satellite[] include::modules/proc_configuring-dns-libvirt.adoc[leveloffset=+1] diff --git a/guides/common/modules/con_managing-dns-by-using-smartproxy.adoc b/guides/common/modules/con_managing-dns-by-using-smartproxy.adoc index 47e0e364c99..07c533193de 100644 --- a/guides/common/modules/con_managing-dns-by-using-smartproxy.adoc +++ b/guides/common/modules/con_managing-dns-by-using-smartproxy.adoc @@ -17,8 +17,8 @@ ifndef::satellite[] * `dns_libvirt` {endash} Dnsmasq DNS via libvirt API. For more information, see xref:configuring_dns_libvirt_{context}[]. endif::[] -* `dns_nsupdate` {endash} Dynamic DNS update by using nsupdate. -For more information, see {ProvisioningDocURL}Using_Infoblox_as_DHCP_and_DNS_Providers_provisioning[Using Infoblox as DHCP and DNS Providers] in _{ProvisioningDocTitle}_. +* `dns_nsupdate` {endash} Dynamic DNS update using nsupdate. +For more information, see xref:configuring_dns_nsupdate_{context}[]. * `dns_nsupdate_gss` {endash} Dynamic DNS update with GSS-TSIG. For more information, see xref:configuring-dynamic-dns-update-with-gss-tsig-authentication_{context}[]. ifndef::satellite[] diff --git a/guides/common/modules/proc_configuring-dns-nsupdate.adoc b/guides/common/modules/proc_configuring-dns-nsupdate.adoc new file mode 100644 index 00000000000..d968bb84a21 --- /dev/null +++ b/guides/common/modules/proc_configuring-dns-nsupdate.adoc @@ -0,0 +1,20 @@ +[id="configuring_dns_nsupdate_{context}"] += Configuring dns_nsupdate + +The _dns_nsupdate_ DNS provider manages DNS records using the `nsupdate` utility. +You can use _dns_nsupdate_ with any DNS server compatible with https://www.rfc-editor.org/rfc/rfc2136[RFC2136]. +By default, _dns_nsupdate_ installs the ISC BIND server. +For installation without ISC BIND, see xref:configuring-external-dns_{context}[]. + +.Procedure +* Configure `dns_nsupdate`: ++ +[options="nowrap", subs="+quotes,verbatim,attributes"] +---- +# {foreman-installer} \ +--foreman-proxy-dns true \ +--foreman-proxy-dns-provider nsupdate \ +--foreman-proxy-dns-managed true \ +--foreman-proxy-dns-zone _example.com_ \ +--foreman-proxy-dns-reverse _2.0.192.in-addr.arpa_ +----