Mirrors/coredns
1
0
Fork 0
mirror of https://github.com/coredns/coredns.git synced 2025-10-27 16:24:19 -04:00
Code Issues Packages Projects Releases Wiki Activity
Files
47719756fed4946db4b1d3e9ca36d09e2c360cad
coredns/plugin/chaos/README.md

52 lines
1.0 KiB
Markdown
Raw Normal View History

Implement chaos middleware This allows for CH TXT queries that return some information about the server and/or the authors (or whatever you put in there).
2016-03-24 17:58:31 +00:00
# chaos
Manual pages (#1346) * Add manual pages Generate manual pages from the README and extend README with Name and Description sections. The generation requires 'ronn' which may not be available. Just check in all generated manual pages.
2018-01-04 12:53:07 +00:00
## Name
Fix all READMEs and some other fluff (#788)
2017-07-24 08:24:53 -07:00
Manual pages (#1346) * Add manual pages Generate manual pages from the README and extend README with Name and Description sections. The generation requires 'ronn' which may not be available. Just check in all generated manual pages.
2018-01-04 12:53:07 +00:00
*chaos* - allows for responding to TXT queries in the CH class.
## Description
This is useful for retrieving version or author information from the server by querying a TXT record
typo fixes (#3169) * spelling fixes * its/it's
2019-08-21 16:08:55 -04:00
for a special domain name in the CH class.
Implement chaos middleware This allows for CH TXT queries that return some information about the server and/or the authors (or whatever you put in there).
2016-03-24 17:58:31 +00:00
## Syntax
~~~
docs: rewrite using manpage style (#327) This still needs cleanup, but this is a first pass the cleans some cruft and documents our style (in middleware.md) and makes all the docs match that style.
2016-10-10 20:13:22 +01:00
chaos [VERSION] [AUTHORS...]
Implement chaos middleware This allows for CH TXT queries that return some information about the server and/or the authors (or whatever you put in there).
2016-03-24 17:58:31 +00:00
~~~
ServiceBackend interface (#369) * Add ServiceBackend interface This adds a ServiceBackend interface that is shared between etcd/etcd3 (later) and kubernetes, leading to a massive reduction in code. When returning the specific records from their backend. Fixes #273
2016-10-30 15:54:16 +00:00
* **VERSION** is the version to return. Defaults to `CoreDNS-<version>`, if not set.
plugin/chaos: add default list of authors (#2737) * plugin/chaos: add default list of authors Add a owners_generate.go that generates a Owners variables for use in the chaos plugin. Add a default list of authors in the authors.bind CH zone. When doing a query this now returns: ~~~ sh % dig authors.bind TXT CH ;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 5456 ;; flags: qr rd; QUERY: 1, ANSWER: 22, AUTHORITY: 0, ADDITIONAL: 1 ;; WARNING: recursion requested but not available ;; OPT PSEUDOSECTION: ; EDNS: version: 0, flags:; udp: 4096 ;; QUESTION SECTION: ;authors.bind. CH TXT ;; ANSWER SECTION: authors.bind. 0 CH TXT "bradbeam" authors.bind. 0 CH TXT "chrisohaver" authors.bind. 0 CH TXT "dilyevsky" authors.bind. 0 CH TXT "ekleiner" authors.bind. 0 CH TXT "fastest963" authors.bind. 0 CH TXT "fturib" authors.bind. 0 CH TXT "greenpau" authors.bind. 0 CH TXT "grobie" authors.bind. 0 CH TXT "inigohu" authors.bind. 0 CH TXT "isolus" authors.bind. 0 CH TXT "johnbelamaric" authors.bind. 0 CH TXT "miekg" authors.bind. 0 CH TXT "nchrisdk" authors.bind. 0 CH TXT "nitisht" authors.bind. 0 CH TXT "pmoroney" authors.bind. 0 CH TXT "rajansandeep" authors.bind. 0 CH TXT "rdrozhdzh" authors.bind. 0 CH TXT "rtreffer" authors.bind. 0 CH TXT "stp-ip" authors.bind. 0 CH TXT "superq" authors.bind. 0 CH TXT "varyoo" authors.bind. 0 CH TXT "yongtang" ~~~ This was hard to do previously as we didn't hardcode this in the source, but now with OWNERS files we can just generate this list. Privacy wise this isn't worse than being listed in OWNERS file in the first place. And it's a nice hat tip to the people making CoreDNS better. Signed-off-by: Miek Gieben <miek@miek.nl> * Sticklet bot comments Signed-off-by: Miek Gieben <miek@miek.nl>
2019-03-31 19:01:11 +01:00
* **AUTHORS** is what authors to return. This defaults to all GitHub handles in the OWNERS files.
Implement chaos middleware This allows for CH TXT queries that return some information about the server and/or the authors (or whatever you put in there).
2016-03-24 17:58:31 +00:00
Remove the word middleware (#1067) * Rename middleware to plugin first pass; mostly used 'sed', few spots where I manually changed text. This still builds a coredns binary. * fmt error * Rename AddMiddleware to AddPlugin * Readd AddMiddleware to remain backwards compat
2017-09-14 09:36:06 +01:00
Note that you have to make sure that this plugin will get actual queries for the
Fix stubzone retention (#198) Make the receiver a pointer so that the uptdateStubZones map update will retain the stubzones found, unlike the current case where the update will be applied and then promptly forgotten, because it is working on a copy. Add test/etcd_test.go to test a large part of the code. This didn't catch the chaos middleware hack though. The chaos middleware zones are now *not* automatically added. You have to take care of that by yourself (docs updates). When using debug queries and falling through to the next middleware in etcd, restore the original (with o-o.debug) query before passing it on.
2016-08-08 19:18:55 -07:00
following zones: `version.bind`, `version.server`, `authors.bind`, `hostname.bind` and
`id.server`.
Cleanup docs and the chaos middleware Make the CH middleware actually work. Needs a bit of a hack to route the fake version.bind and friends zone to the correct handler. Fiddle with the order in directive.go so that CH queries get logged as well. Secondly add class rewriting to the rewrite middleware handler and also log the class by default.
2016-04-04 15:45:17 +01:00
Implement chaos middleware This allows for CH TXT queries that return some information about the server and/or the authors (or whatever you put in there).
2016-03-24 17:58:31 +00:00
## Examples
mw/chaos: update docs (#1055) * mw/chaos: update docs Fix/update the documentation: make the corefile snippets tested and expand them a little. Show `dig` example. Fixes #1050 * dot
2017-09-10 21:01:49 +01:00
Specify all the zones in full.
~~~ corefile
version.bind version.server authors.bind hostname.bind id.server {
chaos CoreDNS-001 info@coredns.io
}
~~~
Or just default to `.`:
~~~ corefile
. {
chaos CoreDNS-001 info@coredns.io
}
Implement chaos middleware This allows for CH TXT queries that return some information about the server and/or the authors (or whatever you put in there).
2016-03-24 17:58:31 +00:00
~~~
mw/chaos: update docs (#1055) * mw/chaos: update docs Fix/update the documentation: make the corefile snippets tested and expand them a little. Show `dig` example. Fixes #1050 * dot
2017-09-10 21:01:49 +01:00
And test with `dig`:
~~~ txt
% dig @localhost CH TXT version.bind
...
;; ANSWER SECTION:
version.bind. 0 CH TXT "CoreDNS-001"
...
Implement chaos middleware This allows for CH TXT queries that return some information about the server and/or the authors (or whatever you put in there).
2016-03-24 17:58:31 +00:00
~~~
Reference in New Issue Copy Permalink