Document the enableServiceLinks flag (#15611)

* Document the enableServiceLinks flag There are many cases of service discovery environment variables clashing with env vars expected by programs, causing hard to debug problems. The enableServiceLinks flag added in 1.13 should be mentioned here and not only on the API reference. * Update connect-applications-service.md * Update content/en/docs/concepts/services-networking/connect-applications-service.md Co-Authored-By: Qiming <[email protected]> * rephrased the action to use active voice style
kubernetes · Aug 6, 2019 · cc64c39 · cc64c39
1 parent cdc2573
commit cc64c39
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/content/en/docs/concepts/services-networking/connect-applications-service.md b/content/en/docs/concepts/services-networking/connect-applications-service.md
@@ -134,6 +134,12 @@ about the [service proxy](/docs/concepts/services-networking/service/#virtual-ip
 Kubernetes supports 2 primary modes of finding a Service - environment variables
 and DNS. The former works out of the box while the latter requires the
 [CoreDNS cluster addon](http://releases.k8s.io/{{< param "githubbranch" >}}/cluster/addons/dns/coredns).
+{{< note >}}
+If the service environment variables are not desired (because possible clashing with expected program ones,
+too many variables to process, only using DNS, etc) you can disable this mode by setting the `enableServiceLinks` 
+flag to `false` on the [pod spec](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#pod-v1-core). 
+{{< /note >}}
+
 
 ### Environment Variables