diff options
Diffstat (limited to 'man/coredns-k8s_external.7')
-rw-r--r-- | man/coredns-k8s_external.7 | 20 |
1 files changed, 10 insertions, 10 deletions
diff --git a/man/coredns-k8s_external.7 b/man/coredns-k8s_external.7 index 8c7a74e91..4293fff1c 100644 --- a/man/coredns-k8s_external.7 +++ b/man/coredns-k8s_external.7 @@ -1,5 +1,5 @@ -.\" Generated by Mmark Markdown Processer - mmark.nl -.TH "COREDNS-K8S_EXTERNAL" 7 "July 2019" "CoreDNS" "CoreDNS Plugins" +.\" Generated by Mmark Markdown Processer - mmark.miek.nl +.TH "COREDNS-K8S_EXTERNAL" 7 "August 2019" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP @@ -12,11 +12,11 @@ service. This plugin is only useful if the \fIkubernetes\fP plugin is also loade .PP The plugin uses an external zone to resolve in-cluster IP addresses. It only handles queries for A, -AAAA and SRV records, all others result in NODATA responses. To make it a proper DNS zone it handles +AAAA and SRV records; all others result in NODATA responses. To make it a proper DNS zone, it handles SOA and NS queries for the apex of the zone. .PP -By default the apex of the zone will look like (assuming the zone used is \fB\fCexample.org\fR): +By default the apex of the zone will look like the following (assuming the zone used is \fB\fCexample.org\fR): .PP .RS @@ -38,12 +38,12 @@ ns1.dns.example.org. 5 IN AAAA .... .RE .PP -Note we use the \fB\fCdns\fR subdomain to place the records the DNS needs (see the \fB\fCapex\fR directive). Also +Note that we use the \fB\fCdns\fR subdomain for the records DNS needs (see the \fB\fCapex\fR directive). Also note the SOA's serial number is static. The IP addresses of the nameserver records are those of the CoreDNS service. .PP -The \fIk8s_external\fP plugin handles the subdomain \fB\fCdns\fR and the apex of the zone by itself, all other +The \fIk8s_external\fP plugin handles the subdomain \fB\fCdns\fR and the apex of the zone itself; all other queries are resolved to addresses in the cluster. .SH "SYNTAX" @@ -61,7 +61,7 @@ k8s\_external [ZONE...] .PP -If you want to change the apex domain or use a different TTL for the return records you can use +If you want to change the apex domain or use a different TTL for the returned records you can use this extended syntax. .PP @@ -77,13 +77,13 @@ k8s\_external [ZONE...] { .RE .IP \(bu 4 -\fBAPEX\fP is the name (DNS label) to use the apex records, defaults to \fB\fCdns\fR. +\fBAPEX\fP is the name (DNS label) to use for the apex records; it defaults to \fB\fCdns\fR. .IP \(bu 4 \fB\fCttl\fR allows you to set a custom \fBTTL\fP for responses. The default is 5 (seconds). .PP -Enable names under \fB\fCexample.org\fR to be resolved to in cluster DNS addresses. +Enable names under \fB\fCexample.org\fR to be resolved to in-cluster DNS addresses. .PP .RS @@ -98,7 +98,7 @@ Enable names under \fB\fCexample.org\fR to be resolved to in cluster DNS address .RE .PP -With the Corefile above, the following Service will get an \fB\fCA\fR record for \fB\fCtest.default.example.org\fR with IP address \fB\fC192.168.200.123\fR. +With the Corefile above, the following Service will get an \fB\fCA\fR record for \fB\fCtest.default.example.org\fR with the IP address \fB\fC192.168.200.123\fR. .PP .RS |