adamyager/terraform-azurerm-dns

Azure DNS Recordsets Module

This module manages DNS recordsets in a given Azure DNS zone. It is part of the terraformdns project.

Example Usage

resource "azurerm_resource_group" "example" {
  name     = "terraformdns-example"
  location = "West US"
}

resource "azurerm_dns_zone" "example" {
  resource_group_name = azurerm_resource_group.example.name

  name = "example.com"
}

module "dns_records" {
  source = "terraformdns/dns-recordsets/azurerm"

  resource_group_name = azurerm_dns_zone.example.resource_group_name
  dns_zone_name       = azurerm_dns_zone.example.name
  recordsets = [
    {
      name    = "www"
      type    = "A"
      ttl     = 3600
      records = [
        "192.0.2.56",
      ]
    },
    {
      name    = ""
      type    = "MX"
      ttl     = 3600
      records = [
        "1 mail1",
        "5 mail2",
        "5 mail3",
      ]
    },
    {
      name    = ""
      type    = "TXT"
      ttl     = 3600
      records = [
        "\"v=spf1 ip4:192.0.2.3 include:backoff.${aws_route53_zone.example.name} -all\"",
      ]
    },
    {
      name    = "_sip._tcp"
      type    = "SRV"
      ttl     = 3600
      records = [
        "10 60 5060 sip1",
        "10 20 5060 sip2",
        "10 20 5060 sip3",
        "20  0 5060 sip4",
      ]
    },
  ]
}

Compatibility

When using this module, always use a version constraint that constraints to at least a single major version. Future major versions may have new or different required arguments, and may use a different internal structure that could cause recordsets to be removed and replaced by the next plan.

Arguments

• resource_group_name is the name of the resource group that contains the DNS zone where the records will be added.
• dns_zone_name is the name of the DNS zone within the given resource group where the records will be added.
• recordsets is a list of DNS recordsets in the standard terraformdns recordset format.

This module requires the azurerm provider.

Due to current limitations of the Terraform language, recordsets in Azure DNS are correlated to recordsets elements using the index into the recordsets list. Adding or removing records from the list will therefore cause this module to also update all records with indices greater than where the addition or removal was made.

Limitations

This module supports only the following DNS record types, due to limitations of the underlying Terraform provider:

• A and AAAA
• CNAME
• MX
• NS
• PTR
• SRV
• TXT