aboutsummaryrefslogtreecommitdiff
path: root/plugin/federation/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'plugin/federation/README.md')
-rw-r--r--plugin/federation/README.md7
1 files changed, 7 insertions, 0 deletions
diff --git a/plugin/federation/README.md b/plugin/federation/README.md
index 021921cb2..1bcd23af6 100644
--- a/plugin/federation/README.md
+++ b/plugin/federation/README.md
@@ -17,11 +17,16 @@ Enabling *federation* without also having *kubernetes* is a noop.
~~~
federation [ZONES...] {
NAME DOMAIN
+ upstream [ADDRESS...]
}
~~~
* Each **NAME** and **DOMAIN** defines federation membership. One entry for each. A duplicate
**NAME** will silently overwrite any previous value.
+* `upstream` [**ADDRESS**...] defines the upstream resolvers used for resolving the `CNAME` target
+ produced by this plugin. If no **ADDRESS** is given, CoreDNS
+ will resolve External Services against itself. **ADDRESS** can be an IP, an IP:port, or a path
+ to a file structured like resolv.conf.
## Examples
@@ -33,6 +38,7 @@ Here we handle all service requests in the `prod` and `stage` federations.
federation cluster.local {
prod prod.feddomain.com
staging staging.feddomain.com
+ upstream
}
}
~~~
@@ -45,6 +51,7 @@ cluster.local {
federation {
prod prod.feddomain.com
staging staging.feddomain.com
+ upstream
}
}
~~~