Instance Kubernetes clusters (certificate-based) (deprecated)

{{< details >}}

  • Tier: Free, Premium, Ultimate
  • Offering: GitLab Self-Managed

{{< /details >}}

{{< alert type=”warning” >}}

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

{{< /alert >}}

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, GitLab Self-Managed, GitLab Dedicated

{{< /details >}}

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.