Quickstart: Deploy to Cloud Run on GKE

Creating a GKE cluster with Cloud Run enabled

To create a cluster and enable it for Cloud Run on GKE:

1. Create a new cluster using the command:

   gcloud beta container clusters create CLUSTER_NAME \
     --addons=HorizontalPodAutoscaling,HttpLoadBalancing,Istio,CloudRun \
     --machine-type=n1-standard-4 \
     --cluster-version=latest \
     --zone=ZONE \
     --enable-stackdriver-kubernetes --enable-ip-alias \
     --scopes cloud-platform

   Replace

   • CLUSTER_NAME with the name you want for your cluster.
   • ZONE with the zone you are using for your cluster, for example, us-central1-a. You can use any zone supported by GKE.

   Note that the cluster won't be created unless you use the parameter --enable-stackdriver-kubernetes as shown.

   Note that although these instructions don't enable cluster autoscaling to resize clusters for demand, Cloud Run on GKE automatically scales instances within the cluster.

2. Wait for the cluster creation to complete. During the creation process, you should see messages similar to the following:

   Creating cluster my-cluster...done.
   Created [https://container.googleapis.com/v1beta1/ \
   projects/my-project/zones/us-central1-b/clusters/my-cluster].
   

   where my-project is your own project ID. You have just created a new Google Kubernetes Engine cluster named my-cluster in the project my-project

3. Set gcloud defaults to use your new cluster and cluster location, to avoid having to specify these when you use the gcloud command line:

   gcloud config set run/cluster CLUSTER_NAME
   gcloud config set run/cluster_location us-central1-a

   Replace CLUSTER_NAME with the name you used for your cluster, and if necessary replace us-central1-a with the supported cluster location of your choice.

Deploying a sample container

To deploy a container to the cluster you just created:

1. Go to Cloud Run

2. Click Create service to display the Create service form. In the form,

   1. Use the sample gcr.io/cloudrun/hello as the container image.

   2. Use the name hello as the service name. You use can some other name, but if you do, make sure you use that name later when you use the CURL command to access the service. These instructions assume you use hello.

   3. In the Location dropdown, make sure you select the cluster you just created in the previous steps.

3. Click Create and wait for the deployment to finish. This creates the service and deploys it to Cloud Run on GKE.

Congratulations! You have just deployed a service to a Cloud Run on GKE enabled cluster.

Accessing your deployed service

After you deploy your service, you can use CURL to send a request and verify the service is working, using the external IP address of the Load Balancer service created for the Istio ingress controller:

1. Go to the Google Kubernetes Engine page in the GCP Console:

   Go to Google Kubernetes Engine

2. Click Services in the left navigation panel to display a list of services.

3. Scroll down to the istio-ingressgateway service and copy the external IP address shown next to the Load Balancer, WITHOUT THE PORT setting, if there is one. For example, if the IP is XX.XXX.XX.XXX:15020, omit the :15020. Ignore the other IP addresses listed.

4. Invoke CURL, making sure to replace hello in the Host string with the name of your service, if you used a service name other than hello:

   curl -v -H "Host: hello.default.example.com" YOUR-IP

   Replace YOUR-IP with the IP address you obtained in the previous step.