New release: dnscontrol v3.21.0

[Tom Limoncelli]

https://github.com/StackExchange/dnscontrol/releases/tag/v3.21.0

This release contains no major features or new providers. However it
cleans up a number of bugs, standardizes a ton of documentation
issues, and has been updated to use newer dependencies and APIs.
There are small improvements to the `check` and `get-zones`
subcommands. The integration tests have been optimized: they now run
significantly faster for most providers.

### Highlights

* In an effort to better support CI/CD pipelines, `dnscontrol check`
now reports problems to stdout, not stderr. These same problems are
still reported to stderr by `dnscontrol preview` and `dnscontrol
push`.
* `dnscontrol get-zones` deals with CNAMEs at the apex better by
including a comment warning that manual editing may be required.
* Shout out to @cafferata for combing through the documentation to
find and fix many errors and inconsistencies. The documentation now
includes a table of contents for the DSL language features and works
much better on mobile platforms.
* The documentation now includes examples of doing DNS updates via a
CI/CD pipeline a.k.a. the [GitOps
pattern](https://queue.acm.org/detail.cfm?id=3237207).
* The JavaScript interpreter
([otto](https://github.com/robertkrimen/otto)) has been upgraded from
the 2021-10-24 release to the 2022-10-25 release. This has many
stability improvements and no compatibility issues (we hope!)
* DESEC's authentication is improved. DIGITALOCEAN's CAA
implementation supports semicolons. DNSIMPLE, EXOSCALE, and VULTR now
support their newer APIs.

### Breaking changes

* The above-mentioned change to `dnscontrol check` may break some
pipelines. Please verify after upgrading. More likely these pipelines
are redirecting stderr to stdout which is no longer needed.

## Changelog

### Major features:
* b821f4914fd9ee2b6b31fb23387de35284585a55: FEATURE: "check"
subcommand should send to stdout (#1755) (@tlimoncelli)
* 391622ff55fa96a9616c58ff35421e948234038f: FEATURE: get-zones now
outputs a comment about CNAMEs at apex (#1732) (@tlimoncelli)
* ee2c7adb059a491c12f76574e5eb90d2121cbcfa: FEATURE: Added a
tutorial/example of a Gitlab CI/CD setup to the documentation. (#1766)
(@cafferata)

### Provider-specific changes:
* 639a4473d7593838dd4593c0c50198aada3702a4: DESEC: Check
authentication via domains API (#1723) (@glueckself)
* 49590df8bf491908093d68d7ac4c9a5a3de10c37: DIGITALOCEAN: semicolon as
CAA target is now supported (#1749) (@tresni)
* 1c726a08ad3e4481fc29355463fca95acf124ec4: DNSimple: Update to 1.0.0
Client & expose error attributes (#1756) (@onlyhavecans)
* 128e07506624ed66eefb223919178f13afb83982: EXOSCALE: Migrate to v2
API (#1748) (@kobajagi)
* 2898fbad727dac3abe8a9d3505ff30be400a19e4: VULTR: use API v2 (#1768) (@androw)

### Other changes and improvements:
* 61e500b7dc0ffa5039ca7fb62abca9c446a02778: DEV: Optimize integration
tests (#1742) (@tlimoncelli)
* b66af29aec391e58ed64fd3a66b7bda97c94cf2e: BUG: Re-introducing the
`cloudflare/cloudflare-go` import (#1795) (@cafferata)
* 3743c7de031f5d5d3d35c3734f337357f7cf5877: Bump
cloudflare/cloudflare-go from 0.46 to 0.49 (#1746) (@tlimoncelli)
* dea94665e8b297baf040c15b7fd1161dfbc0dfe5: CHORE: Bump
bruceadams/get-release from 1.2.3 to 1.3.1 (#1772) (@dependabot[bot])
* 010ba5682af0af99d65ae79737bd38fb9cf834ac: CHORE: Bump
bruceadams/get-release from 1.3.1 to 1.3.2 (#1797) (@dependabot[bot])
* 944b702edeb326cdee8036d42aef057d29387355: CHORE: Bump
github.com/aws/aws-sdk-go-v2/service/route53 from 1.21.7 to 1.21.9
(#1734) (@dependabot[bot])
* 505e021054c80979a5225038af33138ebdfe493b: CHORE: Bump
github.com/urfave/cli/v2 from 2.11.2 to 2.14.0 (#1737)
(@dependabot[bot])
* 4328c8033577c82d35ff7641f07ea38f9c762fa5: CHORE: Update dependencies
of providers with automated tests (#1743) (@tlimoncelli)
* c56002e835de22da7a9af1d4ffa8408bf654bb07: CHORE: Update deps (#1754)
(@tlimoncelli)
* da17a54cdb2abe004febc1d81c0f9eda3ced0350: CHORE: Update deps (@tlimoncelli)
* dc86519365bdd3a09fe98f2b69d90f83413f6afa: CHORE: Update deps that
have automated tests (#1801) (@tlimoncelli)
* ab026c31cd8ac34cbf183723daf6e3fa77a5678b: CHORE: Upgrade otto
release (#1774) (@tlimoncelli)
* fc678d8820ee8aa05814a0bb0f74f2ceb53b98a1: DOC: Split the Google
Workspace example (#1796) (@cafferata)
* c9b166ff0f4b8d3af1eeb8585d1e3aece21d9771: DOCS: Add MacPorts to
Install section (#1729) (@ajhall)
* 1a94ab6b23eaafe73cd8d5cb38f404dd21b31f4f: DOCS: Add a dynamic macro
example (Fastmail) (#1759) (@tlimoncelli)
* 5ba66fac52ebdcd587a4c0e257ff63e7a28057e2: DOCS: Add missing record
modifiers (#1793) (@cafferata)
* ffdb4b62716fe36970e665612308c9f9850c1462: DOCS: Add page for how to
maintain docs (#1780) (@tlimoncelli)
* cc433fd1048d829537852d40122d40d84a5b9a14: DOCS: Added link to the
alternative GitHub action (#1802) (@tarampampam)
* cd80a7f157cc17fa2bab77faed89cedadf04171c: DOCS: Aligned/improved
installation section package manager (#1788) (@cafferata)
* fd42485d7db032eba9527177ebc2dc291d2ceb3e: DOCS: Automatically make a
table of contents (TOC) (#1778) (@cafferata)
* 490db87ce6f22ff13a266f95cbef33e3f59c31aa: DOCS: Clarify IPv6
variables are strings (#1775) (@tlimoncelli)
* 705e3a03ab3f477c9ba52fb5181247ae280a3e4f: DOCS: Clarify Jekyll
documentation (#1790) (@cafferata)
* b3e684326a11449a0c9e900ca0293873c6727755: DOCS: Clean up formatting
and punctuation (#1776) (@cafferata)
* a18710b28491507ba96fd257e33a23ffccf8abe9: DOCS: Clean up old docs
and scripts (#1728) (@tlimoncelli)
* c6011fe3f8c7b21032fea51a5b0ea9fdd146e9c7: DOCS: Converted README.txt
to .gitkeep (#1785) (@cafferata)
* 27ec220814496c3aef8527779d9388539fdf04e8: DOCS: Correct closing
parens in AXFRDDNS doc (#1752) (@tlimoncelli)
* 3f760cdd2541c1f894153fc272e02342062e6498: DOCS: Documentation
improvements (#1786) (@cafferata)
* 67bbbb35965c2c1225f17c7c1cbc5de4802760c0: DOCS: Fix DSL table of
contents (#1783) (@cafferata)
* b968cd694da17848e27669325f48c0d68a271272: DOCS: Fix dns.he.net link
(#1758) (@Firefishy)
* 1aca045d5b559edce0ac1d648e659b2273fa4e80: DOCS: Fix many small typos
(#1794) (@tlimoncelli)
* dad1d4c2c5a5013263bff9a98e8ef289e74564ec: DOCS: Fixed typo
"deprecation" (#1739) (@cafferata)
* 975463ef33b02e02233568d9ad42f7adc4a73ecb: DOCS: Increase provider
number (#1804) (@cafferata)
* ae1eb970f558d9e6c0a9af1b5754cc90ba873a5d: DOCS: Inline
creds.json.tpl-example.txt example (#1784) (@cafferata)
* e95c122c48fb8869007231650bd04a9131400cae: DOCS: Merge toc and index
(#1789) (@cafferata)
* eb809cd0264e365ad075c730348f27123cc7fa28: DOCS: Provider TransIP
improvements (#1791) (@cafferata)
* 2f50c740f9d0580ec24d5b0337f1563e2e2ede1e: DOCS: Updated Go Package
URL's to latest version (#1803) (@cafferata)
* c6851c9d7f3b9f7a340625c9adf8a477c8d94f3e: DOCS: fix default_ns
example for hosting.de (#1750) (@saz)
* 46b742d09f67646c2b33937f254c1c73b6bb3383: DOCS: fix docker usage in
"Getting Started" (#1767) (@saz)
* ad8f4363300bf935ed07cd3dd51a8ef1c5e46b26: DOCS: fix docker usage in
README (#1751) (@saz)
* e9f4200739c79eb3f1cd45ba245bb01feb08e2b5: Update deps (#1747) (@tlimoncelli)
* 39aa55368635066f8624177379efd4dfbe21b7a7: Update deps (#1773) (@tlimoncelli)


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