mirror of
				https://github.com/coredns/coredns.git
				synced 2025-11-04 03:03:14 -05:00 
			
		
		
		
	
		
			
	
	
		
			44 lines
		
	
	
		
			874 B
		
	
	
	
		
			Markdown
		
	
	
	
	
	
		
		
			
		
	
	
			44 lines
		
	
	
		
			874 B
		
	
	
	
		
			Markdown
		
	
	
	
	
	
| 
								 | 
							
								# federation
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								The *federation* middleware enables
							 | 
						||
| 
								 | 
							
								[federated](https://kubernetes.io/docs/tasks/federation/federation-service-discovery/) queries to be
							 | 
						||
| 
								 | 
							
								resolved via the kubernetes middleware.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								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.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								~~~ txt
							 | 
						||
| 
								 | 
							
								. {
							 | 
						||
| 
								 | 
							
								    kubernetes cluster.local 
							 | 
						||
| 
								 | 
							
								    federation cluster.local {
							 | 
						||
| 
								 | 
							
								        prod prod.feddomain.com
							 | 
						||
| 
								 | 
							
								        staging staging.feddomain.com
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								}
							 | 
						||
| 
								 | 
							
								~~~
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								Or slightly shorter:
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								~~~ txt
							 | 
						||
| 
								 | 
							
								cluster.local {
							 | 
						||
| 
								 | 
							
								    kubernetes
							 | 
						||
| 
								 | 
							
								    federation {
							 | 
						||
| 
								 | 
							
								        prod prod.feddomain.com
							 | 
						||
| 
								 | 
							
								        staging staging.feddomain.com
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								}
							 | 
						||
| 
								 | 
							
								~~~
							 |