[kubernetes] Improve documentation.

- Add details to the labelselector parameter. - Add section on ExternalNames in the guide.
traefik · Jul 8, 2017 · 3f9d1dd · 3f9d1dd
1 parent 759a19b
commit 3f9d1dd
Show file tree

Hide file tree

Showing 2 changed files with 11 additions and 2 deletions.
diff --git a/docs/toml.md b/docs/toml.md
@@ -1220,9 +1220,13 @@ Træfik can be configured to use Kubernetes Ingress as a backend configuration:
 #
 # namespaces = ["default", "production"]
 
-# See: http://kubernetes.io/docs/user-guide/labels/#list-and-watch-filtering
-# labelselector = "A and not B"
+# Ingress label selector to identify Ingress objects that should be processed.
+# See https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors for details.
+#
+# Optional
+# Default: empty (process all Ingresses)
 #
+# labelselector = "A and not B"
 ```
 
 Annotations can be used on containers to override default behaviour for the whole Ingress resource:

diff --git a/docs/user-guide/kubernetes.md b/docs/user-guide/kubernetes.md
@@ -510,6 +510,11 @@ You should now be able to visit the websites in your browser.
 * [cheeses.minikube/cheddar](http://cheeses.minikube/cheddar/)
 * [cheeses.minikube/wensleydale](http://cheeses.minikube/wensleydale/)
 
+## Forwarding to ExternalNames
+
+When specifying an [ExternalName](https://kubernetes.io/docs/concepts/services-networking/service/#services-without-selectors),
+Træfik will forward requests to the given host accordingly and use HTTPS when the Service port matches 443. This still requires setting up a proper port mapping on the Service from the Ingress port to the (external) Service port.
+
 ## Disable passing the Host header
 
 By default Træfik will pass the incoming Host header on to the upstream resource.