department-of-veterans-affairs/ascent-dns-ami

Name: ascent-dns-ami

Owner: Department of Veterans Affairs

Description: null

Created: 2017-10-16 15:23:03.0

Updated: 2018-05-22 19:19:41.0

Pushed: 2018-05-22 19:19:45.0

Homepage: null

Size: 40

Language: HCL

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

Ascent DNS Module

This repo contains a Module for how to deploy DNS server cluster on Amazon Web Services (AWS) using Terraform. EC2 Instances register their domain names using an instance tag with a key=“SAN” and the value being whatever domain name the user of this module desires.

This Module includes:

• dns-cluster: This module sets up and performs the initial configuration of a dns cluster with a master/slave set up.
• dns-iam-policies: This module contains the policies needed for the dns servers' role so they can query the other instances for a SAN tag.
• dns-security-group-rules: This module contains the security group rules necessary for traffic to the dns servers.

What's a Module?

Modules in Terraform are self-contained packages of Terraform configurations that are managed as a group. Modules are used to create reusable components in Terraform as well as for basic code organization. A root module is the current working directory when you run terraform apply or get, holding the Terraform configuration files. It is itself a valid module. The root module in this project is dns-cluster. See [https://www.terraform.io/docs/modules/usage.html] for more details for creating your own module.

Prerequisites

• Terraform
• Packer
• An active AWS account

How do you use this Module?

This Module has the following folder structure:

• modules: This folder contains the reusable code for this Module, broken down into one or more modules.
• packer: This folder contains a packer ebs builder that builds the required Amazon Machine Image (AMI).

To Deploy a DNS Master Instance

1. Create an AMI that is configured as a DNS server using the packer project.
2. Deploy the AMI into a private subnet using the Terraform dns-cluster with a Tag with a “Type” key set to a value of “dns_master”

To Deploy a DNS Slave Instance

1. Create an AMI that is configured as a DNS server using the packer project.
2. Deploy the AMI into a private subnet using the Terraform dns-cluster with a Tag with a “Type” key set to a value of “dns_slave”.