Files
gitlab-foss/doc/user/instance/clusters/_index.md
2025-07-09 21:12:05 +00:00

1.8 KiB

stage, group, info, title
stage group info title
none unassigned To determine the technical writer assigned to the Stage/Group associated with this page, see https://handbook.gitlab.com/handbook/product/ux/technical-writing/#assignments 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 for Kubernetes.

{{< /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.