| 
									
										
										
										
											2017-08-18 14:45:20 +01:00
										 |  |  | # federation
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2018-01-04 12:53:07 +00:00
										 |  |  | ## 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 | 
					
						
							| 
									
										
										
										
											2017-09-14 09:36:06 +01:00
										 |  |  | resolved via the kubernetes plugin. | 
					
						
							| 
									
										
										
										
											2017-08-18 14:45:20 +01:00
										 |  |  | 
 | 
					
						
							|  |  |  | Enabling *federation* without also having *kubernetes* is a noop. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ## Syntax
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | ~~~ | 
					
						
							|  |  |  | federation [ZONES...] { | 
					
						
							|  |  |  |     NAME DOMAIN | 
					
						
							| 
									
										
										
										
											2018-01-04 12:53:07 +00:00
										 |  |  | } | 
					
						
							| 
									
										
										
										
											2017-08-18 14:45:20 +01:00
										 |  |  | ~~~ | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | * 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. | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-09-15 09:56:05 +01:00
										 |  |  | ~~~ | 
					
						
							| 
									
										
										
										
											2017-08-18 14:45:20 +01:00
										 |  |  | . { | 
					
						
							| 
									
										
										
										
											2017-09-15 09:56:05 +01:00
										 |  |  |     kubernetes cluster.local | 
					
						
							| 
									
										
										
										
											2017-08-18 14:45:20 +01:00
										 |  |  |     federation cluster.local { | 
					
						
							|  |  |  |         prod prod.feddomain.com | 
					
						
							|  |  |  |         staging staging.feddomain.com | 
					
						
							|  |  |  |     } | 
					
						
							|  |  |  | } | 
					
						
							|  |  |  | ~~~ | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | Or slightly shorter: | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-09-15 09:56:05 +01:00
										 |  |  | ~~~ | 
					
						
							| 
									
										
										
										
											2017-08-18 14:45:20 +01:00
										 |  |  | cluster.local { | 
					
						
							|  |  |  |     kubernetes | 
					
						
							|  |  |  |     federation { | 
					
						
							|  |  |  |         prod prod.feddomain.com | 
					
						
							|  |  |  |         staging staging.feddomain.com | 
					
						
							|  |  |  |     } | 
					
						
							|  |  |  | } | 
					
						
							|  |  |  | ~~~ |