New release: dnscontrol v3.25.0

[Tom Limoncelli]

This release moves all documentation to a new format and continues to add support for the "diff2 algorithm" (still hidden behind a flag). Plus, many small bugs and documentation updates have been completed. Thanks to all contributors!

Documentation: This release moves all documentation to Gitbook under the URL https://docs.dnscontrol.org. The new format looks better and it is easier to find the information you need. The homepage remains on dnscontrol.org. This is all thanks to a huge effort by Jeffrey Cafferata who proposed the project, created the new format and migrated all the old information! Thank you, Jeffrey, for this major contribution to the project! We couldn't have done it without you! Next steps: If you find bugs, broken links, etc. please file a bug report or a PR.

Moving to diff2: This release continues to add support for the diff2 algorithm (still hidden behind the --diff2 flag).

• The following providers have gained support: AKAMAIEDGEDNS, EXOSCALE, GCLOUD, HOSTINGDE, LINODE, NAMECHEAP, NETCUP, NETLIFY, POWERDNS, VULTR.
• The following providers are still incomplete: AUTODNS, AZUREDNS, CLOUDFLARE, CLOUDNS, DESEC, DNSMADEEASY, HEXONET, PACKETFRAME, ROUTE53, RWTH, TRANSIP.

PLEASE try your usual dnscontrol preview and push commands with the --diff2 flag and report any bugs. This code will become the default in a few months.

Changelog

diff2-related changes:

Current status is tracked in #1854

• 22c6797: AKAMAIEDGEDNS: Adopt diff2 in compatibility mode (#1872) (@tlimoncelli)
• 43af16a: EXOSCALE: Adopt diff2 in compatibility mode (#1881) (@tlimoncelli)
• cb88bdd: GCLOUD: Adopt diff2 in compatibility mode (#1982) (@tlimoncelli)
• 8c8d08b: HOSTINGDE: Adopt diff2 in compatibility mode (#1890) (@tlimoncelli)
• b6ee716: LINODE: Adopt diff2 in compatibility mode (#1892) (@tlimoncelli)
• 77df64d: NAMECHEAP: Adopt diff2 in compatibility mode (#1894) (@tlimoncelli)
• 572f2ce: NETCUP: Adopt diff2 in compatibility mode (#1895) (@tlimoncelli)
• b4cbd12: POWERDNS: Adopt diff2 in compatibility mode (#1899) (@tlimoncelli)
• 8f09e3b: VULTR: Adopt diff2 in compatibility mode and fix handling of some integrations tests (#1981) (@androw)
• 02431b5: NETLIFY: Adopt diff2 in compatibility mode (#1896) (@tlimoncelli)

Provider-specific changes:

• 4d7a43d: CLOUDFLARE: DOCS: Clarify API key instructions (#1959) (@tlimoncelli)
• a1b24a2: GANDI_V5: Temporarily disable ListDomains (#1962) (@tlimoncelli)
• 83b4a30: HOSTINGDE: Add simple exponential back-off retry (#1937) (@juliusrickert)
• 8344f5c: HOSTINGDE: BUG: PTR records aren't working (#1946) (@juliusrickert)
• 2ebdda6: HOSTINGDE: Fix & simplify string quoting (#1945) (@juliusrickert)
• 261961c: NETCUP: Handle CNAMEs with a single @ as destination correctly (#1947) (@kordianbruck)
• b9b35d5: TRANSIP: Implementation get-zones all (#1980) (@cafferata)
• 178ec45: VULTR: fix failing integration tests (#1956) (@androw)

Other changes and improvements:

• 3a7b150: BUG: TypeScript typing: Renamed directory (#1979) (@cafferata)
• 810eed0: BUG: TypeScript typing: missing parameter (#1970) (@cafferata)
• 97d9c58: BUILD SYSTEM: Skip unused integration tests faster (#1939) (@cdhunt)
• f4388dd: CHORE: Fix broken merge (#1957) (@tlimoncelli)
• 9bb38c4: CHORE: Remove references to TXTMulti (#1953) (@tlimoncelli)
• 3a6b488: CHORE: Update deps (#1984) (@tlimoncelli)
• c1532d9: CORE: Fix matrix generator (#1958) (@tlimoncelli)
• 03d782d: Create CNAME (@tlimoncelli)
• ec1d91a: DEV: Disable CodeQL (#1977) (@tlimoncelli)
• 1ab73aa: DOCS: Clarify BYO CCI (#1951) (@tlimoncelli)
• 035455e: DOCS: Fix release engineering docs (#1949) (@j-f1)
• f912b15: DOCS: Migrated documentation website to Gitbook (#1809) (@cafferata)
• 437dc5f: DOCS: Organize the assets by page or provider (#1964) (@cafferata)
• aed4197: DOCS: Renamed directory docs to documentation (#1966) (@cafferata)
• 1ea69eb: DOCS: Revise typescript docs to be user-centric (#1940) (@tlimoncelli)
• 9bda481: DOCS: Typo Dnscontrol = DNSControl. (#1969) (@cafferata)
• c74a527: DOCS: [CAA] General improvements (#1971) (@cafferata)
• 35105a0: DOCS: [Cloudflare] Example permissions configuration image (#1963) (@cafferata)
• d532607: DOCS: [DEFAULTS] General improvements (#1968) (@cafferata)
• 7fe9e91: DOCS: [Gitlab CI/CD] Corrected the bad asset URLs. (#1965) (@cafferata)
• 4c3583c: Domains flag should accept simple wildcards (#1983) (@tlimoncelli)
• 9b3ad81: Embed types-dnscontrol.d.ts into the binary instead of fetching it via HTTP (#1942) (@j-f1)
• 81f75ed: Fix GitHub Pages build failure (#1941) (@j-f1)
• e73982c: NETLIFY: Fix TXT record handling (#1955) (@SphericalKat)
• 32c7703: get-zones: improve error message for unsupported providers (#1978) (@tlimoncelli)

Deprecation warnings (updated 2023-01-18)

• Call for new volunteer maintainers for NAMECHEAP, NAMEDOTCOM, and SOFTLAYER. 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. If a new maintainer is not found soon, the provider may be disabled.
• ACME/Let's Encrypt support is frozen and will be removed after December 31, 2022. The get-certs command (renews certs via Let's Encrypt) has no maintainer. There are other projects that do a better job. If you don't use this feature, please do not start. If you do use this feature, please plan on migrating to something else. See discussion in issues/1400
• get-zones syntax changes in v3.16 Starting in v3.16, the command line arguments for dnscontrol get-zones changes. For backwards compatibility change provider to -. See documentation for details.

--

Tom Limoncelli (he/him)
SRE TPM, Stack Overflow, Inc.