v4.21.0

[tlimoncelli]

Greetings, DNS fans!

What's new? GCORE and NS1 now handle zone creation and listing better. I'm also excited to announce the new "providers page" (which is auto-generated). It is much more readable. Many people were involved in this change, with @chicks-net taking the lead and writing the code. View the results here: https://docs.dnscontrol.org/provider/index

There were many documentation updates and bugfixes.

Reminder: get-certs (cert renewals) and the MSDNS provider are scheduled to be removed in July 2025. See below.

Thanks to all contributors involved in this release! This is a community project and we couldn't do it without all our contributors!

Sincerely,
Tom

Changelog

Provider-specific changes:

• cdbd540: GANDI_V5: BUGFIX: Uppercase labels fail to update (GANDI_V5: BUGFIX: Uppercase labels fail to update #3582) (@tlimoncelli)
• 113c1ac: GCORE: Implement ListZones to allow auto create zones (GCORE: Implement ListZones to allow auto create zones #3588) (@xddxdd)
• 08a6af8: NS1: Add missing ListZones() (NS1: Add missing ListZones() #3600) (@costasd)

Documentation:

• 87cd4f4: DOCS: generate smaller tables for feature matrix (2nd try) (DOCS: generate smaller tables for feature matrix (2nd try) #3589) (@chicks-net)
• 8c69cee: DOCS: Update providers and registrars list to latest (DOCS: Update providers and registrars list to latest #3580) (@matteotrubini)
• 52e7caa: DOCS: Update reference to providers index in PR submission checklist (DOCS: Update reference to providers index in PR submission checklist #3575) (@jbelien)
• e140acb: CNR: Update docs with proper Nameserver example (CNR: Update docs with proper Nameserver example #3592) (@mejofi)
• 6e96b76: DOCS: Add Porkbun as supported registrar and update usage examples (DOCS: Add Porkbun as supported registrar and update usage examples #3578) (@matteotrubini)
• 1d148f4: DOCS: document redirect types (DOCS: document redirect types #3585) (@willpower232)

CI/CD:

• c32432e: BUILD: GoReleaser changelog dependencies regex (BUILD: GoReleaser changelog dependencies regex #3593) (@cafferata)
• 75a66e4: Build(deps): Bump alpine from 3.21.3 to 3.22.0 (Build(deps): Bump alpine from 3.21.3 to 3.22.0 #3599) (@dependabot[bot])
• bf5a425: Build(deps): Bump github.com/Azure/azure-sdk-for-go/sdk/azidentity from 1.9.0 to 1.10.0 (Build(deps): Bump github.com/Azure/azure-sdk-for-go/sdk/azidentity from 1.9.0 to 1.10.0 #3595) (@dependabot[bot])
• d7d5a6b: Build(deps): Bump github.com/digitalocean/godo from 1.146.1 to 1.150.0 (Build(deps): Bump github.com/digitalocean/godo from 1.146.1 to 1.150.0 #3596) (@dependabot[bot])
• b7df6d5: Build(deps): Bump github.com/huaweicloud/huaweicloud-sdk-go-v3 from 0.1.148 to 0.1.152 (Build(deps): Bump github.com/huaweicloud/huaweicloud-sdk-go-v3 from 0.1.148 to 0.1.152 #3598) (@dependabot[bot])
• cffa7e4: Build(deps): Bump github.com/mittwald/go-powerdns from 0.6.6 to 0.6.7 (Build(deps): Bump github.com/mittwald/go-powerdns from 0.6.6 to 0.6.7 #3594) (@dependabot[bot])
• 9af2e8a: Build(deps): Bump github.com/oracle/oci-go-sdk/v65 from 65.91.0 to 65.92.0 (Build(deps): Bump github.com/oracle/oci-go-sdk/v65 from 65.91.0 to 65.92.0 #3597) (@dependabot[bot])
• 437e46f: Build(deps): Bump tar-fs from 3.0.8 to 3.0.9 (Build(deps): Bump tar-fs from 3.0.8 to 3.0.9 #3601) (@dependabot[bot])

Dependencies:

• 217f410: CHORE: Update dependencies (CHORE: Update dependencies #3602) (@tlimoncelli)
• df7bf9f: CHORE: Update dependencies (CHORE: Update dependencies #3604) (@tlimoncelli)

Deprecation warnings

Warning

• REV() will switch from RFC2317 to RFC4183 in v5.0. This is a breaking change. Warnings are output if your configuration is affected. No date has been announced for v5.0. See https://docs.dnscontrol.org/language-reference/top-level-functions/revcompat
• MSDNS maintainer needed! Without a new volunteer, this DNS provider will lose support after April 2025. See New maintainer for MSDNS needed! #2878
• NAMEDOTCOM and SOFTLAYER need maintainers! These providers have no maintainer. Maintainers respond to PRs and fix bugs in a timely manner, and try to stay on top of protocol changes.
• get-certs/ACME support is frozen and will be removed without notice between now and July 2025. It has been unsupported since December 2022. If you don't use this feature, do not start. If you do use this feature, migrate ASAP. See discussion in issues/1400

Install

macOS and Linux

Install with Homebrew (recommended)

brew install dnscontrol

Using with Docker

You can use the Docker image from Docker hub or GitHub Container Registry.

docker run --rm -it -v "$(pwd):/dns" ghcr.io/stackexchange/dnscontrol preview

Anywhere else

Alternatively, you can install the latest binary (or the apt/rpm/deb/archlinux package) from this page.

Or, if you have Go installed, you can install the latest version of DNSControl with the following command:

go install github.com/StackExchange/dnscontrol/v4@main

Update

Update to the latest version depends on how you choose to install dnscontrol on your machine.

Update with Homebrew

brew upgrade dnscontrol

Alternatively, you can grab the latest binary (or the apt/rpm/deb package) from this page.

---

This discussion was created from the release v4.21.0.

[willpower232]

The providers page looks awesome, what are the odds of getting a position sticky on those table headers to help with their incredible length?

[chicks-net]

This sounds doable. I'm also going to fix the table headings going to github instead of staying within the docs site.

[willpower232]

Thank you for your efforts! Holler if you need a tester

[chicks-net]

#3607 for anybody that wants to follow along.

[chicks-net]

#3619 should fix this.