Instance Kubernetes clusters (certificate-based) (deprecated)

{{< details >}}

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

{{< /details >}}

[!warning] This feature was deprecated in GitLab 14.5. To connect clusters to GitLab, use the GitLab agent for Kubernetes.

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. In the upper-right corner, 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.