mirror of
				https://github.com/coredns/coredns.git
				synced 2025-10-31 02:03:20 -04:00 
			
		
		
		
	* 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.
		
			
				
	
	
		
			51 lines
		
	
	
		
			964 B
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			51 lines
		
	
	
		
			964 B
		
	
	
	
		
			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
 | |
| }
 | |
| ~~~
 | |
| 
 | |
| * 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
 | |
|     }
 | |
| }
 | |
| ~~~
 |