istio.io/content/docs/setup/kubernetes/quick-start-gke/index.md

2.7 KiB

title description weight keywords aliases
Quick Start with Google Kubernetes Engine How to quickly setup Istio using Google Kubernetes Engine (GKE). 65
kubernetes
gke
google
/docs/setup/kubernetes/quick-start-gke-dm/

Quick Start instructions to install and run Istio in Google Kubernetes Engine (GKE) using Istio on GKE.

Prerequisites

  • This sample requires a valid Google Cloud Platform project with billing enabled. If you are not an existing GCP user, you may be able to enroll for a $300 US Free Trial credit.

  • Ensure that the Google Kubernetes Engine API is enabled for your project (also found by navigating to "APIs & Services" -> "Dashboard" in the navigation bar). If you do not see "API enabled", then you may enable the API by clicking the "Enable this API" button.

  • You must install and configure the gcloud command line tool and include the kubectl component (gcloud components install kubectl). If you don't want to install the gcloud client on your own machine, you can use gcloud via Google Cloud Shell to perform the same tasks.

  • {{< warning_icon >}} You must set your default compute service account to include:

    • roles/container.admin (Kubernetes Engine Admin)
    • Editor (on by default)

To set this up, navigate to the IAM section of the Cloud Console as shown below and find your default GCE/GKE service account in the following form: projectNumber-compute@developer.gserviceaccount.com: by default it should just have the Editor role. Then in the Roles drop-down list for that account, find the Kubernetes Engine group and select the role Kubernetes Engine Admin. The Roles listing for your account will change to Multiple.

{{< image ratio="22.9%" link="./dm_gcp_iam.png" caption="GKE-IAM Service" >}}

Then add the Kubernetes Engine Admin role:

{{< image width="70%" ratio="65.1%" link="./dm_gcp_iam_role.png" caption="GKE-IAM Role" >}}

Setup using Istio on GKE

Refer to the Istio on GKE documentation for instructions on creating a cluster with Istio installed.

Once the cluster is ready, acquire the credentials for this cluster.

{{< text bash >}} $ gcloud container clusters get-credentials <your_cluster> --zone=<your_zone> {{< /text >}}

You can now try out one of the Istio examples like Bookinfo.