mirror of
https://github.com/coredns/coredns.io.git
synced 2024-04-21 12:32:00 +00:00
Miek Gieben
9d3c78f16f
Make notes in coredns' repo to make it authoritative there. Signed-off-by: Miek Gieben <miek@miek.nl>
59 lines
1.2 KiB
Markdown
59 lines
1.2 KiB
Markdown
+++
|
|
title = "federation"
|
|
description = "*federation* enables federated queries to be resolved via the kubernetes plugin."
|
|
weight = 12
|
|
tags = [ "plugin", "federation" ]
|
|
categories = [ "plugin" ]
|
|
date = "2019-03-03T14:11:50.602659"
|
|
+++
|
|
|
|
## 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` [**ADDRESS**...] resolve the `CNAME` target produced by this plugin. CoreDNS
|
|
will resolve External Services against itself.
|
|
|
|
## 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
|
|
}
|
|
}
|
|
~~~
|
|
|
|
Or slightly shorter:
|
|
|
|
~~~
|
|
cluster.local {
|
|
kubernetes
|
|
federation {
|
|
prod prod.feddomain.com
|
|
staging staging.feddomain.com
|
|
upstream
|
|
}
|
|
}
|
|
~~~
|