Repository navigation
Greetings DNS fans!
This is mostly (another) refactoring release. A lot of redundant code was removed. Please test before rolling out into production. Verify that dnscontrol preview output is the same as the previous release.
Other changes: Cloudflare now supports OPENPGPKEY (#5096), SPF handling is now case insensitive (#5094), delegation updates work better when zones need to be created (#5097), and the big news is that @chicks-net reworked the format of Support Record Types and it looks a million times better! Thanks!
Due to the upcoming U.S. holidays, there will probably be only a few releases between now and January 1.
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.
Changelog
Provider-specific changes:
- 43c31d1: feat(p/CLOUDFLAREAPI): enable OPENPGPKEY support (#5096) (@TomOnTime)
- df0698d: fix(p/AZURE_PRIVATE_DNS): mark AZURE_ALIAS as not supported (#5119) (@TomOnTime)
- eeb466a: refactor(p/CLOUDNS): fix golint warnings (#5116) (@TomOnTime)
- 1adf8ae: refactor(p/OPENWRT): fix golint warnings (#5117) (@TomOnTime)
New features:
- 9a79c01: feat(docs): new format for provider "supported record types" list (#5075) (@chicks-net)
Bug fixes:
- c3db94d: fix(preview): skip delegation check when a zone is pending creation (#5097) (@TomOnTime)
- 0087e70: fix(spflib): parse SPF mechanism names case-insensitively (#5094) (@Kernel-Hunter)
- 0c7e95d: fix: reject empty and handle absolute labels in D_EXTEND() (#5104) (@TomOnTime)
Documentation:
- c8e731f: docs: Note about refactoring preview (#5114) (@TomOnTime)
CI/CD:
- 0e98ff4: build(deps): bump step-security/harden-runner from 2.22.3 to 2.22.4 (#5120) (@dependabot[bot])
Refactoring:
- 0eb2b66: refactor(netbird): remove redundant record type check from AuditRecords (#5110) (@TomOnTime)
- 2790b46: refactor: add missing code comments (#5112) (@TomOnTime)
- 7805cc8: refactor: check obsolete metadata when importing dnsconfig.js records (#5102) (@TomOnTime)
- 4852a71: refactor: check repeated-domain labels only at record creation (#5103) (@TomOnTime)
- 30a622f: refactor: fix golint warnings (#5115) (@TomOnTime)
- 853bfbf: refactor: move LUA rtype checking to MakeLUA (#5101) (@TomOnTime)
- 18bed76: refactor: move SOA/TLSA/SMIMEA checks to makers.go (#5098) (@TomOnTime)
- 2cd670c: refactor: move target character checking to mustbe.TargetHost (#5099) (@TomOnTime)
- b01ebf7: refactor: remove checkFQDNs (#5108) (@TomOnTime)
- 51b3c4b: refactor: remove record type checks from AuditRecords made redundant by SupportedTypes (#5113) (@TomOnTime)
- 5beada3: refactor: remove redundant default case from checkTargets (#5107) (@TomOnTime)
- 3856db6: refactor: remove unreachable IMPORT_TRANSFORM case from checkTargets (#5106) (@TomOnTime)
- d7b7818: refactor: remove unreachable empty/trailing-dot label checks (#5105) (@TomOnTime)
- a993618: refactor: rename processSplitHorizonDomains to checkUniqueDomainNames (#5109) (@TomOnTime)
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/dnscontrolUsing 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 previewAnywhere 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@mainUpdate
Update to the latest version depends on how you choose to install dnscontrol on your machine.
Update with Homebrew
brew upgrade DNSControl/tap/dnscontrolAlternatively, 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) overchecksums.txt, issued to this repo's release workflow. Sincechecksums.txtcovers 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