Document all DNS providers in the same chapter

[ekohl]

This takes the idea that there should be a central place with documentation on all DNS providers. Not spread over multiple guides.

It's not complete, but it moves forward with something I've raised multiple times. Most recently in https://github.com/theforeman/foreman-documentation/pull/2781#pullrequestreview-1884930522. I'd like to see a discussion on what should be the goal.

One possible goal is to also include "Configuring Smart Proxy server with external DNS" and keep it all in the Installing a Smart Proxy Server guide. That means we also need to include the DNS assembly in the Installing Server guide, but that would be (correctly) documenting what's possible.

Another is to move it all to its own guide and make the Installing Server/Proxy/Provisioning Hosts guides link to it when needed. That can also be done in multiple smaller steps.

Al of this can also be done for DHCP and we should be consistent. We should also discuss the "Configuring DNS, DHCP, and TFTP" chapter and what we want with it.

It includes https://github.com/theforeman/foreman-documentation/pull/2932 because I needed that for better readability.

• [x] I am familiar with the contributing guidelines.

Please cherry-pick my commits into:

• [ ] Foreman 3.10/Katello 4.12
• [ ] Foreman 3.9/Katello 4.11 (planned Satellite 6.15)
• [ ] Foreman 3.8/Katello 4.10
• [ ] Foreman 3.7/Katello 4.9 (Satellite 6.14)
• [ ] Foreman 3.6/Katello 4.8
• [ ] Foreman 3.5/Katello 4.7 (Satellite 6.13; orcharhino 6.6/6.7)
• [ ] Foreman 3.4/Katello 4.6 (EL8 only)
• [ ] Foreman 3.3/Katello 4.5 on EL7 & EL8 (Satellite 6.12 on EL8 only; orcharhino 6.4/6.5 on EL8 only)
• We do not accept PRs for Foreman older than 3.3.

[github-actions[bot]]

The PR preview for 809e85d101f11e8d959528d9894e6f26a96cbac8 could not be generated

[maximiliankolb]

FYI: there's a general agreement that we want to move forward with this :+1:

[ekohl]

I've opened https://github.com/theforeman/foreman-documentation/pull/3200 to at least handle the dns_nsupdate provider. Until that's merged, this is a draft.

@Lennonka would you be willing to look at moving Infoblox out of the provisioning hosts guide?

[Lennonka]

would you be willing to look at moving Infoblox out of the provisioning hosts guide?

Yes, I don't mind doing that. I would prefer to have a whole guide about configuring the networking services, so I will be able to move Infoblox afterwards. Right now, there isn't a good place to move it to :)

[ekohl]

I proposed a separate DNS guide in https://github.com/theforeman/foreman-documentation/issues/2957, but depending on how we shape it then it could also be more of a networking guide.

IMHO the path is to take this assembly and move it to a better place. Also make it obvious that it can be used on all servers that have a Smart Proxy (so also point to it with Installing Server).

[Lennonka]

Okay #3204

[maximiliankolb]

@ekohl Is this PR still relevant after https://github.com/theforeman/foreman-documentation/pull/3530?

[ekohl]

No, #3530 is the proper implementation of this.