dnsrec-template

A starting point for a new dnsrec (DNS Record Provider Protocol) provider. The SDK does the protocol work; you implement three methods against your DNS API.

Create a provider

1. Copy this directory to dnsrec-<service>.
2. In go.mod, rename the module to foundry.fsky.io/dnsrec/dnsrec-<service>.
3. In main.go, .goreleaser.yaml, and example.scfg, replace the dnsrec-example binary name and the example provider name.
4. Implement Add, Remove, and trim Capabilities to the record types your API supports. Keep both operations idempotent and preserve other records at the same owner.
5. Update this README and add the provider to the list in dnsrec/README.md.

Develop

The go.mod pins the published dnsrec SDK, so these pull it directly:

go test ./...
go build -o dnsrec-<service> .
./dnsrec-<service> capabilities

Release

Tag the repo vX.Y.Z (major tracks the protocol version) and run:

goreleaser release --clean

License

0BSD.