This module makes it easy to create Google Cloud DNS zones of different types, and manage their records. It supports creating public, private, forwarding, peering, reverse_lookup and service directory zones.

The resources/services/activations/deletions that this module will create/trigger are:

• One google_dns_managed_zone for the zone
• Zero or more google_dns_record_set for the zone records

This module is meant for use with Terraform 0.13+ and tested using Terraform 1.0+. If you find incompatibilities using Terraform >=0.13, please open an issue. If you haven't upgraded and need a Terraform 0.12.x-compatible version of this module, the last released version intended for Terraform 0.12.x is v3.1.0.

Basic usage of this module for a private zone is as follows:

module "dns-private-zone" { source = "terraform-google-modules/cloud-dns/google" version = "4.0" project_id = "my-project" type = "private" name = "example-com" domain = "example.com." private_visibility_config_networks = [ "https://www.googleapis.com/compute/v1/projects/my-project/global/networks/my-vpc" ] recordsets = [ { name = "" type = "NS" ttl = 300 records = [ "127.0.0.1", ] }, { name = "localhost" type = "A" ttl = 300 records = [ "127.0.0.1", ] }, ] } 

Functional examples are included in the examples directory.

list(object({
 name = string
 type = string
 ttl = number
 records = optional(list(string), null)

 routing_policy = optional(object({
 wrr = optional(list(object({
 weight = number
 records = list(string)
 })), [])
 geo = optional(list(object({
 location = string
 records = list(string)
 })), [])
 }))
 }))

These sections describe requirements for using this module.

The following dependencies must be available:

• Terraform >= 0.13.0
• Terraform Provider for GCP plugin >= v4.40

User or service account credentials with the following roles must be used to provision the resources of this module:

• DNS Administrator: roles/dns.admin

The Project Factory module and the IAM module may be used in combination to provision a service account with the necessary roles applied.

A project with the following APIs enabled must be used to host the resources of this module:

• Google Cloud DNS API: dns.googleapis.com

The Project Factory module can be used to provision a project with the necessary APIs enabled.

Refer to the contribution guidelines for information on contributing to this module.