terraform-provider-dynu/README.md

terraform-provider-dynu

A standalone Terraform provider for Dynu DNS and domain management.

Features

• Full CRUD for Dynu root domains via dynu_domain.
• Full CRUD for Dynu DNS records via dynu_dns_record.
• Read-only discovery data sources:
  • dynu_domains
  • dynu_domain
  • dynu_dns_records
• Provider authentication via explicit api_key configuration.

Important safety note

Deleting dynu_domain deletes the full Dynu DNS zone for that domain. Treat destroy plans carefully.

Minimal usage example

terraform {
  required_providers {
    dynu = {
      source  = "beatz174-bit/dynu"
      version = "~> 0.1.0"
    }
  }
}

provider "dynu" {
  api_key = var.dynu_api_key
}

variable "dynu_api_key" {
  type      = string
  sensitive = true
}

Resources

• dynu_domain
• dynu_dns_record

Data sources

• dynu_domains
• dynu_domain
• dynu_dns_records

Local development and dev overrides

For local development, use dev_overrides with a local build of this provider binary.

go build -o terraform-provider-dynu

~/.terraformrc:

provider_installation {
  dev_overrides {
    "beatz174-bit/dynu" = "/path/to/terraform-dynu-provider"
  }

  direct {}
}

Validate locally:

cd examples/read_only
cp terraform.tfvars.example terraform.tfvars
terraform validate
terraform plan

If provider code/config changes, rebuild terraform-provider-dynu before running Terraform again.

Testing

./scripts/fix.sh
./scripts/check.sh
go test ./...
go vet ./...
terraform fmt -check -recursive examples

Optional live acceptance tests

Live tests are opt-in and destructive for test records. They never run by default.

DYNU_ACC=1 \
DYNU_ACC_API_KEY="***" \
DYNU_ACC_TEST_DOMAIN="example.com" \
./scripts/testacc.sh --live

Use a disposable domain/subdomain only.

Release

• Terraform provider source address: beatz174-bit/dynu.
• Repository name must remain terraform-provider-dynu.
• Releases are triggered by pushing a semantic version tag such as v0.1.0.
• Required GitHub Actions secrets:
  • GPG_PRIVATE_KEY
  • PASSPHRASE
• Add the matching public GPG key to Terraform Registry before publishing, so signature verification succeeds.

Build a local stamped binary:

./build.sh v0.1.0

Create and push a release tag:

git tag v0.1.0
git push origin v0.1.0