2019-05-20 16:51:52 +00:00
|
|
|
# Instance-level Kubernetes clusters
|
|
|
|
|
|
2020-05-22 03:08:28 +00:00
|
|
|
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/39840) in GitLab 11.11.
|
2019-05-20 16:51:52 +00:00
|
|
|
|
|
|
|
|
## Overview
|
|
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
## Cluster precedence
|
|
|
|
|
|
2020-05-15 18:07:52 +00:00
|
|
|
GitLab will try [to match](../../../ci/environments/index.md#scoping-environments-with-specs) clusters in
|
2019-12-20 09:24:38 +00:00
|
|
|
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
|
2020-05-15 18:07:52 +00:00
|
|
|
match the [environment selector](../../../ci/environments/index.md#scoping-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
|
|
|
|
|
[Kubernetes clusters](../../project/clusters/index.md).
|
