Quick Start with Google Kubernetes Engine

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 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.

GKE-IAM Service
GKE-IAM Service

Then add the Kubernetes Engine Admin role:

GKE-IAM Role
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.

$ gcloud container clusters get-credentials <your_cluster> --zone=<your_zone>

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

See also

Instructions to setup a Google Kubernetes Engine cluster for Istio.

Instructions to download the Istio release.

Example multicluster GKE install of Istio.

Example multicluster between IBM Cloud Kubernetes Service & IBM Cloud Private.

Example multicluster IBM Cloud Private install of Istio.

Describes the options available when installing Istio using the included Helm chart.