91 lines
3.9 KiB
Markdown
91 lines
3.9 KiB
Markdown
# Google Cloud DNS Module
|
|
|
|
This module allows simple management of Google Cloud DNS zones and records. It supports creating public, private, forwarding, peering and service directory based zones.
|
|
|
|
For DNSSEC configuration, refer to the [`dns_managed_zone` documentation](https://www.terraform.io/docs/providers/google/r/dns_managed_zone.html#dnssec_config).
|
|
|
|
## Examples
|
|
|
|
### Private Zone
|
|
|
|
```hcl
|
|
module "private-dns" {
|
|
source = "./modules/dns"
|
|
project_id = "myproject"
|
|
type = "private"
|
|
name = "test-example"
|
|
domain = "test.example."
|
|
client_networks = [var.vpc.self_link]
|
|
recordsets = {
|
|
"A localhost" = { type = "A", ttl = 300, records = ["127.0.0.1"] }
|
|
}
|
|
}
|
|
# tftest:modules=1:resources=2
|
|
```
|
|
|
|
### Forwarding Zone
|
|
|
|
```hcl
|
|
module "private-dns" {
|
|
source = "./modules/dns"
|
|
project_id = "myproject"
|
|
type = "forwarding"
|
|
name = "test-example"
|
|
domain = "test.example."
|
|
client_networks = [var.vpc.self_link]
|
|
forwarders = { "10.0.1.1" = null, "1.2.3.4" = "private" }
|
|
}
|
|
# tftest:modules=1:resources=1
|
|
```
|
|
|
|
### Peering Zone
|
|
|
|
```hcl
|
|
module "private-dns" {
|
|
source = "./modules/dns"
|
|
project_id = "myproject"
|
|
type = "peering"
|
|
name = "test-example"
|
|
domain = "test.example."
|
|
client_networks = [var.vpc.self_link]
|
|
peer_network = var.vpc2.self_link
|
|
}
|
|
# tftest:modules=1:resources=1
|
|
```
|
|
|
|
|
|
<!-- BEGIN TFDOC -->
|
|
|
|
## Variables
|
|
|
|
| name | description | type | required | default |
|
|
|---|---|:---:|:---:|:---:|
|
|
| domain | Zone domain, must end with a period. | <code>string</code> | ✓ | |
|
|
| name | Zone name, must be unique within the project. | <code>string</code> | ✓ | |
|
|
| project_id | Project id for the zone. | <code>string</code> | ✓ | |
|
|
| client_networks | List of VPC self links that can see this zone. | <code>list(string)</code> | | <code>[]</code> |
|
|
| default_key_specs_key | DNSSEC default key signing specifications: algorithm, key_length, key_type, kind. | <code>any</code> | | <code>{}</code> |
|
|
| default_key_specs_zone | DNSSEC default zone signing specifications: algorithm, key_length, key_type, kind. | <code>any</code> | | <code>{}</code> |
|
|
| description | Domain description. | <code>string</code> | | <code>"Terraform managed."</code> |
|
|
| dnssec_config | DNSSEC configuration: kind, non_existence, state. | <code>any</code> | | <code>{}</code> |
|
|
| forwarders | Map of {IPV4_ADDRESS => FORWARDING_PATH} for 'forwarding' zone types. Path can be 'default', 'private', or null for provider default. | <code>map(string)</code> | | <code>{}</code> |
|
|
| peer_network | Peering network self link, only valid for 'peering' zone types. | <code>string</code> | | <code>null</code> |
|
|
| recordsets | Map of DNS recordsets in \"type name\" => {ttl, [records]} format. | <code title="map(object({ ttl = number records = list(string) }))">map(object({…}))</code> | | <code>{}</code> |
|
|
| service_directory_namespace | Service directory namespace id (URL), only valid for 'service-directory' zone types. | <code>string</code> | | <code>null</code> |
|
|
| type | Type of zone to create, valid values are 'public', 'private', 'forwarding', 'peering', 'service-directory'. | <code>string</code> | | <code>"private"</code> |
|
|
| zone_create | Create zone. When set to false, uses a data source to reference existing zone. | <code>bool</code> | | <code>true</code> |
|
|
|
|
## Outputs
|
|
|
|
| name | description | sensitive |
|
|
|---|---|:---:|
|
|
| dns_keys | DNSKEY and DS records of DNSSEC-signed managed zones. | |
|
|
| domain | The DNS zone domain. | |
|
|
| name | The DNS zone name. | |
|
|
| name_servers | The DNS zone name servers. | |
|
|
| type | The DNS zone type. | |
|
|
| zone | DNS zone resource. | |
|
|
|
|
<!-- END TFDOC -->
|
|
|