NOTE: These instructions pertain to clusters that have already been manually provisioned. In order to create a new cluster, see here.

One of the easiest ways to launch a new Kubernetes cluster on Google Cloud Platform, is by using the Google Kubernetes Engine (GKE). With just a few clicks in the Google Cloud Console, you can provision a cluster, with a fully-managed master tier. After it's up and running, you can attach the cluster to Containership Cloud.

Getting Started

If you have not done so already, follow these instructions to provision a new GKE cluster. Please ensure that the 'Basic Authentication' feature is enabled. 

NOTE: at this time only basic authentication is supported when attaching a GKE cluster to Containership Cloud. It's possible to attach your cluster using a bearer token that Google automatically generates, but it will expire every hour, which prevents Containership Cloud from communicating with your cluster. Token authentication may be supported in a future release.

After your cluster is fully provisioned, navigate to the GKE page in your Google Cloud Console, and find your new cluster:

You will need a few pieces of information about your cluster in order to attach it to Containership Cloud. First select your cluster in the screen above, then make note of the Endpoint, listed on the following screen:

After you have noted the Endpoint, select Show Credentials on the page shown above. This will display additional information that will help in attaching your cluster:

Grab the Username,  Password and Cluster CA Certificate shown on the screen above. (NOTE: If you copy & paste the CA Cert directly from the Google Cloud Console web interface, be aware that the pasted string may contain spaces, where there should be new line characters. To avoid this issue, you can copy & paste the base64 encoded value of certificate-authority-data from your ~/.kube/config file. We allow entering either base64 encoded or plain text certificates during this step.) Then, head over to , and log into your account.

Attaching your cluster

Step 1. Click on the "Create" button and choose "Cluster"

Step 2. Choose "Attach Cluster"

Step 3. Set Connection Method to Manual Mode

Step 4. Enter the Endpoint address that you obtained from the Google Cloud Console, prefixed with 'https://' 

Step 5. Set Authentication Method:

We will be using the "Basic" method of authenticating with the cluster when using GKE.

Step 6: Add the Cluster CA cert from the Google Console, and click continue

Step 7: Give your cluster a name and an environment

Step 8. Select optional Kubernetes service plugins

Step 9. Confirm cluster settings and attach.

Step 10. Your cluster is now successfully attached! Breathe a sigh of relief at how much easier managing your Kubernetes cluster will be now.

Did this answer your question?