Work in Progress
This project is intended to be an ACME DNS01 webhook solver for cert-manager. It is not yet ready for use.
As the project & adoption has grown, there has been an influx of DNS provider pull requests to our core codebase. As this number has grown, the test matrix has become un-maintainable and so, it's not possible for us to certify that providers work to a sufficient level.
By creating this 'interface' between cert-manager and DNS providers, we allow users to quickly iterate and test out new integrations, and then packaging those up themselves as 'extensions' to cert-manager.
We can also then provide a standardised 'testing framework', or set of conformance tests, which allow us to validate that a DNS provider works as expected.
All DNS providers must run the DNS01 provider conformance testing suite, else they will have undetermined behaviour when used with cert-manager.
It is essential that you configure and run the test suite when creating a DNS01 webhook.
An example Go test file has been provided in main_test.go.
You can run the test suite with:
$ TEST_ZONE_NAME=example.com. make testThe example file has a number of areas you must fill in and replace with your own options in order for tests to pass.