aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--man/coredns-azure.770
-rw-r--r--man/coredns-kubernetes.72
-rw-r--r--man/coredns-route53.727
-rw-r--r--plugin/chaos/zowners.go2
4 files changed, 98 insertions, 3 deletions
diff --git a/man/coredns-azure.7 b/man/coredns-azure.7
new file mode 100644
index 000000000..2a4bdcd01
--- /dev/null
+++ b/man/coredns-azure.7
@@ -0,0 +1,70 @@
+.\" Generated by Mmark Markdown Processer - mmark.nl
+.TH "COREDNS-AZURE" 7 "August 2019" "CoreDNS" "CoreDNS Plugins"
+
+.SH "NAME"
+.PP
+\fIazure\fP - enables serving zone data from Microsoft Azure DNS service.
+
+.SH "DESCRIPTION"
+.PP
+The azure plugin is useful for serving zones from Microsoft Azure DNS. The \fIazure\fP plugin supports
+all the DNS records supported by Azure, viz. A, AAAA, CNAME, MX, NS, PTR, SOA, SRV, and TXT
+record types.
+
+.SH "SYNTAX"
+.PP
+.RS
+
+.nf
+azure RESOURCE\_GROUP:ZONE... {
+ tenant TENANT\_ID
+ client CLIENT\_ID
+ secret CLIENT\_SECRET
+ subscription SUBSCRIPTION\_ID
+ environment ENVIRONMENT
+ fallthrough [ZONES...]
+}
+
+.fi
+.RE
+
+.IP \(bu 4
+\fBRESOURCE_GROUP:ZONE\fP is the resource group to which the hosted zones belongs on Azure,
+and \fBZONE\fP the zone that contains data.
+.IP \(bu 4
+\fBCLIENT_ID\fP and \fBCLIENT_SECRET\fP are the credentials for Azure, and \fB\fCtenant\fR specifies the
+\fBTENANT_ID\fP to be used. \fBSUBSCRIPTION_ID\fP is the subscription ID. All of these are needed
+to access the data in Azure.
+.IP \(bu 4
+\fB\fCenvironment\fR specifies the Azure \fBENVIRONMENT\fP.
+.IP \(bu 4
+\fB\fCfallthrough\fR If zone matches and no record can be generated, pass request to the next plugin.
+If \fBZONES\fP is omitted, then fallthrough happens for all zones for which the plugin is
+authoritative.
+
+
+.SH "EXAMPLES"
+.PP
+Enable the \fIazure\fP plugin with Azure credentials for the zone \fB\fCexample.org\fR:
+
+.PP
+.RS
+
+.nf
+example.org {
+ azure resource\_group\_foo:example.org {
+ tenant 123abc\-123abc\-123abc\-123abc
+ client 123abc\-123abc\-123abc\-234xyz
+ subscription 123abc\-123abc\-123abc\-563abc
+ secret mysecret
+ }
+}
+
+.fi
+.RE
+
+.SH "ALSO SEE"
+.PP
+The Azure DNS Overview
+\[la]https://docs.microsoft.com/en-us/azure/dns/dns-overview\[ra].
+
diff --git a/man/coredns-kubernetes.7 b/man/coredns-kubernetes.7
index 7b21e961c..ddc7cb021 100644
--- a/man/coredns-kubernetes.7
+++ b/man/coredns-kubernetes.7
@@ -1,5 +1,5 @@
.\" Generated by Mmark Markdown Processer - mmark.nl
-.TH "COREDNS-KUBERNETES" 7 "July 2019" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-KUBERNETES" 7 "August 2019" "CoreDNS" "CoreDNS Plugins"
.SH "NAME"
.PP
diff --git a/man/coredns-route53.7 b/man/coredns-route53.7
index 943f1433f..e28a92f42 100644
--- a/man/coredns-route53.7
+++ b/man/coredns-route53.7
@@ -1,5 +1,5 @@
.\" Generated by Mmark Markdown Processer - mmark.nl
-.TH "COREDNS-ROUTE53" 7 "July 2019" "CoreDNS" "CoreDNS Plugins"
+.TH "COREDNS-ROUTE53" 7 "August 2019" "CoreDNS" "CoreDNS Plugins"
.SH "NAME"
.PP
@@ -22,6 +22,7 @@ route53 [ZONE:HOSTED\_ZONE\_ID...] {
aws\_access\_key [AWS\_ACCESS\_KEY\_ID AWS\_SECRET\_ACCESS\_KEY]
credentials PROFILE [FILENAME]
fallthrough [ZONES...]
+ refresh DURATION
}
.fi
@@ -54,6 +55,14 @@ only queries for those zones will be subject to fallthrough.
.IP \(bu 4
\fBZONES\fP zones it should be authoritative for. If empty, the zones from the configuration
block.
+.IP \(bu 4
+\fB\fCrefresh\fR can be used to control how long between record retrievals from Route 53. It requires
+a duration string as a parameter to specify the duration between update cycles. Each update
+cycle may result in many AWS API calls depending on how many domains use this plugin and how
+many records are in each. Adjusting the update frequency may help reduce the potential of API
+rate-limiting imposed by AWS.
+.IP \(bu 4
+\fBDURATION\fP A duration string. Defaults to \fB\fC1m\fR. If units are unspecified, seconds are assumed.
.SH "EXAMPLES"
@@ -118,3 +127,19 @@ Enable route53 with multiple hosted zones with the same domain:
.fi
.RE
+.PP
+Enable route53 and refresh records every 3 minutes
+
+.PP
+.RS
+
+.nf
+\&. {
+ route53 example.org.:Z1Z2Z3Z4DZ5Z6Z7 {
+ refresh 3m
+ }
+}
+
+.fi
+.RE
+
diff --git a/plugin/chaos/zowners.go b/plugin/chaos/zowners.go
index d747069dc..41b8f690e 100644
--- a/plugin/chaos/zowners.go
+++ b/plugin/chaos/zowners.go
@@ -1,4 +1,4 @@
package chaos
// Owners are all GitHub handlers of all maintainers.
-var Owners = []string{"bradbeam", "chrisohaver", "dilyevsky", "ekleiner", "fastest963", "greenpau", "grobie", "inigohu", "isolus", "johnbelamaric", "miekg", "nchrisdk", "nitisht", "pmoroney", "rajansandeep", "rdrozhdzh", "rtreffer", "stp-ip", "superq", "varyoo", "yongtang"}
+var Owners = []string{"bradbeam", "chrisohaver", "darshanime", "dilyevsky", "ekleiner", "fastest963", "greenpau", "grobie", "inigohu", "isolus", "johnbelamaric", "miekg", "nchrisdk", "nitisht", "pmoroney", "rajansandeep", "rdrozhdzh", "rtreffer", "stp-ip", "superq", "varyoo", "yongtang"}