diff --git a/man/coredns-any.7 b/man/coredns-any.7 index 6d8f795da..286849750 100644 --- a/man/coredns-any.7 +++ b/man/coredns-any.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.nl -.TH "COREDNS-ANY" 7 "June 2019" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-ANY" 7 "July 2019" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-autopath.7 b/man/coredns-autopath.7 index 9150dce02..8211407f2 100644 --- a/man/coredns-autopath.7 +++ b/man/coredns-autopath.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.nl -.TH "COREDNS-AUTOPATH" 7 "June 2019" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-AUTOPATH" 7 "July 2019" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-cache.7 b/man/coredns-cache.7 index 4388d8beb..daa773bf5 100644 --- a/man/coredns-cache.7 +++ b/man/coredns-cache.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.nl -.TH "COREDNS-CACHE" 7 "June 2019" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-CACHE" 7 "July 2019" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-cancel.7 b/man/coredns-cancel.7 index 2c6f095c3..a15bc490c 100644 --- a/man/coredns-cancel.7 +++ b/man/coredns-cancel.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.nl -.TH "COREDNS-CANCEL" 7 "June 2019" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-CANCEL" 7 "July 2019" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-chaos.7 b/man/coredns-chaos.7 index 31d2655a2..e55f42a4d 100644 --- a/man/coredns-chaos.7 +++ b/man/coredns-chaos.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.nl -.TH "COREDNS-CHAOS" 7 "June 2019" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-CHAOS" 7 "July 2019" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-debug.7 b/man/coredns-debug.7 index 7880e9fe4..ce1da734c 100644 --- a/man/coredns-debug.7 +++ b/man/coredns-debug.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.nl -.TH "COREDNS-DEBUG" 7 "June 2019" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-DEBUG" 7 "July 2019" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-erratic.7 b/man/coredns-erratic.7 index 06be9b3d7..5c025b3ba 100644 --- a/man/coredns-erratic.7 +++ b/man/coredns-erratic.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.nl -.TH "COREDNS-ERRATIC" 7 "June 2019" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-ERRATIC" 7 "July 2019" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-file.7 b/man/coredns-file.7 index 8c39d79c0..5cc685b10 100644 --- a/man/coredns-file.7 +++ b/man/coredns-file.7 @@ -7,7 +7,7 @@ .SH "DESCRIPTION" .PP -The file plugin is used for an "old-style" DNS server. It serves from a preloaded file that exists +The \fIfile\fP plugin is used for an "old-style" DNS server. It serves from a preloaded file that exists on disk. If the zone file contains signatures (i.e., is signed using DNSSEC), correct DNSSEC answers are returned. Only NSEC is supported! If you use this setup \fIyou\fP are responsible for re-signing the zonefile. @@ -138,3 +138,7 @@ example.org { .fi .RE +.SH "ALSO SEE" +.PP +See the \fIloadbalance\fP plugin if you need simple record shuffling. + diff --git a/man/coredns-forward.7 b/man/coredns-forward.7 index baf4e87b7..2180506c9 100644 --- a/man/coredns-forward.7 +++ b/man/coredns-forward.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.nl -.TH "COREDNS-FORWARD" 7 "June 2019" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-FORWARD" 7 "July 2019" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP @@ -149,7 +149,7 @@ If monitoring is enabled (via the \fIprometheus\fP directive) then the following .IP \(bu 4 \fB\fCcoredns_forward_request_count_total{to}\fR - query count per upstream. .IP \(bu 4 -\fB\fCcoredns_forward_response_rcode_total{to, rcode}\fR - count of RCODEs per upstream. +\fB\fCcoredns_forward_response_rcode_count_total{to, rcode}\fR - count of RCODEs per upstream. .IP \(bu 4 \fB\fCcoredns_forward_healthcheck_failure_count_total{to}\fR - number of failed health checks per upstream. .IP \(bu 4 diff --git a/man/coredns-grpc.7 b/man/coredns-grpc.7 index 29d9a4a9e..17516d06f 100644 --- a/man/coredns-grpc.7 +++ b/man/coredns-grpc.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.nl -.TH "COREDNS-GRPC" 7 "June 2019" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-GRPC" 7 "July 2019" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP @@ -97,7 +97,7 @@ If monitoring is enabled (via the \fIprometheus\fP directive) then the following .IP \(bu 4 \fB\fCcoredns_grpc_request_count_total{to}\fR - query count per upstream. .IP \(bu 4 -\fB\fCcoredns_grpc_response_rcode_total{to, rcode}\fR - count of RCODEs per upstream. +\fB\fCcoredns_grpc_response_rcode_count_total{to, rcode}\fR - count of RCODEs per upstream. and we are randomly (this always uses the \fB\fCrandom\fR policy) spraying to an upstream. diff --git a/man/coredns-health.7 b/man/coredns-health.7 index 8a114089c..ccede9d5f 100644 --- a/man/coredns-health.7 +++ b/man/coredns-health.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.nl -.TH "COREDNS-HEALTH" 7 "June 2019" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-HEALTH" 7 "July 2019" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-hosts.7 b/man/coredns-hosts.7 index 93ad19d3b..e5c43dd43 100644 --- a/man/coredns-hosts.7 +++ b/man/coredns-hosts.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.nl -.TH "COREDNS-HOSTS" 7 "June 2019" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-HOSTS" 7 "July 2019" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP @@ -13,15 +13,17 @@ plugin only supports A, AAAA, and PTR records. The hosts plugin can be used with available hosts files that block access to advertising servers. .PP -The plugin reloads the content of the hosts file every 5 seconds. Upon reload, CoreDNS will use the new definitions. -Should the file be deleted, any inlined content will continue to be served. When the file is restored, it will then again be used. +The plugin reloads the content of the hosts file every 5 seconds. Upon reload, CoreDNS will use the +new definitions. Should the file be deleted, any inlined content will continue to be served. When +the file is restored, it will then again be used. .PP This plugin can only be used once per Server Block. .SH "THE HOSTS FILE" .PP -Commonly the entries are of the form \fB\fCIP_address canonical_hostname [aliases...]\fR as explained by the hosts(5) man page. +Commonly the entries are of the form \fB\fCIP_address canonical_hostname [aliases...]\fR as explained by +the hosts(5) man page. .PP Examples: @@ -41,7 +43,8 @@ fdfc:a744:27b5:3b0e::1 example.com example .SS "PTR RECORDS" .PP -PTR records for reverse lookups are generated automatically by CoreDNS (based on the hosts file entries) and cannot be created manually. +PTR records for reverse lookups are generated automatically by CoreDNS (based on the hosts file +entries) and cannot be created manually. .SH "SYNTAX" .PP diff --git a/man/coredns-kubernetes.7 b/man/coredns-kubernetes.7 index c430a6c12..7b21e961c 100644 --- a/man/coredns-kubernetes.7 +++ b/man/coredns-kubernetes.7 @@ -64,7 +64,6 @@ kubernetes [ZONES...] { .fi .RE - .IP \(bu 4 \fB\fCendpoint\fR specifies the \fBURL\fP for a remote k8s API endpoint. If omitted, it will connect to k8s in-cluster using the cluster service account. diff --git a/man/coredns-metrics.7 b/man/coredns-metrics.7 index 057c60f99..31e029c90 100644 --- a/man/coredns-metrics.7 +++ b/man/coredns-metrics.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.nl -.TH "COREDNS-METRICS" 7 "June 2019" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-METRICS" 7 "July 2019" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-pprof.7 b/man/coredns-pprof.7 index f5ef12858..b96ba86db 100644 --- a/man/coredns-pprof.7 +++ b/man/coredns-pprof.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.nl -.TH "COREDNS-PPROF" 7 "June 2019" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-PPROF" 7 "July 2019" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-ready.7 b/man/coredns-ready.7 index e0d36358f..95c499bde 100644 --- a/man/coredns-ready.7 +++ b/man/coredns-ready.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.nl -.TH "COREDNS-READY" 7 "June 2019" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-READY" 7 "July 2019" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-rewrite.7 b/man/coredns-rewrite.7 index d3adccce4..a85a81171 100644 --- a/man/coredns-rewrite.7 +++ b/man/coredns-rewrite.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.nl -.TH "COREDNS-REWRITE" 7 "June 2019" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-REWRITE" 7 "July 2019" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/man/coredns-route53.7 b/man/coredns-route53.7 index 68e10a4ff..943f1433f 100644 --- a/man/coredns-route53.7 +++ b/man/coredns-route53.7 @@ -19,7 +19,7 @@ The route53 plugin can be used when coredns is deployed on AWS or elsewhere. .nf route53 [ZONE:HOSTED\_ZONE\_ID...] { - [aws\_access\_key AWS\_ACCESS\_KEY\_ID AWS\_SECRET\_ACCESS\_KEY] + aws\_access\_key [AWS\_ACCESS\_KEY\_ID AWS\_SECRET\_ACCESS\_KEY] credentials PROFILE [FILENAME] fallthrough [ZONES...] } @@ -48,16 +48,17 @@ zone. \fBFILENAME\fP AWS credentials filename. Defaults to \fB\fC~/.aws/credentials\fR are used. .IP \(bu 4 \fB\fCfallthrough\fR If zone matches and no record can be generated, pass request to the next plugin. -If \fB[ZONES...]\fP is omitted, then fallthrough happens for all zones for which the plugin is +If \fBZONES\fP is omitted, then fallthrough happens for all zones for which the plugin is authoritative. If specific zones are listed (for example \fB\fCin-addr.arpa\fR and \fB\fCip6.arpa\fR), then 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 +\fBZONES\fP zones it should be authoritative for. If empty, the zones from the configuration +block. .SH "EXAMPLES" .PP -Enable route53 with implicit AWS credentials and and resolve CNAMEs via 10.0.0.1: +Enable route53 with implicit AWS credentials and resolve CNAMEs via 10.0.0.1: .PP .RS diff --git a/man/coredns-tls.7 b/man/coredns-tls.7 index 5674afca6..e06a3d6a1 100644 --- a/man/coredns-tls.7 +++ b/man/coredns-tls.7 @@ -1,5 +1,5 @@ .\" Generated by Mmark Markdown Processer - mmark.nl -.TH "COREDNS-TLS" 7 "June 2019" "CoreDNS" "CoreDNS Plugins" +.TH "COREDNS-TLS" 7 "July 2019" "CoreDNS" "CoreDNS Plugins" .SH "NAME" .PP diff --git a/notes/coredns-1.6.0.md b/notes/coredns-1.6.0.md index 8ddf272ba..f5414fcce 100644 --- a/notes/coredns-1.6.0.md +++ b/notes/coredns-1.6.0.md @@ -3,7 +3,7 @@ title = "CoreDNS-1.6.0 Release" description = "CoreDNS-1.6.0 Release Notes." tags = ["Release", "1.6.0", "Notes"] release = "1.6.0" -date = 2019-07-03T07:35:47+01:00 +date = 2019-07-28T14:35:47+01:00 author = "coredns" +++ @@ -13,7 +13,7 @@ The CoreDNS team has released The `-cpu` flag is removed from this version. This release sports changes in the *file* plugin. A speed up in the *log* plugin and fixes in the -*cache* plugin. +*cache* and *hosts* plugins. Upcoming deprecation: the kubernetes *federation* plugin [will be moved to](https://github.com/coredns/coredns/issues/3041) github.com/coredns/federation. This is likely to @@ -26,24 +26,37 @@ happen in CoreDNS 1.7.0. * The [*cache*](/plugins/cache) fixes a race. * Multiple fixes in the [*route53*](/plugins/route53) plugin. * And the [*kubernetes*](/plugins/kubernetes) removes the `resyncperiod` option. +* The [*host*](/plugins/host) appended entries from /etc/hosts on each (re-)parse, instead of + overwriting them. +* Speed ups in the [*log*](/plugins/log) plugin. ## Brought to You By -* Wonderful people +Anshul Sharma, +Charlie Vieth, +Chris O'Haver, +Christian Muehlhaeuser, +Erfan Besharat, +Jintao Zhang, +Mat Lowery, +Miek Gieben, +Ruslan Drozhdzh, +Yong Tang. ## Noteworthy Changes * core: Scrub: TC bit is always set (https://github.com/coredns/coredns/pull/3001) -* plugin/file: Simplify locking (https://github.com/coredns/coredns/pull/3024) -* plugin/file: New zone should have zero records (https://github.com/coredns/coredns/pull/3025) -* plugin/file: Rename do to walk and cleanup and document (https://github.com/coredns/coredns/pull/2987) +* pkg/cache: Fix race in Add() and Evict() (https://github.com/coredns/coredns/pull/3013) +* pkg/replacer: Evaluate format once and improve perf by ~3x (https://github.com/coredns/coredns/pull/3002) * plugin/file: Fix setting ReloadInterval (https://github.com/coredns/coredns/pull/3017) * plugin/file: Make non-existent file non-fatal (https://github.com/coredns/coredns/pull/2955) +* plugin/file: New zone should have zero records (https://github.com/coredns/coredns/pull/3025) +* plugin/file: Rename do to walk and cleanup and document (https://github.com/coredns/coredns/pull/2987) +* plugin/file: Simplify locking (https://github.com/coredns/coredns/pull/3024) +* plugin/host: don't append the names when reparsing hosts file (https://github.com/coredns/coredns/pull/3045) +* plugin/kubernetes: Remove resyncperiod (https://github.com/coredns/coredns/pull/2923) +* plugin/log: Fix log plugin benchmark and slightly improve performance (https://github.com/coredns/coredns/pull/3004) * plugin/metrics: Fix response_rcode_count_total metric (https://github.com/coredns/coredns/pull/3029) -* pkg/cache: Fix race in Add() and Evict() (https://github.com/coredns/coredns/pull/3013) +* plugin/rewrite: Fix domain length validation (https://github.com/coredns/coredns/pull/2995) * plugin/route53: Fix IAM credential file (https://github.com/coredns/coredns/pull/2983) * plugin/route53: Fix multiple credentials in route53 (https://github.com/coredns/coredns/pull/2859) -* pkg/replacer: Evaluate format once and improve perf by ~3x (https://github.com/coredns/coredns/pull/3002) -* plugin/log: Fix log plugin benchmark and slightly improve performance (https://github.com/coredns/coredns/pull/3004) -* plugin/rewrite: Fix domain length validation (https://github.com/coredns/coredns/pull/2995) -* plugin/kubernetes: Remove resyncperiod (https://github.com/coredns/coredns/pull/2923)