Add docker-for-desktop installation note (#2585)

* Add docker-for-desktop installation note

A default istio helm install under kubernetes running in docker-for-desktop wasn't working because pilot was reserving too much memory.  Added documentation to work around this

* Update index.md

* Create index.md

* Update index.md

* Update index.md

* Update index.md

* Rename content/docs/setup/kubernetes/platform-setup/index.md to content/docs/setup/kubernetes/platform-setup/docker-for-desktop/index.md

* Update index.md

* Update index.md

quoted memory allocation, capitalized Kubernetes

content/docs/setup/kubernetes/helm-install/index.md

@@ -25,6 +25,7 @@ plane and the sidecars for the Istio data plane.
   * [OpenShift Origin](/docs/setup/kubernetes/platform-setup/openshift/)
   * [Amazon Web Services (AWS) with Kops](/docs/setup/kubernetes/platform-setup/aws/)
   * [Azure](/docs/setup/kubernetes/platform-setup/azure/)
+  * [Docker For Desktop](/docs/setup/kubernetes/platform-setup/docker-for-desktop/)
 
 1. Check the [Requirements for Pods and Services](/docs/setup/kubernetes/spec-requirements/) on Pods and Services.
 

content/docs/setup/kubernetes/platform-setup/docker-for-desktop/index.md

@@ -0,0 +1,13 @@
+---
+title: Docker For Desktop
+description: Instructions to setup Docker For Desktop for use with Istio.
+weight: 15
+skip_seealso: true
+keywords: [platform-setup,kubernetes,docker-for-desktop]
+---
+
+If you want to run istio under docker for desktop's built-in Kubernetes, you may need to increase docker's memory limit
+under the *Advanced* pane of docker's preferences.  Pilot by default requests `2048Mi` of memory, which is docker's
+default limit.  Alternatively, you may reduce pilot's memory reservation by passing the helm argument
+`--set pilot.resources.requests.memory="512Mi"`.  Otherwise pilot may refuse to start due to insufficient resources.
+See [Installation Options](https://istio.io/docs/reference/config/installation-options) for more information.

content/docs/setup/kubernetes/quick-start/index.md

@@ -19,6 +19,7 @@ To install and configure Istio in a Kubernetes cluster, follow these instruction
   * [Amazon Web Services (AWS) with Kops](/docs/setup/kubernetes/platform-setup/aws/)
   * [Azure](/docs/setup/kubernetes/platform-setup/azure/)
   * [Alibaba Cloud](/docs/setup/kubernetes/platform-setup/alicloud/)
+  * [Docker For Desktop](/docs/setup/kubernetes/platform-setup/docker-for-desktop/)
 
 1. Check the [Requirements for Pods and Services](/docs/setup/kubernetes/spec-requirements/).
 

content/docs/tasks/traffic-management/egress/index.md

@@ -262,6 +262,19 @@ Use `--set global.proxy.includeIPRanges="10.244.0.0/16\,10.240.0.0/16`
 
 Use `--set global.proxy.includeIPRanges="10.0.0.1/24"`
 
+#### Docker For Desktop
+
+Use `--set global.proxy.includeIPRanges="10.96.0.0/12"`
+
+#### Bare Metal
+
+Use the value of your `service-cluster-ip-range`.  It's not fixed, but the default value is 10.96.0.0/12.  To determine your actual value:
+
+{{< text bash >}}
+$ kubectl describe pod kube-apiserver -n kube-system | grep 'service-cluster-ip-range'
+      --service-cluster-ip-range=10.96.0.0/12
+{{< /text >}}
+
 ### Access the external services
 
 After updating the `ConfigMap` _istio-sidecar-injector_ and redeploying the `sleep` application,

content/docs/tasks/traffic-management/ingress/index.md

@@ -114,6 +114,12 @@ Setting the ingress IP depends on the cluster provider:
     $ export INGRESS_HOST=$(minikube ip)
     {{< /text >}}
 
+1.  _Docker For Desktop:_
+
+    {{< text bash >}}
+    $ export INGRESS_HOST=127.0.0.1
+    {{< /text >}}
+
 1.  _Other environments (e.g., IBM Cloud Private etc):_
 
     {{< text bash >}}