Google Kubernetes Engine

2 min read

Learn how to set up a GKE cluster for your Coder deployment.

This guide shows you how to set up a Google Kubernetes Engine (GKE) cluster to which Coder can deploy.

Prerequisites

Before proceeding, make sure that the gcloud CLI is installed on your machine and configured to interact with your Google Cloud Platform account.

Set Up the GKE Cluster

The following will spin up a Kubernetes cluster using the gcloud command (be sure to replace the parameters (specifically PROJECT_ID and NEW_CLUSTER_NAME) as needed to reflect the needs of your environment).

gcloud beta container --project "PROJECT_ID" \
clusters create "NEW_CLUSTER_NAME" \
   --zone "us-central1-a" \
   --no-enable-basic-auth \
   --cluster-version "latest" \
   --machine-type "n1-standard-4" \
   --image-type "COS" \
   --disk-type "pd-standard" \
   --disk-size "50" \
   --metadata disable-legacy-endpoints=true \
   --scopes "https://www.googleapis.com/auth/cloud-platform" \
   --num-nodes "2" \
   --enable-stackdriver-kubernetes \
   --enable-ip-alias \
   --network "projects/PROJECT_ID/global/networks/default" \
   --subnetwork \
   "projects/PROJECT_ID/regions/us-central1/subnetworks/default" \
   --default-max-pods-per-node "110" \
   --addons HorizontalPodAutoscaling,HttpLoadBalancing \
   --enable-autoupgrade \
   --enable-autorepair \
   --enable-network-policy \
   --enable-autoscaling \
   --min-nodes "1" \
   --max-nodes "8"

To create clusters capable of supporting use of the CVMs deployment option:

gcloud beta container --project "PROJECT_ID" \
    clusters create "NEW_CLUSTER_NAME" \
    --zone "us-central1-a" \
    --no-enable-basic-auth \
    --node-version "latest" \
    --cluster-version "latest" \
    --machine-type "n1-standard-2" \
    --image-type "UBUNTU" \
    --disk-type "pd-standard" \
    --disk-size "50" \
    --metadata disable-legacy-endpoints=true \
    --scopes "https://www.googleapis.com/auth/cloud-platform" \
    --num-nodes "2" \
    --enable-stackdriver-kubernetes \
    --enable-ip-alias \
    --network "projects/PROJECT_ID/global/networks/default" \
    --subnetwork \
    "projects/PROJECT_ID/regions/us-central1/subnetworks/default" \
    --default-max-pods-per-node "110" \
    --addons HorizontalPodAutoscaling,HttpLoadBalancing \
    --enable-autoupgrade \
    --enable-autorepair \
    --enable-network-policy \
    --enable-autoscaling \
    --min-nodes "1" \
    --max-nodes "8"

Next Steps

At this point, you're ready to proceed to Installation.

Our docs are open source. See something wrong or unclear? Make an edit.