terraform-provider-dynu/README.md

terraform-provider-dynu

Terraform provider for Dynu DNS using the Terraform Plugin Framework.

Current phase is read-only: this provider implements provider configuration and data sources only.

Features

• Provider configuration with API key authentication.
• Environment variable support (DYNU_API_KEY).
• Read-only data sources:
  • dynu_domains
  • dynu_domain
  • dynu_dns_records

Requirements

• Terraform >= 1.5
• Go >= 1.22 (for building)
• A Dynu API key

Provider configuration

provider "dynu" {
  api_key = var.dynu_api_key
}

You can also omit api_key and set DYNU_API_KEY in your environment.

Data sources

dynu_domains

Returns all DNS domains associated with the account.

data "dynu_domains" "all" {}

dynu_domain

Resolves the root domain from a hostname, then returns full domain details.

data "dynu_domain" "selected" {
  hostname = "www.example.com"
}

dynu_dns_records

Resolves the root domain from a hostname, then returns DNS records for that domain.

data "dynu_dns_records" "records" {
  hostname = "www.example.com"
}

Development

./codex/setup.sh
./codex/maintain.sh

Run tests:

go test ./...

Acceptance tests (requires live Dynu credentials):

TF_ACC=1 DYNU_API_KEY=... go test ./internal/provider -run TestAcc

Limitations

• No Terraform resources are implemented in this phase.
• No write operations are supported by provider code in this phase.