2020-10-30 18:08:56 +00:00
---
stage: none
group: unassigned
2020-11-26 06:09:20 +00:00
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
2020-10-30 18:08:56 +00:00
---
2021-10-27 21:11:33 +00:00
# Instance-level Kubernetes clusters (certificate-based) (DEPRECATED) **(FREE SELF)**
2019-05-20 16:51:52 +00:00
2021-10-27 21:11:33 +00:00
> - [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/39840) in GitLab 11.11.
> - [Deprecated](https://gitlab.com/groups/gitlab-org/configure/-/epics/8) in GitLab 14.5.
WARNING:
This feature was [deprecated ](https://gitlab.com/groups/gitlab-org/configure/-/epics/8 ) in GitLab 14.5. To connect clusters to GitLab,
2022-02-22 03:14:19 +00:00
use the [GitLab agent ](../../clusters/agent/index.md ).
2019-05-20 16:51:52 +00:00
Similar to [project-level ](../../project/clusters/index.md )
and [group-level ](../../group/clusters/index.md ) 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.
2021-06-14 03:09:53 +00:00
To view the instance level Kubernetes clusters:
2021-08-26 09:11:15 +00:00
1. On the top bar, select **Menu > Admin** .
2021-09-08 18:11:23 +00:00
1. On the left sidebar, select **Kubernetes** .
2020-09-23 15:10:14 +00:00
2019-05-20 16:51:52 +00:00
## Cluster precedence
2020-11-20 03:09:15 +00:00
GitLab tries to match clusters in the following order:
2019-05-20 16:51:52 +00:00
2019-12-20 09:24:38 +00:00
- Project-level clusters.
- Group-level clusters.
- Instance-level clusters.
2019-05-20 16:51:52 +00:00
To be selected, the cluster must be enabled and
2021-08-11 09:10:00 +00:00
match the [environment selector ](../../../ci/environments/index.md#scope-environments-with-specs ).
2019-10-15 06:07:25 +00:00
## Cluster environments **(PREMIUM)**
2020-05-15 18:07:52 +00:00
For a consolidated view of which CI [environments ](../../../ci/environments/index.md )
2019-10-15 06:07:25 +00:00
are deployed to the Kubernetes cluster, see the documentation for
[cluster environments ](../../clusters/environments.md ).
2019-12-20 09:24:38 +00:00
## More information
For information on integrating GitLab and Kubernetes, see
2021-10-09 00:12:30 +00:00
[Kubernetes clusters ](../../infrastructure/clusters/index.md ).