Adding a cluster

There are two options when adding a new cluster; either use Google Kubernetes
Engine (GKE) or provide the credentials to your own Kubernetes cluster.

To add a new cluster:

Navigate to your project's CI/CD > Cluster page

If you want to let GitLab create a cluster on GKE for you, go through the
following steps, otherwise skip to the next one.

Click on Create with GKE

Connect your Google account if you haven't done already by clicking the
Sign in with Google button

Fill in the requested values:

Cluster name (required) - The name you wish to give the cluster.

GCP project ID (required) - The ID of the project you created in your GCP
console that will host the Kubernetes cluster. This must not be confused
with the project name. Learn more about Google Cloud Platform projects.

Helm is a package manager for Kubernetes and is required to install all the other applications. It will be automatically installed as a dependency when you try to install a different app. It is installed in its own pod inside the cluster which can run the helm CLI in a safe environment.

Ingress can provide load balancing, SSL termination and name-based virtual hosting. It acts as a web proxy for your applications and is useful if you want to use Auto DevOps or deploy your own web apps.

Enabling or disabling the Cluster integration

After you have successfully added your cluster information, you can enable the
Cluster integration:

Click the "Enabled/Disabled" switch

Hit Save for the changes to take effect

You can now start using your Kubernetes cluster for your deployments.

To disable the Cluster integration, follow the same procedure.

Removing the Cluster integration

NOTE: Note:
You need Master permissions and above to remove a cluster integration.

NOTE: Note:
When you remove a cluster, you only remove its relation to GitLab, not the
cluster itself. To remove the cluster, you can do so by visiting the GKE
dashboard or using kubectl.

To remove the Cluster integration from your project, simply click on the
Remove integration button. You will then be able to follow the procedure
and add a cluster again.