1.3.1 release (#124)

Signed-off-by: Miek Gieben <miek@miek.nl>

content/blog/coredns-1.3.1.md

@@ -0,0 +1,45 @@
++++
+title = "CoreDNS-1.3.1 Release"
+description = "CoreDNS-1.3.1 Release Notes."
+tags = ["Release", "1.3.1", "Notes"]
+release = "1.3.1"
+date = "2019-01-13T15:00:29+00:00"
+author = "coredns"
++++
+
+We are pleased to announce the [release](https://github.com/coredns/coredns/releases/tag/v1.3.1)
+of CoreDNS-1.3.1! This is a fairly small release that allows us to announcing some backwards
+incompatible changes in the *next* (1.4.0) release:
+
+ *  The `upstream` directive used in various plugin will start to *default* to the coredns process
+    itself. This allow those resolutions to take advantage of other plugins (i.e. caching). The
+    *etcd*'s plugin StubDomain subsystem relied heavily on this functionality and as such will be
+    removed from that plugin.
+
+ *  Multiple endpoints in kubernetes will not be supported going forward.
+
+
+# Plugins
+
+Mostly documentation updates in various plugins. Plus a small fix where we stop setting the RA
+(recursion available) flag on responses in plugins that don't provide recursion.
+
+ *  [*log*](/plugins/log) now allows multiple names to be specified.
+
+ *  [*import*](/plugin/import) was added to give it a README.md to make it's documentation more
+    discoverable.
+
+ *  [*kubernetes*](/plugin/kubernetes) `TTL` is also applied to negative responses (NXDOMAIN, etc).
+
+## Brought to You By
+
+Chris O'Haver,
+ckcd,
+Isolus,
+jmpcyc,
+Miek Gieben,
+Taras Tsugrii,
+Yong Tang.
+
+For documentation see our (in progress!) [manual](/manual). For help and other resources, see our
+[community page](https://coredns.io/community/).

content/plugins/auto.md

@@ -4,7 +4,7 @@ description = "*auto* enables serving zone data from an RFC 1035-style master fi
 weight = 1
 tags = [ "plugin", "auto" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.737929"
+date = "2019-01-13T14:59:21.558378"
 +++
 
 ## Description

content/plugins/autopath.md

@@ -4,7 +4,7 @@ description = "*autopath* allows for server-side search path completion."
 weight = 2
 tags = [ "plugin", "autopath" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.738166"
+date = "2019-01-13T14:59:21.558570"
 +++
 
 ## Description

content/plugins/bind.md

@@ -4,7 +4,7 @@ description = "*bind* overrides the host to which the server should bind."
 weight = 3
 tags = [ "plugin", "bind" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.738283"
+date = "2019-01-13T14:59:21.558685"
 +++
 
 ## Description

content/plugins/cache.md

@@ -4,7 +4,7 @@ description = "*cache* enables a frontend cache."
 weight = 4
 tags = [ "plugin", "cache" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.738400"
+date = "2019-01-13T14:59:21.558819"
 +++
 
 ## Description

content/plugins/chaos.md

@@ -4,7 +4,7 @@ description = "*chaos* allows for responding to TXT queries in the CH class."
 weight = 5
 tags = [ "plugin", "chaos" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.738541"
+date = "2019-01-13T14:59:21.558924"
 +++
 
 ## Description

content/plugins/debug.md

@@ -4,7 +4,7 @@ description = "*debug* disables the automatic recovery upon a crash so that you'
 weight = 6
 tags = [ "plugin", "debug" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.738628"
+date = "2019-01-13T14:59:21.559015"
 +++
 
 ## Description

content/plugins/dnssec.md

@@ -4,7 +4,7 @@ description = "*dnssec* enable on-the-fly DNSSEC signing of served data."
 weight = 7
 tags = [ "plugin", "dnssec" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.738741"
+date = "2019-01-13T14:59:21.559151"
 +++
 
 ## Description

content/plugins/dnstap.md

@@ -4,7 +4,7 @@ description = "*dnstap* enable logging to dnstap."
 weight = 8
 tags = [ "plugin", "dnstap" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.738861"
+date = "2019-01-13T14:59:21.559256"
 +++
 
 ## Description

content/plugins/erratic.md

@@ -4,7 +4,7 @@ description = "*erratic* a plugin useful for testing client behavior."
 weight = 9
 tags = [ "plugin", "erratic" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.738953"
+date = "2019-01-13T14:59:21.559358"
 +++
 
 ## Description

content/plugins/errors.md

@@ -4,7 +4,7 @@ description = "*errors* enable error logging."
 weight = 10
 tags = [ "plugin", "errors" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.739037"
+date = "2019-01-13T14:59:21.559460"
 +++
 
 ## Description

content/plugins/etcd.md

@@ -4,7 +4,7 @@ description = "*etcd* enables reading zone data from an etcd version 3 instance.
 weight = 11
 tags = [ "plugin", "etcd" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.739198"
+date = "2019-01-13T14:59:21.559615"
 +++
 
 ## Description

content/plugins/federation.md

@@ -4,7 +4,7 @@ description = "*federation* enables federated queries to be resolved via the kub
 weight = 12
 tags = [ "plugin", "federation" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.739306"
+date = "2019-01-13T14:59:21.559721"
 +++
 
 ## Description

content/plugins/file.md

@@ -4,7 +4,7 @@ description = "*file* enables serving zone data from an RFC 1035-style master fi
 weight = 13
 tags = [ "plugin", "file" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.739395"
+date = "2019-01-13T14:59:21.559816"
 +++
 
 ## Description

content/plugins/forward.md

@@ -4,7 +4,7 @@ description = "*forward* facilitates proxying DNS messages to upstream resolvers
 weight = 14
 tags = [ "plugin", "forward" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.739549"
+date = "2019-01-13T14:59:21.559963"
 +++
 
 ## Description

content/plugins/health.md

@@ -4,7 +4,7 @@ description = "*health* enables a health check endpoint."
 weight = 15
 tags = [ "plugin", "health" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.739662"
+date = "2019-01-13T14:59:21.560114"
 +++
 
 ## Description

content/plugins/hosts.md

@@ -4,7 +4,7 @@ description = "*hosts* enables serving zone data from a `/etc/hosts` style file.
 weight = 16
 tags = [ "plugin", "hosts" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.739765"
+date = "2019-01-13T14:59:21.560263"
 +++
 
 ## Description

content/plugins/import.md

@@ -4,7 +4,7 @@ description = "*import* include files or reference snippets from a Corefile."
 weight = 17
 tags = [ "plugin", "import" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.739849"
+date = "2019-01-13T14:59:21.560394"
 +++
 
 ## Description

content/plugins/k8s_external.md

@@ -4,7 +4,7 @@ description = "*k8s_external* resolve load balancer and external IPs from outsid
 weight = 18
 tags = [ "plugin", "k8s_external" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.739947"
+date = "2019-01-13T14:59:21.560508"
 +++
 
 ## Description

content/plugins/kubernetes.md

@@ -4,7 +4,7 @@ description = "*kubernetes* enables the reading zone data from a Kubernetes clus
 weight = 19
 tags = [ "plugin", "kubernetes" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.740107"
+date = "2019-01-13T14:59:21.560683"
 +++
 
 ## Description
@@ -55,8 +55,9 @@ kubernetes [ZONES...] {
 * `endpoint` specifies the **URL** for a remote k8s API endpoint.
    If omitted, it will connect to k8s in-cluster using the cluster service account.
    Multiple k8s API endpoints could be specified:
-   `endpoint http://k8s-endpoint1:8080 http://k8s-endpoint2:8080`. CoreDNS
-   will automatically perform a healthcheck and proxy to the healthy k8s API endpoint.
+   `endpoint http://k8s-endpoint1:8080 http://k8s-endpoint2:8080`.
+   CoreDNS will automatically perform a healthcheck and proxy to the healthy k8s API endpoint.
+   Note that only http is supported when more than one k8s API endpoints are specified at the moment.
 * `tls` **CERT** **KEY** **CACERT** are the TLS cert, key and the CA cert file names for remote k8s connection.
    This option is ignored if connecting in-cluster (i.e. endpoint is not specified).
 * `kubeconfig` **KUBECONFIG** **CONTEXT** authenticates the connection to a remote k8s cluster using a kubeconfig file. It supports TLS, username and password, or token-based authentication. This option is ignored if connecting in-cluster (i.e., the endpoint is not specified).

content/plugins/loadbalance.md

@@ -4,7 +4,7 @@ description = "*loadbalance* randomize the order of A, AAAA and MX records."
 weight = 20
 tags = [ "plugin", "loadbalance" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.740204"
+date = "2019-01-13T14:59:21.560790"
 +++
 
 ## Description

content/plugins/log.md

@@ -4,7 +4,7 @@ description = "*log* enables query logging to standard output."
 weight = 21
 tags = [ "plugin", "log" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.740314"
+date = "2019-01-13T14:59:21.560935"
 +++
 
 ## Description
@@ -26,10 +26,10 @@ log
 Or if you want/need slightly more control:
 
 ~~~ txt
-log [NAME] [FORMAT]
+log [NAMES...] [FORMAT]
 ~~~
 
-* `NAME` is the name to match in order to be logged
+* `NAMES` is the name list to match in order to be logged
 * `FORMAT` is the log format to use (default is Common Log Format), `{common}` is used as a shortcut
   for the Common Log Format. You can also use `{combined}` for a format that adds the query opcode
   `{>opcode}` to the Common Log Format.
@@ -37,7 +37,7 @@ log [NAME] [FORMAT]
 You can further specify the classes of responses that get logged:
 
 ~~~ txt
-log [NAME] [FORMAT] {
+log [NAMES...] [FORMAT] {
     class CLASSES...
 }
 ~~~

content/plugins/loop.md

@@ -4,7 +4,7 @@ description = "*loop* detect simple forwarding loops and halt the server."
 weight = 22
 tags = [ "plugin", "loop" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.740447"
+date = "2019-01-13T14:59:21.561075"
 +++
 
 ## Description

content/plugins/metadata.md

@@ -4,7 +4,7 @@ description = "*metadata* enable a meta data collector."
 weight = 23
 tags = [ "plugin", "metadata" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.740526"
+date = "2019-01-13T14:59:21.561181"
 +++
 
 ## Description

content/plugins/metrics.md

@@ -4,7 +4,7 @@ description = "*prometheus* enables [Prometheus](https://prometheus.io/) metrics
 weight = 24
 tags = [ "plugin", "metrics" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.740615"
+date = "2019-01-13T14:59:21.561294"
 +++
 
 ## Description

content/plugins/nsid.md

@@ -4,7 +4,7 @@ description = "*nsid* adds an identifier of this server to each reply."
 weight = 25
 tags = [ "plugin", "nsid" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.740712"
+date = "2019-01-13T14:59:21.561416"
 +++
 
 ## Description

content/plugins/pprof.md

@@ -4,7 +4,7 @@ description = "*pprof* publishes runtime profiling data at endpoints under `/deb
 weight = 26
 tags = [ "plugin", "pprof" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.740823"
+date = "2019-01-13T14:59:21.561533"
 +++
 
 ## Description

content/plugins/proxy.md

@@ -4,7 +4,7 @@ description = "*proxy* facilitates both a basic reverse proxy and a robust load
 weight = 27
 tags = [ "plugin", "proxy" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.740935"
+date = "2019-01-13T14:59:21.561684"
 +++
 
 ## Description

content/plugins/reload.md

@@ -4,7 +4,7 @@ description = "*reload* allows automatic reload of a changed Corefile."
 weight = 28
 tags = [ "plugin", "reload" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.741043"
+date = "2019-01-13T14:59:21.561809"
 +++
 
 ## Description

content/plugins/rewrite.md

@@ -4,7 +4,7 @@ description = "*rewrite* performs internal message rewriting."
 weight = 29
 tags = [ "plugin", "rewrite" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.741203"
+date = "2019-01-13T14:59:21.562006"
 +++
 
 ## Description

content/plugins/root.md

@@ -4,7 +4,7 @@ description = "*root* simply specifies the root of where to find (zone) files."
 weight = 30
 tags = [ "plugin", "root" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.741295"
+date = "2019-01-13T14:59:21.562106"
 +++
 
 ## Description

content/plugins/route53.md

@@ -4,7 +4,7 @@ description = "*route53* enables serving zone data from AWS route53."
 weight = 31
 tags = [ "plugin", "route53" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.741407"
+date = "2019-01-13T14:59:21.562219"
 +++
 
 ## Description

content/plugins/secondary.md

@@ -4,7 +4,7 @@ description = "*secondary* enables serving a zone retrieved from a primary serve
 weight = 32
 tags = [ "plugin", "secondary" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.741489"
+date = "2019-01-13T14:59:21.562329"
 +++
 
 ## Description

content/plugins/template.md

@@ -4,7 +4,7 @@ description = "*template* allows for dynamic responses based on the incoming que
 weight = 33
 tags = [ "plugin", "template" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.741631"
+date = "2019-01-13T14:59:21.562516"
 +++
 
 ## Description

content/plugins/tls.md

@@ -4,7 +4,7 @@ description = "*tls* allows you to configure the server certificates for the TLS
 weight = 34
 tags = [ "plugin", "tls" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.741758"
+date = "2019-01-13T14:59:21.562647"
 +++
 
 ## Description

content/plugins/trace.md

@@ -4,7 +4,7 @@ description = "*trace* enables OpenTracing-based tracing of DNS requests as they
 weight = 35
 tags = [ "plugin", "trace" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.741845"
+date = "2019-01-13T14:59:21.562795"
 +++
 
 ## Description

content/plugins/whoami.md

@@ -4,7 +4,7 @@ description = "*whoami* returns your resolver's local IP address, port and trans
 weight = 36
 tags = [ "plugin", "whoami" ]
 categories = [ "plugin" ]
-date = "2019-01-06T09:07:57.741922"
+date = "2019-01-13T14:59:21.562928"
 +++
 
 ## Description

data/coredns.toml

@@ -1,2 +1,2 @@
 [release]
-  version = "1.3.0"
+  version = "1.3.1"