diff --git a/content/plugins/auto.md b/content/plugins/auto.md index 07e7f90..4be5b3d 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 = "2018-03-13T14:42:31.860718" +date = "2018-03-26T06:36:14.770368" +++ ## Description diff --git a/content/plugins/autopath.md b/content/plugins/autopath.md index 0f94cb1..e2f98be 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 = "2018-03-13T14:42:31.861181" +date = "2018-03-26T06:36:14.771073" +++ ## Description diff --git a/content/plugins/bind.md b/content/plugins/bind.md index d7a244c..f6f5dd0 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 = "2018-03-13T14:42:31.861436" +date = "2018-03-26T06:36:14.771629" +++ ## Description diff --git a/content/plugins/cache.md b/content/plugins/cache.md index ad383d4..6698525 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 = "2018-03-13T14:42:31.861636" +date = "2018-03-26T06:36:14.771907" +++ ## Description @@ -60,6 +60,7 @@ If monitoring is enabled (via the *prometheus* directive) then the following met * `coredns_cache_capacity{type}` - Total capacity of the cache by cache type. * `coredns_cache_hits_total{type}` - Counter of cache hits by cache type. * `coredns_cache_misses_total{}` - Counter of cache misses. +* `coredns_cache_drops_total{}` - Counter of dropped messages. Cache types are either "denial" or "success". diff --git a/content/plugins/chaos.md b/content/plugins/chaos.md index 89d815a..0445fbd 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 = "2018-03-13T14:42:31.861817" +date = "2018-03-26T06:36:14.772444" +++ ## Description diff --git a/content/plugins/debug.md b/content/plugins/debug.md index 6d0dcde..25df25e 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 = "2018-03-13T14:42:31.862025" +date = "2018-03-26T06:36:14.772946" +++ ## Description diff --git a/content/plugins/dnssec.md b/content/plugins/dnssec.md index dfb5a84..e4830c1 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 = "2018-03-13T14:42:31.862305" +date = "2018-03-26T06:36:14.773478" +++ ## Description diff --git a/content/plugins/dnstap.md b/content/plugins/dnstap.md index afee1c0..8e3f1c9 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 = "2018-03-13T14:42:31.862552" +date = "2018-03-26T06:36:14.773980" +++ ## Description diff --git a/content/plugins/erratic.md b/content/plugins/erratic.md index 7ea432e..6e65946 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 = "2018-03-13T14:42:31.862741" +date = "2018-03-26T06:36:14.774559" +++ ## Description diff --git a/content/plugins/errors.md b/content/plugins/errors.md index 072c9df..5b1c51c 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 = "2018-03-13T14:42:31.862907" +date = "2018-03-26T06:36:14.775048" +++ ## Description diff --git a/content/plugins/etcd.md b/content/plugins/etcd.md index 815863d..ecde3a1 100644 --- a/content/plugins/etcd.md +++ b/content/plugins/etcd.md @@ -4,7 +4,7 @@ description = "*etcd* enables reading zone data from an etcd instance." weight = 11 tags = [ "plugin", "etcd" ] categories = [ "plugin" ] -date = "2018-03-13T14:42:31.863129" +date = "2018-03-26T06:36:14.775646" +++ ## Description diff --git a/content/plugins/federation.md b/content/plugins/federation.md index d0d6323..1f73b24 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 = "2018-03-13T14:42:31.863318" +date = "2018-03-26T06:36:14.776193" +++ ## Description diff --git a/content/plugins/file.md b/content/plugins/file.md index c2dc53c..3db095e 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 = "2018-03-13T14:42:31.863491" +date = "2018-03-26T06:36:14.776738" +++ ## Description diff --git a/content/plugins/forward.md b/content/plugins/forward.md index 12dea15..47abcc3 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 = "2018-03-13T14:42:31.863726" +date = "2018-03-26T06:36:14.777363" +++ ## Description diff --git a/content/plugins/health.md b/content/plugins/health.md index 92e7a18..0b39833 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 = "2018-03-13T14:42:31.863930" +date = "2018-03-26T06:36:14.777913" +++ ## Description diff --git a/content/plugins/hosts.md b/content/plugins/hosts.md index 541eaef..c1ada4d 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 = "2018-03-13T14:42:31.864118" +date = "2018-03-26T06:36:14.778188" +++ ## Description @@ -51,23 +51,29 @@ Load `/etc/hosts` file. Load `example.hosts` file in the current directory. ~~~ -hosts example.hosts +. { + hosts example.hosts +} ~~~ Load example.hosts file and only serve example.org and example.net from it and fall through to the next plugin if query doesn't match. ~~~ -hosts example.hosts example.org example.net { - fallthrough +. { + hosts example.hosts example.org example.net { + fallthrough + } } ~~~ Load hosts file inlined in Corefile. ~~~ -hosts example.hosts example.org { - 10.0.0.1 example.org - fallthrough +. { + hosts example.hosts example.org { + 10.0.0.1 example.org + fallthrough + } } ~~~ diff --git a/content/plugins/kubernetes.md b/content/plugins/kubernetes.md index f97b36e..4695c42 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 = 17 tags = [ "plugin", "kubernetes" ] categories = [ "plugin" ] -date = "2018-03-13T14:42:31.864268" +date = "2018-03-26T06:36:14.778948" +++ ## Description @@ -196,13 +196,14 @@ feature enables serving federated domains from the kubernetes clusters. Some query labels accept a wildcard value to match any value. If a label is a valid wildcard (\*, or the word "any"), then that label will match all values. The labels that accept wildcards are: - * _service_ in an `A` record request: _service_.namespace.svc.zone, e.g. `*.ns.svc.myzone.local` - * _namespace_ in an `A` record request: service._namespace_.svc.zone, e.g. `nginx.*.svc.myzone.local` + * _endpoint_ in an `A` record request: _endpoint_.service.namespace.svc.zone, e.g. `*.nginx.ns.svc.cluster.local` + * _service_ in an `A` record request: _service_.namespace.svc.zone, e.g. `*.ns.svc.cluster.local` + * _namespace_ in an `A` record request: service._namespace_.svc.zone, e.g. `nginx.*.svc.cluster.local` * _port and/or protocol_ in an `SRV` request: __port_.__protocol_.service.namespace.svc.zone., - e.g. `_http.*.service.ns.svc.` + e.g. `_http.*.service.ns.svc.cluster.local` * multiple wild cards are allowed in a single query, e.g. `A` Request `*.*.svc.zone.` or `SRV` request `*.*.*.*.svc.zone.` - * Wildcard can be used also to resolve PODs IPs as `A` records in a Service with ClusterIP. e.g.: `*.service.ns.svc.myzone.local` will return the PODs IPs as the following: + For example, Wildcards can be used to resolve all Endpoints for a Service as `A` records. e.g.: `*.service.ns.svc.myzone.local` will return the Endpoint IPs in the Service `service` in namespace `default`: ``` *.service.default.svc.cluster.local. 5 IN A 192.168.10.10 *.service.default.svc.cluster.local. 5 IN A 192.168.25.15 diff --git a/content/plugins/loadbalance.md b/content/plugins/loadbalance.md index 36e1ea2..8cc5ee7 100644 --- a/content/plugins/loadbalance.md +++ b/content/plugins/loadbalance.md @@ -4,7 +4,7 @@ description = "*loadbalance* acts as a round-robin DNS loadbalancer by randomizi weight = 18 tags = [ "plugin", "loadbalance" ] categories = [ "plugin" ] -date = "2018-03-13T14:42:31.864443" +date = "2018-03-26T06:36:14.779541" +++ in the answer. diff --git a/content/plugins/log.md b/content/plugins/log.md index 36aaa0c..ece9c3d 100644 --- a/content/plugins/log.md +++ b/content/plugins/log.md @@ -4,7 +4,7 @@ description = "*log* enables query logging to standard output." weight = 19 tags = [ "plugin", "log" ] categories = [ "plugin" ] -date = "2018-03-13T14:42:31.864629" +date = "2018-03-26T06:36:14.780062" +++ ## Description diff --git a/content/plugins/metrics.md b/content/plugins/metrics.md index c0ce87e..84b3dd1 100644 --- a/content/plugins/metrics.md +++ b/content/plugins/metrics.md @@ -4,7 +4,7 @@ description = "*prometheus* enables [Prometheus](https://prometheus.io/) metrics weight = 20 tags = [ "plugin", "metrics" ] categories = [ "plugin" ] -date = "2018-03-13T14:42:31.864825" +date = "2018-03-26T06:36:14.780589" +++ ## Description diff --git a/content/plugins/nsid.md b/content/plugins/nsid.md index dc559af..14ffd59 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 = 21 tags = [ "plugin", "nsid" ] categories = [ "plugin" ] -date = "2018-03-13T14:42:31.865007" +date = "2018-03-26T06:36:14.781102" +++ ## Description diff --git a/content/plugins/pprof.md b/content/plugins/pprof.md index 68d6989..3d8964b 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 = 22 tags = [ "plugin", "pprof" ] categories = [ "plugin" ] -date = "2018-03-13T14:42:31.865229" +date = "2018-03-26T06:36:14.781649" +++ ## Description diff --git a/content/plugins/proxy.md b/content/plugins/proxy.md index 0e14929..1073537 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 = 23 tags = [ "plugin", "proxy" ] categories = [ "plugin" ] -date = "2018-03-13T14:42:31.865488" +date = "2018-03-26T06:36:14.782240" +++ ## Description diff --git a/content/plugins/reload.md b/content/plugins/reload.md index 170bdf7..ed778dc 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 = 24 tags = [ "plugin", "reload" ] categories = [ "plugin" ] -date = "2018-03-13T14:42:31.865630" +date = "2018-03-26T06:36:14.782749" +++ ## Description diff --git a/content/plugins/reverse.md b/content/plugins/reverse.md index de10724..313d9a0 100644 --- a/content/plugins/reverse.md +++ b/content/plugins/reverse.md @@ -4,7 +4,7 @@ description = "*reverse* allows for dynamic responses to PTR and the related A/A weight = 25 tags = [ "plugin", "reverse" ] categories = [ "plugin" ] -date = "2018-03-13T14:42:31.865813" +date = "2018-03-26T06:36:14.783276" +++ ## Description diff --git a/content/plugins/rewrite.md b/content/plugins/rewrite.md index fecbc49..538cb7c 100644 --- a/content/plugins/rewrite.md +++ b/content/plugins/rewrite.md @@ -4,7 +4,7 @@ description = "*rewrite* performs internal message rewriting." weight = 26 tags = [ "plugin", "rewrite" ] categories = [ "plugin" ] -date = "2018-03-13T14:42:31.866057" +date = "2018-03-26T06:36:14.783877" +++ ## Description diff --git a/content/plugins/root.md b/content/plugins/root.md index f1113b0..b7d524c 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 = 27 tags = [ "plugin", "root" ] categories = [ "plugin" ] -date = "2018-03-13T14:42:31.866228" +date = "2018-03-26T06:36:14.784389" +++ ## Description diff --git a/content/plugins/route53.md b/content/plugins/route53.md index 5d3af20..5ede205 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 = 28 tags = [ "plugin", "route53" ] categories = [ "plugin" ] -date = "2018-03-13T14:42:31.866394" +date = "2018-03-26T06:36:14.784909" +++ ## Description diff --git a/content/plugins/secondary.md b/content/plugins/secondary.md index 694b974..9cd7011 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 = 29 tags = [ "plugin", "secondary" ] categories = [ "plugin" ] -date = "2018-03-13T14:42:31.866579" +date = "2018-03-26T06:36:14.785347" +++ ## Description diff --git a/content/plugins/template.md b/content/plugins/template.md index 2fea6a4..afc8aef 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 = 30 tags = [ "plugin", "template" ] categories = [ "plugin" ] -date = "2018-03-13T14:42:31.866888" +date = "2018-03-26T06:36:14.786011" +++ ## Description diff --git a/content/plugins/tls.md b/content/plugins/tls.md index c29a2ee..a9018e9 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 = 31 tags = [ "plugin", "tls" ] categories = [ "plugin" ] -date = "2018-03-13T14:42:31.867103" +date = "2018-03-26T06:36:14.786560" +++ ## Description diff --git a/content/plugins/trace.md b/content/plugins/trace.md index e9dfde5..fabd8ec 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 = 32 tags = [ "plugin", "trace" ] categories = [ "plugin" ] -date = "2018-03-13T14:42:31.867222" +date = "2018-03-26T06:36:14.787026" +++ ## Description diff --git a/content/plugins/whoami.md b/content/plugins/whoami.md index 139257d..0ba2514 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 = 33 tags = [ "plugin", "whoami" ] categories = [ "plugin" ] -date = "2018-03-13T14:42:31.867409" +date = "2018-03-26T06:36:14.787575" +++ ## Description