github DNSControl/dnscontrol v5.9.0

45 minutes ago

Greetings DNS fans!

Release highlights

  • NEW PROVIDER: DNSControl now supports IONOS! Thanks and welcome to @n-rodriguez who joins the project as its maintainer. We look forward to great things! (#5064)
  • print-ir and preview --ir finally round-trip again. This was broken in v5 and has finally been fixed. It could use more testing. (#5085)
  • D("../../example.com", ...) is no longer permitted. It shouldn't have worked before, but now its an error. #5091
  • BIG REFACTORING: Code that normalized and validated dnsconfig.js file data has been refactored to be cleaner and more maintainable.
    • Valid dnsconfig.js files should still work as before with no (intentional) changes in behavior. That said, it might be worthwhile doing a little extra testing before putting this into production. A simple "dnscontrol preview" should show no differences when compared to an earlier release.
    • Invalid dnsconfig.js files will see errors reported earlier in the pipeline (during "preview" instead of "push): Invalid CAA tags, invalid OPENPGPKEY keys, PTR records in the wrong zone
    • The following features generate DNS records that were never checked for errors. Now they are checked: SPF splitting, IMPORT_TRANSFORM and the A record transform metadata
    • Some error messages were output twice. Now they are only output once.

Valid dnsconfig.js files should see zero behavior changes. Apologies in advance if anything breaks. Please report all bugs or unexpected changes!

Thanks!

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

Sincerely,
--Tom Limoncelli

Monthly video call!

Everyone is invited to the Monthly DNSControl Community Video Conference Call on the 2nd Tuesday of each month. Join whether you are a new user with questions or an experienced developer that wants to discuss DNSControl internals... or anything in between! Meeting details on
GitHub Discussions.

Experimental: Try the new D() syntax!

Select credential entries directly with REGISTRAR() and SERVICE() in dnsconfig.js. The legacy syntax remains supported; this revision replaces the experimental PROVIDER()/DNS_SERVICE() syntax from v5.3.0. See the examples in the conversion guide. Please test it and share feedback!

Changelog

Provider-specific changes:

Bug fixes:

Refactoring:

Deprecation warnings

Warning

  • REV() will switch from RFC2317 to RFC4183 sometime after v5.0 is released. This is a breaking change. Warnings are output if your configuration is affected. See https://docs.dnscontrol.org/language-reference/top-level-functions/revcompat
  • NAMEDOTCOM, OPENSRS 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.

Install

macOS and Linux

Install with Homebrew (recommended)
brew trust --formula dnscontrol/tap/dnscontrol
brew install DNSControl/tap/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/dnscontrol/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/DNSControl/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/tap/dnscontrol

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

Verify downloads

This release ships two supply-chain guarantees:

  • checksums.txt.sigstore.json — a keyless cosign Sigstore bundle (signature, signing certificate, and transparency-log entry in one file) over checksums.txt, issued to this repo's release workflow. Since checksums.txt covers every release artifact, verifying it verifies your download transitively.
  • multiple.intoto.jsonl — SLSA Level 3 provenance for all release artifacts, generated by slsa-github-generator.
# Verify the checksums.txt signature (download checksums.txt and
# checksums.txt.sigstore.json first):
cosign verify-blob checksums.txt \
  --bundle checksums.txt.sigstore.json \
  --certificate-identity-regexp 'https://github\.com/DNSControl/dnscontrol/\.github/workflows/release_draft\.yml@refs/(tags|heads)/' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com

# Then check your download against checksums.txt:
Linux: sha256sum --ignore-missing -c checksums.txt
macOS: shasum -a 256 --ignore-missing -c checksums.txt

Don't miss a new dnscontrol release

NewReleases is sending notifications on new releases.