https://github.com/cloudnationhq/terraform-azure-dnspr
Terraform module which creates private dns resolver resources used by workloads and accelerators.
https://github.com/cloudnationhq/terraform-azure-dnspr
azure terraform wam
Last synced: 5 months ago
JSON representation
Terraform module which creates private dns resolver resources used by workloads and accelerators.
- Host: GitHub
- URL: https://github.com/cloudnationhq/terraform-azure-dnspr
- Owner: CloudNationHQ
- License: mit
- Created: 2024-07-11T11:07:28.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-28T15:31:06.000Z (11 months ago)
- Last Synced: 2025-01-28T16:31:43.822Z (11 months ago)
- Topics: azure, terraform, wam
- Language: HCL
- Homepage: https://registry.terraform.io/modules/CloudNationHQ/dnspr/azure/latest
- Size: 102 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# Private Dns Resolver
This terraform module streamlines the creation of private dns resolver resources on the azure cloud platform, enabling users to manage and resolve private dns queries within their virtual networks. With this module, users can effortlessly provision a secure, scalable, and centralized dns resolution solution.
## Features
Supports the configuration of multiple inbound and outbound endpoints.
Allows multiple ip configurations on inbound endpoints.
Enables multiple forwarding rulesets and rules on outnound endpoints.
Utilization of terratest for robust validation.
Facilitates the integration of multiple virtual network links within a forwarding ruleset.
Offers three-tier naming hierarchy (explicit, convention-based, or key-based) for flexible resource management.
## Requirements
The following requirements are needed by this module:
- [terraform](#requirement\_terraform) (~> 1.0)
- [azurerm](#requirement\_azurerm) (~> 4.0)
## Providers
The following providers are used by this module:
- [azurerm](#provider\_azurerm) (~> 4.0)
## Resources
The following resources are used by this module:
- [azurerm_private_dns_resolver.resolver](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/private_dns_resolver) (resource)
- [azurerm_private_dns_resolver_dns_forwarding_ruleset.sets](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/private_dns_resolver_dns_forwarding_ruleset) (resource)
- [azurerm_private_dns_resolver_forwarding_rule.rules](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/private_dns_resolver_forwarding_rule) (resource)
- [azurerm_private_dns_resolver_inbound_endpoint.inbound](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/private_dns_resolver_inbound_endpoint) (resource)
- [azurerm_private_dns_resolver_outbound_endpoint.outbound](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/private_dns_resolver_outbound_endpoint) (resource)
- [azurerm_private_dns_resolver_virtual_network_link.links](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/private_dns_resolver_virtual_network_link) (resource)
## Required Inputs
The following input variables are required:
### [instance](#input\_instance)
Description: Contains private dns resolver instance configuration
Type:
```hcl
object({
name = string
resource_group_name = optional(string, null)
location = optional(string, null)
virtual_network_id = string
tags = optional(map(string))
inbound_endpoints = optional(map(object({
name = optional(string, null)
ip_configurations = optional(map(object({
private_ip_allocation_method = optional(string, "Dynamic")
private_ip_address = optional(string, null)
subnet_id = string
})), {})
})), {})
outbound_endpoints = optional(map(object({
name = optional(string, null)
subnet_id = string
forwarding_rulesets = optional(map(object({
name = optional(string, null)
tags = optional(map(string), null)
rules = optional(map(object({
name = optional(string, null)
domain_name = string
enabled = optional(bool, null)
metadata = optional(map(string), null)
target_dns_servers = map(object({
ip_address = string
port = optional(number, 53)
}))
})), {})
virtual_network_links = optional(map(object({
name = optional(string, null)
metadata = optional(map(string), null)
virtual_network_id = string
})), {})
})), {})
})), {})
})
```
## Optional Inputs
The following input variables are optional (have default values):
### [location](#input\_location)
Description: default azure region to be used.
Type: `string`
Default: `null`
Description: contains naming convention
Type: `map(string)`
Default: `{}`
### [resource\_group\_name](#input\_resource\_group\_name)
Description: default resource group to be used.
Type: `string`
Default: `null`
Description: tags to be added to the resources
Type: `map(string)`
Default: `{}`
## Outputs
The following outputs are exported:
### [forwarding\_rulesets](#output\_forwarding\_rulesets)
Description: contains private dns resolver dns forwarding ruleset configuration
### [inbound\_endpoints](#output\_inbound\_endpoints)
Description: contains private dns resolver inbound endpoints configuration
### [instance](#output\_instance)
Description: contains private dns resolver instance configuration
### [outbound\_endpoints](#output\_outbound\_endpoints)
Description: contains private dns resolver outbound endpoints configuration
### [virtual\_network\_links](#output\_virtual\_network\_links)
Description: contains private dns resolver dns virtual network links configuration
## Goals
For more information, please see our [goals and non-goals](./GOALS.md).
## Testing
For more information, please see our testing [guidelines](./TESTING.md)
## Notes
Using a dedicated module, we've developed a naming convention for resources that's based on specific regular expressions for each type, ensuring correct abbreviations and offering flexibility with multiple prefixes and suffixes.
Full examples detailing all usages, along with integrations with dependency modules, are located in the examples directory.
To update the module's documentation run `make doc`
## Contributors
We welcome contributions from the community! Whether it's reporting a bug, suggesting a new feature, or submitting a pull request, your input is highly valued.
For more information, please see our contribution [guidelines](./CONTRIBUTING.md).
## License
MIT Licensed. See [LICENSE](https://github.com/cloudnationhq/terraform-azure-dnspr/blob/main/LICENSE) for full details.
## References
- [Documentation](https://learn.microsoft.com/en-us/azure/dns/dns-private-resolver-overview)
- [Rest Api](https://learn.microsoft.com/en-us/rest/api/dns/dnsresolver/operation-groups?view=rest-dns-dnsresolver-2020-04-01-preview)