Files
coredns/plugin/federation/README.md
Miek Gieben be1ac9fed4 plugins: remove upstream [ADDRESS] from docs (#2772)
Various plugins still had this documented, the setup functions still
allow it (which is fine), but update the docs that this arguments isn't
there any more.

Signed-off-by: Miek Gieben <miek@miek.nl>
2019-04-08 16:45:29 +01:00

45 lines
1.0 KiB
Markdown

# federation
## Name
*federation* - enables federated queries to be resolved via the kubernetes plugin.
## Description
Enabling this plugin allows
[Federated](https://kubernetes.io/docs/tasks/federation/federation-service-discovery/) queries to be
resolved via the kubernetes plugin.
Enabling *federation* without also having *kubernetes* is a noop.
## Syntax
~~~
federation [ZONES...] {
NAME DOMAIN
upstream
}
~~~
* Each **NAME** and **DOMAIN** defines federation membership. One entry for each. A duplicate
**NAME** will silently overwrite any previous value.
* `upstream` resolve the `CNAME` target produced by this plugin. CoreDNS
will resolve External Services against itself and needs the *forward* plugin to be active to do
so.
## Examples
Here we handle all service requests in the `prod` and `stage` federations.
~~~
. {
kubernetes cluster.local
federation cluster.local {
prod prod.feddomain.com
staging staging.feddomain.com
upstream
}
forward . 192.168.1.12
}
~~~