diff --git a/content/blog/coredns-1.3.1.md b/content/blog/coredns-1.3.1.md new file mode 100644 index 0000000..0885eb1 --- /dev/null +++ b/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/). diff --git a/content/plugins/auto.md b/content/plugins/auto.md index e786dfc..c6db258 100644 --- a/content/plugins/auto.md +++ b/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 diff --git a/content/plugins/autopath.md b/content/plugins/autopath.md index aecc9ad..1ab4ca3 100644 --- a/content/plugins/autopath.md +++ b/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 diff --git a/content/plugins/bind.md b/content/plugins/bind.md index 5700ff8..a2a78ad 100644 --- a/content/plugins/bind.md +++ b/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 diff --git a/content/plugins/cache.md b/content/plugins/cache.md index b4b5910..77f5e2c 100644 --- a/content/plugins/cache.md +++ b/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 diff --git a/content/plugins/chaos.md b/content/plugins/chaos.md index d43a194..b65218a 100644 --- a/content/plugins/chaos.md +++ b/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 diff --git a/content/plugins/debug.md b/content/plugins/debug.md index f9df326..12e9672 100644 --- a/content/plugins/debug.md +++ b/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 diff --git a/content/plugins/dnssec.md b/content/plugins/dnssec.md index 7881f44..a619d62 100644 --- a/content/plugins/dnssec.md +++ b/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 diff --git a/content/plugins/dnstap.md b/content/plugins/dnstap.md index 5dcebf7..47d5239 100644 --- a/content/plugins/dnstap.md +++ b/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 diff --git a/content/plugins/erratic.md b/content/plugins/erratic.md index f015c5b..3e0ab24 100644 --- a/content/plugins/erratic.md +++ b/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 diff --git a/content/plugins/errors.md b/content/plugins/errors.md index 602149c..d31f85c 100644 --- a/content/plugins/errors.md +++ b/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 diff --git a/content/plugins/etcd.md b/content/plugins/etcd.md index f1078ef..5aec39f 100644 --- a/content/plugins/etcd.md +++ b/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 diff --git a/content/plugins/federation.md b/content/plugins/federation.md index 0798b4a..4145a52 100644 --- a/content/plugins/federation.md +++ b/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 diff --git a/content/plugins/file.md b/content/plugins/file.md index 67389ed..15c3906 100644 --- a/content/plugins/file.md +++ b/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 diff --git a/content/plugins/forward.md b/content/plugins/forward.md index daa345a..07b161d 100644 --- a/content/plugins/forward.md +++ b/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 diff --git a/content/plugins/health.md b/content/plugins/health.md index b0b8775..b8a16f4 100644 --- a/content/plugins/health.md +++ b/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 diff --git a/content/plugins/hosts.md b/content/plugins/hosts.md index cf43d70..4b6f0ce 100644 --- a/content/plugins/hosts.md +++ b/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 diff --git a/content/plugins/import.md b/content/plugins/import.md index b4a9d82..3ba836a 100644 --- a/content/plugins/import.md +++ b/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 diff --git a/content/plugins/k8s_external.md b/content/plugins/k8s_external.md index 5413eeb..1b2c573 100644 --- a/content/plugins/k8s_external.md +++ b/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 diff --git a/content/plugins/kubernetes.md b/content/plugins/kubernetes.md index 6a62185..5fe3b57 100644 --- a/content/plugins/kubernetes.md +++ b/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). diff --git a/content/plugins/loadbalance.md b/content/plugins/loadbalance.md index dce594a..26439ef 100644 --- a/content/plugins/loadbalance.md +++ b/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 diff --git a/content/plugins/log.md b/content/plugins/log.md index c2a9e93..7492286 100644 --- a/content/plugins/log.md +++ b/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... } ~~~ diff --git a/content/plugins/loop.md b/content/plugins/loop.md index 47554a1..5201105 100644 --- a/content/plugins/loop.md +++ b/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 diff --git a/content/plugins/metadata.md b/content/plugins/metadata.md index 072ca11..10f166c 100644 --- a/content/plugins/metadata.md +++ b/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 diff --git a/content/plugins/metrics.md b/content/plugins/metrics.md index 181d637..cb79d75 100644 --- a/content/plugins/metrics.md +++ b/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 diff --git a/content/plugins/nsid.md b/content/plugins/nsid.md index faf7134..73111c2 100644 --- a/content/plugins/nsid.md +++ b/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 diff --git a/content/plugins/pprof.md b/content/plugins/pprof.md index 20e3d96..37bdd59 100644 --- a/content/plugins/pprof.md +++ b/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 diff --git a/content/plugins/proxy.md b/content/plugins/proxy.md index 00952a3..7980556 100644 --- a/content/plugins/proxy.md +++ b/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 diff --git a/content/plugins/reload.md b/content/plugins/reload.md index 380b948..a220fd7 100644 --- a/content/plugins/reload.md +++ b/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 diff --git a/content/plugins/rewrite.md b/content/plugins/rewrite.md index 064eb23..d551809 100644 --- a/content/plugins/rewrite.md +++ b/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 diff --git a/content/plugins/root.md b/content/plugins/root.md index c852d0a..da8cf54 100644 --- a/content/plugins/root.md +++ b/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 diff --git a/content/plugins/route53.md b/content/plugins/route53.md index 2790a73..40a983f 100644 --- a/content/plugins/route53.md +++ b/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 diff --git a/content/plugins/secondary.md b/content/plugins/secondary.md index e90ac7a..bc50d75 100644 --- a/content/plugins/secondary.md +++ b/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 diff --git a/content/plugins/template.md b/content/plugins/template.md index 126531d..abb7ca0 100644 --- a/content/plugins/template.md +++ b/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 diff --git a/content/plugins/tls.md b/content/plugins/tls.md index f0f16d2..ef40ff4 100644 --- a/content/plugins/tls.md +++ b/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 diff --git a/content/plugins/trace.md b/content/plugins/trace.md index 4311ba6..c399857 100644 --- a/content/plugins/trace.md +++ b/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 diff --git a/content/plugins/whoami.md b/content/plugins/whoami.md index 8f18f0d..52b5ecf 100644 --- a/content/plugins/whoami.md +++ b/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 diff --git a/data/coredns.toml b/data/coredns.toml index 763fbb5..a7c5019 100644 --- a/data/coredns.toml +++ b/data/coredns.toml @@ -1,2 +1,2 @@ [release] - version = "1.3.0" + version = "1.3.1"