Merge pull request #1330 from ottolote/setup-gke

Add Google Kubernetes Engine cluster setup

daprdocs/content/en/operations/hosting/kubernetes/cluster/setup-gke.md

@@ -0,0 +1,55 @@
+---
+type: docs
+title: "Setup a Google Kubernetes Engine cluster"
+linkTitle: "Google Kubernetes Engine"
+weight: 3000
+description: "Setup a Google Kubernetes Engine cluster"
+---
+
+### Prerequisites
+
+- [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/)
+- [Google Cloud SDK](https://cloud.google.com/sdk)
+
+## Create a new cluster
+```bash
+$ gcloud services enable container.googleapis.com && \
+  gcloud container clusters create $CLUSTER_NAME \
+  --zone $ZONE \
+  --project $PROJECT_ID
+```
+For more options refer to the [Google Cloud SDK docs](https://cloud.google.com/sdk/gcloud/reference/container/clusters/create), or instead create a cluster through the [Cloud Console](https://console.cloud.google.com/kubernetes) for a more interactive experience.
+
+{{% alert title="For private GKE clusters" color="warning" %}}
+Sidecar injection will not work for private clusters without extra steps. An automatically created firewall rule for master access does not open port 4000. This is needed for Dapr sidecar injection.
+
+To review the relevant firewall rule:
+```bash
+$ gcloud compute firewall-rules list --filter="name~gke-${CLUSTER_NAME}-[0-9a-z]*-master"
+```
+
+To replace the existing rule and allow kubernetes master access to port 4000:
+```bash
+$ gcloud compute firewall-rules update <firewall-rule-name> --allow tcp:10250,tcp:443,tcp:4000
+```
+{{% /alert %}}
+
+## Retrieve your credentials for `kubectl`
+
+```bash
+$ gcloud container clusters get-credentials $CLUSTER_NAME \
+    --zone $ZONE \
+    --project $PROJECT_ID
+```
+
+## (optional) Install Helm v3
+
+1. [Install Helm v3 client](https://helm.sh/docs/intro/install/)
+
+> **Note:** The latest Dapr helm chart no longer supports Helm v2. Please migrate from helm v2 to helm v3 by following [this guide](https://helm.sh/blog/migrate-from-helm-v2-to-helm-v3/).
+
+2. In case you need permissions  the kubernetes dashboard (i.e. configmaps is forbidden: User "system:serviceaccount:kube-system:kubernetes-dashboard" cannot list configmaps in the namespace "default", etc.) execute this command
+
+```bash
+kubectl create clusterrolebinding kubernetes-dashboard -n kube-system --clusterrole=cluster-admin --serviceaccount=kube-system:kubernetes-dashboard
+```

daprdocs/content/en/operations/hosting/kubernetes/cluster/setup-minikube.md

@@ -2,7 +2,7 @@
 type: docs
 title: "Setup an Minikube cluster"
 linkTitle: "Minikube"
-weight: 2000
+weight: 1000
 description: >
   How to setup Dapr on a Minikube cluster.
 ---

daprdocs/content/en/operations/troubleshooting/common_issues.md

@@ -47,6 +47,8 @@ If your pod spec template is annotated correctly and you still don't see the sid
 
 If this is the case, restarting the pods will fix the issue.
 
+If you are deploying Dapr on a private GKE cluster, sidecar injection does not work without extra steps. See [Setup a Google Kubernetes Engine cluster]({{< ref setup-gke.md >}}).
+
 In order to further diagnose any issue, check the logs of the Dapr sidecar injector:
 
 ```bash
@@ -202,4 +204,4 @@ This is usually due to one of the following issues
 
 - You may have defined the `NAMESPACE` environment variable locally or deployed your components into a different namespace in Kubernetes. Check which namespace your app and the components are deployed to. Read [scoping components to one or more applications]({{< ref "component-scopes.md" >}}) for more information. 
 - You may have not provided a `--components-path` with the Dapr `run` commands or not placed your components into the default components folder for your OS. Read [define a component]({{< ref "get-started-component.md" >}}) for more information. 
-- You may have a syntax issue in component YAML file. Check your component YAML with the component [YAML samples]({{< ref "components.md" >}}).
+- You may have a syntax issue in component YAML file. Check your component YAML with the component [YAML samples]({{< ref "components.md" >}}).