mirror of
https://github.com/StackExchange/dnscontrol.git
synced 2025-12-09 13:46:07 +08:00
1e67585e8f
Closes https://github.com/StackExchange/dnscontrol/issues/3787
This PR is adding a `HETZNER_V2` provider for the "new" Hetzner DNS API.
Testing:
- The integration tests are passing.
- Manual testing:
- `preview` (see diff for existing zone)
- `preview --populate-on-preview` (see full diff for newly created zone)
- `push` (see full diff; no diff after push)
- `push` (see full diff; no diff after push to newly created zone --
i.e. single pass and done)
```js
var REG_NONE = NewRegistrar('none')
var DSP = NewDnsProvider('HETZNER_V2')
D('testing-2025-11-14-7.dev', REG_NONE, DnsProvider(DSP),
A('@', '127.0.0.1')
)
```
<details>
```
# push for newly created zone
CONCURRENTLY checking for 1 zone(s)
SERIALLY checking for 0 zone(s)
Waiting for concurrent checking(s) to complete...DONE
******************** Domain: testing-2025-11-14-7.dev
1 correction (HETZNER_V2)
#1: Ensuring zone "testing-2025-11-14-7.dev" exists in "HETZNER_V2"
SUCCESS!
CONCURRENTLY gathering records of 1 zone(s)
SERIALLY gathering records of 0 zone(s)
Waiting for concurrent gathering(s) to complete...DONE
******************** Domain: testing-2025-11-14-7.dev
4 corrections (HETZNER_V2)
#1: ± MODIFY-TTL testing-2025-11-14-7.dev NS helium.ns.hetzner.de. ttl=(3600->300)
± MODIFY-TTL testing-2025-11-14-7.dev NS hydrogen.ns.hetzner.com. ttl=(3600->300)
± MODIFY-TTL testing-2025-11-14-7.dev NS oxygen.ns.hetzner.com. ttl=(3600->300)
SUCCESS!
#2: + CREATE testing-2025-11-14-7.dev A 127.0.0.1 ttl=300
SUCCESS!
Done. 5 corrections.
```
</details>
Feedback for @jooola and @LKaemmerling:
- The SDK was very useful in getting 80% there! Nice! 🎉
- Footgun:
- The `result` values are not "up-to-date" after waiting for an
`Action`, e.g. `Zone.AuthoritativeNameservers.Assigned` is not set when
`Client.Zone.Create()` returns and the following "wait" will not update
it.
- Taking a step back here: Waiting for an `Action` with a separate SDK
call does not seem very natural to me. Does the SDK-user need to know
that you are processing operations asynchronous? (Which seems like an
implementation detail to me, something that the SDK could abstrct over.)
Can `Client.Zone.Create()` return the final `Zone` instead of the
intermediate result?
- Features missing compared to the DNS Console, in priority order:
- It is no longer possible to remove your provided name servers from the
root/apex. Use-case: dual-home/multi-home zone with fewer than three
servers from Hetzner. I'm operating one of these and cannot migrate over
until this is fixed.
- Performance regression due to lack of bulk create/modify. E.g. [one of
the test
suites](a71b89e5a2/integrationTest/integration_test.go (L619))
spends about 4.5 minutes on making creating 100 record-sets and then
another 4 minutes for deleting them in sequence again. With your async
API, these are `create 2*100 + delete 2*100 = 400` API calls.
Previously, these were `create 1 + delete 100 = 101` API calls. Are you
planning on adding batch processing again?
- Usability nits
- Compared to other record-set based APIs, upserts for record-sets are
missing. This applies to records of a record-set and the ttl of the
record-set (see separate SDK calls for the cases `diff2.CREATE` vs
`diff2.CHANGE` and two calls in `diff2.CHANGE` for updating the TTL vs
records).
- Some SDK methods return an `Action` (e.g. `Zone.ChangeRRSetTTL()`),
others wrap the `Action` in a struct (`Client.Zone.CreateRRSet()`) --
even when the struct has a single field (`ZoneRRSetDeleteResult`).
---------
Co-authored-by: "Jonas L." <jooola@users.noreply.github.com>
Co-authored-by: "Lukas Kämmerling" <LKaemmerling@users.noreply.github.com>
Co-authored-by: Tom Limoncelli <6293917+tlimoncelli@users.noreply.github.com>
56 lines
1.7 KiB
Text
56 lines
1.7 KiB
Text
providers/adguardhome @ishanjain28
|
|
providers/akamaiedgedns @edglynes
|
|
providers/autodns @arnoschoon
|
|
providers/axfrddns @hnrgrgr
|
|
providers/azuredns @vatsalyagoel
|
|
providers/azureprivatedns @matthewmgamble
|
|
providers/bind @tlimoncelli
|
|
providers/bunnydns @ppmathis
|
|
providers/cloudflare @tresni
|
|
providers/cloudns @pragmaton
|
|
providers/cnr @KaiSchwarz-cnic
|
|
providers/cscglobal @mikenz
|
|
providers/desec @D3luxee
|
|
providers/digitalocean @chicks-net
|
|
providers/dnsimple @onlyhavecans
|
|
providers/dnsmadeeasy @vojtad
|
|
providers/doh @mikenz
|
|
providers/domainnameshop @SimenBai
|
|
providers/dynadot @e-im
|
|
providers/easyname @tresni
|
|
providers/exoscale @pierre-emmanuelJ
|
|
providers/fortigate @KlettIT
|
|
providers/gandiv5 @TomOnTime
|
|
providers/gcloud @riyadhalnur
|
|
providers/gcore @xddxdd
|
|
providers/hedns @rblenkinsopp
|
|
providers/hetzner @das7pad
|
|
providers/hetznerv2 @das7pad
|
|
providers/hexonet @KaiSchwarz-cnic
|
|
providers/hostingde @juliusrickert
|
|
providers/huaweicloud @huihuimoe
|
|
providers/internetbs @pragmaton
|
|
providers/inwx @patschi
|
|
providers/joker @atrull
|
|
providers/linode @koesie10
|
|
providers/loopia @systemcrash
|
|
providers/luadns @riku22
|
|
providers/mythicbeasts @tomfitzhenry
|
|
providers/namecheap @willpower232
|
|
# providers/namedotcom NEEDS VOLUNTEER
|
|
providers/netcup @kordianbruck
|
|
providers/netlify @SphericalKat
|
|
providers/ns1 @costasd
|
|
# providers/opensrs NEEDS VOLUNTEER
|
|
providers/oracle @kallsyms
|
|
providers/ovh @masterzen
|
|
providers/packetframe @hamptonmoore
|
|
providers/porkbun @imlonghao
|
|
providers/powerdns @jpbede
|
|
providers/realtimeregister @PJEilers
|
|
providers/route53 @tresni
|
|
providers/rwth @mistererwin
|
|
providers/sakuracloud @ttkzw
|
|
# providers/softlayer NEEDS VOLUNTEER
|
|
providers/transip @blackshadev
|
|
providers/vultr @pgaskin
|