Name: dns
Owner: U.S. General Services Administration
Description: DNS configuration for domains managed by GSA TTS
Created: 2018-03-09 21:22:06.0
Updated: 2018-05-07 17:41:51.0
Pushed: 2018-05-07 17:41:50.0
Homepage: https://github.com/18F/Infrastructure/wiki/DNS-architecture
Size: 451
Language: HCL
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
This repository holds the source code for configuring DNS for domains managed by GSA TTS, including 18F and the Presidential Innovation Fellows.
Assuming you're TTS staff, it's recommended that you make the change in a branch on this repository itself, rather than on a fork, because the credentials aren't shared with forks.
terraform/
already?18f.us
is a good example to copy from.aws_route53_zone
..gov
domains, this will be done by the “domain manager” in dotgov.gov. The domain manager is likely someone in the respective agency's IT department.aws_route53_record
s. Generally speaking, the required arguments are:zone_id
name
type
alias
or records
alias
, then evaluate_target_health
is also required and ttl
is not allowed.records
, then ttl
is also required and evaluate_target_health
is not allowed.It's worth noting that if you are pointing to a CloudFront distro, you should use Route 53's own alias
and not a CNAME record. In fact, CNAMEing a top-level domain (or the top level of a delegated subdomain) is not allowed in DNS. See the various examples in the repo, such as this one.
On merge, changes are deployed to an AWS account hosting the Route53 records automatically by a CircleCI job.
Please note: only production systems with an ATO should have their DNS configuration here. If you wish to create DNS records for pre-production systems, please use the domain sandbox.gov
which is available in the TTS Sandbox account.
This project is in the worldwide public domain. As stated in the license:
This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the CC0 1.0 Universal public domain dedication.
All contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.