+++ title = "federation" description = "*federation* enables [federated](https://kubernetes.io/docs/tasks/federation/federation-service-discovery/) queries to be resolved via the kubernetes plugin." weight = 12 tags = [ "plugin", "federation" ] categories = [ "plugin" ] date = "2017-09-15T21:22:42.284578" +++ Enabling *federation* without also having *kubernetes* is a noop. ## Syntax ~~~ federation [ZONES...] { NAME DOMAIN ~~~ * Each **NAME** and **DOMAIN** defines federation membership. One entry for each. A duplicate **NAME** will silently overwrite any previous value. ## 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 } } ~~~ Or slightly shorter: ~~~ cluster.local { kubernetes federation { prod prod.feddomain.com staging staging.feddomain.com } } ~~~