d9880681c3
update the manpages by running make -f Makefile.doc No other changes. Signed-off-by: Miek Gieben <miek@miek.nl>
119 lines
3.4 KiB
Groff
119 lines
3.4 KiB
Groff
.\" generated with Ronn/v0.7.3
|
|
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
|
.
|
|
.TH "COREDNS\-ROUTE53" "7" "December 2018" "CoreDNS" "CoreDNS plugins"
|
|
.
|
|
.SH "NAME"
|
|
\fIroute53\fR \- enables serving zone data from AWS route53\.
|
|
.
|
|
.SH "DESCRIPTION"
|
|
The route53 plugin is useful for serving zones from resource record sets in AWS route53\. This plugin supports all Amazon Route 53 records (https://docs\.aws\.amazon\.com/Route53/latest/DeveloperGuide/ResourceRecordTypes\.html)\. The route53 plugin can be used when coredns is deployed on AWS or elsewhere\.
|
|
.
|
|
.SH "SYNTAX"
|
|
.
|
|
.nf
|
|
|
|
route53 [ZONE:HOSTED_ZONE_ID\.\.\.] {
|
|
[aws_access_key AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY]
|
|
upstream [ADDRESS\.\.\.]
|
|
credentials PROFILE [FILENAME]
|
|
fallthrough [ZONES\.\.\.]
|
|
}
|
|
.
|
|
.fi
|
|
.
|
|
.IP "\(bu" 4
|
|
\fBZONE\fR the name of the domain to be accessed\. When there are multiple zones with overlapping domains (private vs\. public hosted zone), CoreDNS does the lookup in the given order here\. Therefore, for a non\-existing resource record, SOA response will be from the rightmost zone\.
|
|
.
|
|
.IP "\(bu" 4
|
|
\fBHOSTED_ZONE_ID\fR the ID of the hosted zone that contains the resource record sets to be accessed\.
|
|
.
|
|
.IP "\(bu" 4
|
|
\fBAWS_ACCESS_KEY_ID\fR and \fBAWS_SECRET_ACCESS_KEY\fR the AWS access key ID and secret access key to be used when query AWS (optional)\. If they are not provided, then coredns tries to access AWS credentials the same way as AWS CLI, e\.g\., environmental variables, AWS credentials file, instance profile credentials, etc\.
|
|
.
|
|
.IP "\(bu" 4
|
|
\fBupstream\fR [\fBADDRESS\fR\.\.\.] specifies upstream resolver(s) used for resolving services that point to external hosts (eg\. used to resolve CNAMEs)\. If no \fBADDRESS\fR is given, CoreDNS will resolve against itself\. \fBADDRESS\fR can be an IP, an IP:port or a path to a file structured like resolv\.conf\.
|
|
.
|
|
.IP "\(bu" 4
|
|
\fBcredentials\fR used for reading the credential file and setting the profile name for a given zone\.
|
|
.
|
|
.IP "\(bu" 4
|
|
\fBPROFILE\fR AWS account profile name\. Defaults to \fBdefault\fR\.
|
|
.
|
|
.IP "\(bu" 4
|
|
\fBFILENAME\fR AWS credentials filename\. Defaults to \fB~/\.aws/credentials\fR are used\.
|
|
.
|
|
.IP "\(bu" 4
|
|
\fBfallthrough\fR If zone matches and no record can be generated, pass request to the next plugin\. If \fB[ZONES\.\.\.]\fR is omitted, then fallthrough happens for all zones for which the plugin is authoritative\. If specific zones are listed (for example \fBin\-addr\.arpa\fR and \fBip6\.arpa\fR), then only queries for those zones will be subject to fallthrough\.
|
|
.
|
|
.IP "\(bu" 4
|
|
\fBZONES\fR zones it should be authoritative for\. If empty, the zones from the configuration block
|
|
.
|
|
.IP "" 0
|
|
.
|
|
.SH "EXAMPLES"
|
|
Enable route53 with implicit AWS credentials and an upstream:
|
|
.
|
|
.IP "" 4
|
|
.
|
|
.nf
|
|
|
|
\&\. {
|
|
route53 example\.org\.:Z1Z2Z3Z4DZ5Z6Z7 {
|
|
upstream 10\.0\.0\.1
|
|
}
|
|
}
|
|
.
|
|
.fi
|
|
.
|
|
.IP "" 0
|
|
.
|
|
.P
|
|
Enable route53 with explicit AWS credentials:
|
|
.
|
|
.IP "" 4
|
|
.
|
|
.nf
|
|
|
|
\&\. {
|
|
route53 example\.org\.:Z1Z2Z3Z4DZ5Z6Z7 {
|
|
aws_access_key AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY
|
|
}
|
|
}
|
|
.
|
|
.fi
|
|
.
|
|
.IP "" 0
|
|
.
|
|
.P
|
|
Enable route53 with fallthrough:
|
|
.
|
|
.IP "" 4
|
|
.
|
|
.nf
|
|
|
|
\&\. {
|
|
route53 example\.org\.:Z1Z2Z3Z4DZ5Z6Z7 example\.gov\.:Z654321543245 {
|
|
fallthrough example\.gov\.
|
|
}
|
|
}
|
|
.
|
|
.fi
|
|
.
|
|
.IP "" 0
|
|
.
|
|
.P
|
|
Enable route53 with multiple hosted zones with the same domain:
|
|
.
|
|
.IP "" 4
|
|
.
|
|
.nf
|
|
|
|
\&\. {
|
|
route53 example\.org\.:Z1Z2Z3Z4DZ5Z6Z7 example\.org\.:Z93A52145678156
|
|
}
|
|
.
|
|
.fi
|
|
.
|
|
.IP "" 0
|
|
|