mirror of
https://github.com/coredns/coredns.git
synced 2025-10-27 08:14:18 -04:00
db0b16b615
Add a ready plugin that allows plugin to signal when they are ready.
Once a plugin is ready it is not queried again.
This uses same mechanism as the health plugin: each plugin needs to
implement an interface.
Implement readines for the *erratic* plugin to aid in testing.
Add README.md and tests moduled after the health plugin; which will be
relegated to just providing process health. In similar vein to health
this is a process wide setting.
With this Corefile:
~~~
. {
erratic
whoami
ready
}
bla {
erratic
whoami
}
~~~
ready will lead to:
~~~ sh
% curl localhost:8181/ready
% dig @localhost -p 1053 mx example.org
% curl localhost:8181/ready
OK%
~~~
Meanwhile CoreDNS logs:
~~~
.:1053
bla.:1053
2019-02-26T20:59:07.137Z [INFO] CoreDNS-1.3.1
2019-02-26T20:59:07.137Z [INFO] linux/amd64, go1.11.4,
CoreDNS-1.3.1
linux/amd64, go1.11.4,
2019-02-26T20:59:11.415Z [INFO] plugin/ready: Still waiting on: "erratic"
2019-02-26T20:59:13.510Z [INFO] plugin/ready: Still waiting on: "erratic"
~~~
*ready* can be used in multiple server blocks and will do the right
thing; query all those plugins from all server blocks for readiness.
This does a similar thing to the prometheus plugin.
Signed-off-by: Miek Gieben <miek@miek.nl>
59 lines
1.1 KiB
INI
59 lines
1.1 KiB
INI
# Directives are registered in the order they should be
|
|
# executed.
|
|
#
|
|
# Ordering is VERY important. Every plugin will
|
|
# feel the effects of all other plugin below
|
|
# (after) them during a request, but they must not
|
|
# care what plugin above them are doing.
|
|
|
|
# How to rebuild with updated plugin configurations:
|
|
# Modify the list below and run `go gen && go build`
|
|
|
|
# The parser takes the input format of
|
|
# <plugin-name>:<package-name>
|
|
# Or
|
|
# <plugin-name>:<fully-qualified-package-name>
|
|
#
|
|
# External plugin example:
|
|
# log:github.com/coredns/coredns/plugin/log
|
|
# Local plugin example:
|
|
# log:log
|
|
|
|
metadata:metadata
|
|
tls:tls
|
|
reload:reload
|
|
nsid:nsid
|
|
root:root
|
|
bind:bind
|
|
debug:debug
|
|
trace:trace
|
|
ready:ready
|
|
health:health
|
|
pprof:pprof
|
|
prometheus:metrics
|
|
errors:errors
|
|
log:log
|
|
dnstap:dnstap
|
|
chaos:chaos
|
|
loadbalance:loadbalance
|
|
cache:cache
|
|
rewrite:rewrite
|
|
dnssec:dnssec
|
|
autopath:autopath
|
|
template:template
|
|
hosts:hosts
|
|
route53:route53
|
|
federation:federation
|
|
k8s_external:k8s_external
|
|
kubernetes:kubernetes
|
|
file:file
|
|
auto:auto
|
|
secondary:secondary
|
|
etcd:etcd
|
|
loop:loop
|
|
forward:forward
|
|
proxy:github.com/coredns/proxy
|
|
erratic:erratic
|
|
whoami:whoami
|
|
on:github.com/mholt/caddy/onevent
|