2019-05-20 12:51:52 -04:00
|
|
|
# Instance-level Kubernetes clusters
|
|
|
|
|
|
2019-09-18 10:02:45 -04:00
|
|
|
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/39840) in GitLab 11.11.
|
2019-05-20 12:51:52 -04: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
|
|
|
|
|
|
2019-12-20 04:24:38 -05:00
|
|
|
GitLab will try [to match](../../../ci/environments.md#scoping-environments-with-specs) clusters in
|
|
|
|
|
the following order:
|
2019-05-20 12:51:52 -04:00
|
|
|
|
2019-12-20 04:24:38 -05:00
|
|
|
- Project-level clusters.
|
|
|
|
|
- Group-level clusters.
|
|
|
|
|
- Instance-level clusters.
|
2019-05-20 12:51:52 -04:00
|
|
|
|
|
|
|
|
To be selected, the cluster must be enabled and
|
2019-09-04 01:44:18 -04:00
|
|
|
match the [environment selector](../../../ci/environments.md#scoping-environments-with-specs).
|
2019-10-15 02:07:25 -04:00
|
|
|
|
|
|
|
|
## Cluster environments **(PREMIUM)**
|
|
|
|
|
|
|
|
|
|
For a consolidated view of which CI [environments](../../../ci/environments.md)
|
|
|
|
|
are deployed to the Kubernetes cluster, see the documentation for
|
|
|
|
|
[cluster environments](../../clusters/environments.md).
|
2019-12-20 04:24:38 -05:00
|
|
|
|
|
|
|
|
## More information
|
|
|
|
|
|
|
|
|
|
For information on integrating GitLab and Kubernetes, see
|
|
|
|
|
[Kubernetes clusters](../../project/clusters/index.md).
|
