Skip to content

quite4work/terraform-provider-cloudns

Folders and files

NameName
Last commit message
Last commit date

Latest commit

9cc65b4 · Dec 2, 2022
Dec 2, 2022
Jul 19, 2022
Mar 3, 2022
Oct 24, 2022
Dec 10, 2020
Feb 28, 2022
Oct 13, 2022
Oct 31, 2017
Mar 18, 2020
Oct 31, 2017
Feb 28, 2022
Dec 2, 2022
Dec 2, 2022
Feb 28, 2022
Feb 27, 2022

Repository files navigation

Terraform Provider ClouDNS

Requirements

  • Terraform >= 1.1.x (older versions may work but are entirely untested)
  • Go >= 1.15
  • ClouDNS API credentials and a pre-existing DNS zone manageable by the user/sub-user associated with said credentials

Building The Provider

  1. Clone the repository
  2. Enter the repository directory
  3. Build the provider using the Go install command:
$ go install

Adding Dependencies

This provider uses Go modules. Please see the Go documentation for the most up to date information about using Go modules.

To add a new dependency github.com/author/dependency to your Terraform provider:

go get github.com/author/dependency
go mod tidy

Then commit the changes to go.mod and go.sum.

Using the provider

Ensure that you have an API user/sub-user on ClouDNS (requires a paid subscription with reseller access).

Note that using a sub-user which you delegate a specific zone to is a much safer approach and should always be your first choice

Once that is done, you must pre-create the zones you will want to manage on ClouDNS side (technically they are manageable through the API)

Limitations

The following features are knowingly not part of the provider's initial implementation:

  • Zone management
  • Complex records (anything using optional parameters here)

The main reason is that I find writing Golang extremely unpleasant and would rather avoid doing more of it than strictly necessary.

Please feel free to contribute features however; we will happily review and merge them.

Developing the Provider

If you wish to work on the provider, you'll first need Go installed on your machine (see Requirements above).

To compile the provider, run go install. This will build the provider and put the provider binary in the $GOPATH/bin directory.

To generate or update documentation, run go generate.

In order to run the full suite of Acceptance tests, run make testacc.

Note: Acceptance tests create real resources, and often cost money to run.

$ CLOUDNS_SUB_AUTH_ID=1234 CLOUDNS_PASSWORD=verysecret CLOUDNS_ACCEPTANCE_TESTS_ZONE=some-test-zone.net make testacc

Packages

No packages published

Languages

  • Go 99.5%
  • Makefile 0.5%