# Terraform module to create DNS zone or record

## Example for main.tf

```tf
locals {
  stackit_project_id = "fb06b3bf-70b6-45bf-b1a4-e84708b26f92"
  region             = "eu01"
  env                = "dev"
}

module "dns" {
  source     = "git::https://commerce-platform.git.onstackit.cloud/commerce-platform-public//terraform-modules/dns"
  project_id = "my-stackit-project-id"

  zone_name  = "example-zone"
  dns_name   = "example.com"

  contact_email = "admin@example.com"
  description   = "Main DNS zone - managed via Terraform"
  default_ttl   = 3600

  record_name  = "www.example.com"
  record_type  = "A"
  records      = ["192.0.29.1"]
  ttl          = 3600
  comment      = "My example records - managed by Terraform"
}
```

## Usage Options

### Use an Existing DNS Zone

#### If you already have a DNS zone created in STACKIT, simply provide the `zone_id`:

```hcl
module "dns" {
  source     = "git::https://commerce-platform.git.onstackit.cloud/commerce-platform-public//terraform-modules/dns"
  project_id = "your-project-id"

  zone_id     = "preexisting-zone-id"
  record_name = "www.example.com"
  record_type = "A"
  records     = ["192.0.29.1"]
}
```