Skip to content

Instance-level 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 project-level and group-level Kubernetes clusters, instance-level Kubernetes clusters allow you to connect a Kubernetes cluster to the GitLab instance, which enables you to use the same cluster across multiple projects.

To view the instance level Kubernetes clusters:

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

Cluster precedence

GitLab tries to match clusters in the following order:

  • Project-level clusters.
  • Group-level clusters.
  • Instance-level 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.