Skip to content

Instance Kubernetes clusters (certificate-based) (deprecated)

DETAILS: Tier: Free, Premium, Ultimate Offering: Self-managed

WARNING: This feature was deprecated in GitLab 14.5. To connect clusters to GitLab, use the GitLab agent.

Similar to Kubernetes clusters for projects and groups, instance Kubernetes clusters enable you to connect a Kubernetes cluster to the GitLab instance, and use the same cluster across multiple projects.

To view Kubernetes clusters for your instance:

  1. On the left sidebar, at the bottom, select Admin.
  2. Select Kubernetes.

Cluster precedence

GitLab tries to match clusters in the following order:

  • Project clusters.
  • Group clusters.
  • Instance clusters.

To be selected, the cluster must be enabled and match the environment selector.

Cluster environments

DETAILS: Tier: Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

For a consolidated view of which CI environments are deployed to the Kubernetes cluster, see the documentation for cluster environments.

More information

For information on integrating GitLab and Kubernetes, see Kubernetes clusters.