terraform-provider-mxroute

README

terraform-provider-mxroute

Terraform provider for MXRoute, built on the MXRoute REST API.

Authentication

Generate an API key at panel.mxroute.com/api-keys.php and configure the provider with three values, either as arguments or via environment variables (MXROUTE_SERVER, MXROUTE_USERNAME, MXROUTE_APIKEY).

provider "mxroute" {
  server   = "eagle.mxlogin.com"
  username = "myusername"
  apikey   = "..."
}

resource "mxroute_domain" "example" {
  name         = "example.com"
  mail_hosting = true
}

Development

go build ./...
go test ./...

Acceptance tests hit the live API and need TF_ACC=1 plus credentials:

export MXROUTE_SERVER=eagle.mxlogin.com
export MXROUTE_USERNAME=myusername
export MXROUTE_APIKEY=...
export MXROUTE_TEST_DOMAIN=test.example.com
TF_ACC=1 go test ./internal/provider/... -timeout 30m

Documentation under docs/ is regenerated from schema and examples with go generate ./....

License

MIT