Group-level Kubernetes clusters · Gitlab 中文文檔

# Group-level Kubernetes clusters > 原文：[https://docs.gitlab.com/ee/user/group/clusters/](https://docs.gitlab.com/ee/user/group/clusters/) * [Installing applications](#installing-applications) * [RBAC compatibility](#rbac-compatibility) * [Cluster precedence](#cluster-precedence) * [Multiple Kubernetes clusters](#multiple-kubernetes-clusters) * [GitLab-managed clusters](#gitlab-managed-clusters) * [Clearing the cluster cache](#clearing-the-cluster-cache) * [Base domain](#base-domain) * [Environment scopes](#environment-scopes-premium) * [Cluster environments](#cluster-environments-premium) * [Security of Runners](#security-of-runners) * [More information](#more-information) # Group-level Kubernetes clusters[](#group-level-kubernetes-clusters "Permalink") 在 GitLab 11.6 中[引入](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/34758) . 與[項目級](../../project/clusters/index.html)和[實例級](../../instance/clusters/index.html) Kubernetes 集群類似，組級 Kubernetes 集群允許您將 Kubernetes 集群連接到您的組，從而使您可以在多個項目中使用同一集群. ## Installing applications[](#installing-applications "Permalink") GitLab 可以在您的組級別集群中安裝和管理某些應用程序. 有關為您的組集群安裝，升級，卸載和故障排除應用程序的更多信息，請參閱[GitLab 托管應用程序](../../clusters/applications.html) . ## RBAC compatibility[](#rbac-compatibility "Permalink") 版本歷史 * 在 GitLab 11.4 中[引入](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/29398) . * [項目名稱空間限制](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/51716)是在 GitLab 11.5 中引入的. 對于具有 Kubernetes 集群的組中的每個項目，GitLab 都會在項目名稱空間中創建具有[`edit`權限](https://kubernetes.io/docs/reference/access-authn-authz/rbac/#user-facing-roles)的受限服務帳戶. ## Cluster precedence[](#cluster-precedence "Permalink") 如果項目的群集可用且未禁用，則 GitLab 在使用屬于包含該項目的組的任何群集之前，先使用項目的群集. 對于子組，如果未禁用該組，則 GitLab 將使用與項目最接近的祖先組的集群. ## Multiple Kubernetes clusters[](#multiple-kubernetes-clusters "Permalink") 版本歷史 * 在 13.2 中[引入](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/35094)了 GitLab Core. 您可以將多個 Kubernetes 集群關聯到您的組，并為不同的環境（例如開發，登臺和生產）維護不同的集群. 添加另一個群集時，請[設置環境范圍](#environment-scopes-premium)以幫助區分新群集和其他群集. ## GitLab-managed clusters[](#gitlab-managed-clusters "Permalink") 版本歷史 * 在 GitLab 11.5 中[引入](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/22011) . * 在 GitLab 11.11 中成為[可選](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/26565) . You can choose to allow GitLab to manage your cluster for you. If GitLab manages your cluster, resources for your projects will be automatically created. See the [Access controls](../../project/clusters/add_remove_clusters.html#access-controls) section for details on which resources GitLab creates for you. 對于不受 GitLab 管理的集群，將不會自動創建特定于項目的資源. 如果將[Auto DevOps](../../../topics/autodevops/index.html)用于具有不受 GitLab 管理的群集的部署，則必須確保： * 項目的部署服務帳戶有權部署到[`KUBE_NAMESPACE`](../../project/clusters/index.html#deployment-variables) . * `KUBECONFIG`正確反映了對`KUBE_NAMESPACE`任何更改（這[不是自動的](https://gitlab.com/gitlab-org/gitlab/-/issues/31519) ）. 不建議直接編輯`KUBE_NAMESPACE` . **注意：**如果您在群集上[安裝應用程序](#installing-applications) ，即使您選擇管理自己的群集，GitLab 也會創建運行它們所需的資源. ### Clearing the cluster cache[](#clearing-the-cluster-cache "Permalink") 在 GitLab 12.6 中[引入](https://gitlab.com/gitlab-org/gitlab/-/issues/31759) . 如果您選擇允許 GitLab 為您管理集群，則 GitLab 將存儲它為項目創建的名稱空間和服務帳戶的緩存版本. 如果在群集中手動修改這些資源，則此緩存可能與群集不同步，這可能導致部署作業失敗. 清除緩存： 1. 導航到您小組的 **Kubernetes**頁面，然后選擇您的集群. 2. 展開**高級設置**部分. 3. Click **清除集群緩存**. ## Base domain[](#base-domain "Permalink") 在 GitLab 11.8 中[引入](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/24580) . 集群級別的域允許每個[多個 Kubernetes 集群](#multiple-kubernetes-clusters)支持多個域.指定域時，這將在[Auto DevOps](../../../topics/autodevops/index.html)階段自動設置為環境變量（ `KUBE_INGRESS_BASE_DOMAIN` ）. 該域應將通配符 DNS 配置為入口 IP 地址. ## Environment scopes[](#environment-scopes-premium "Permalink") 將多個 Kubernetes 集群添加到您的項目時，您需要通過環境范圍來區分它們. 環境范圍將群集與[環境](../../../ci/environments/index.html)相關聯，類似于[特定](../../../ci/variables/README.html#limit-the-environment-scopes-of-environment-variables)于[環境的變量的](../../../ci/variables/README.html#limit-the-environment-scopes-of-environment-variables)工作方式. 在評估哪個環境與群集的環境范圍匹配時， [群集優先級](#cluster-precedence)將生效. 項目級別的集群優先，其次是最接近的祖先組，然后是該組的父級，依此類推. 例如，如果您的項目具有以下 Kubernetes 集群： | Cluster | 環境范圍 | Where | | --- | --- | --- | | Project | `*` | Project | | Staging | `staging/*` | Project | | Production | `production/*` | Project | | Test | `test` | Group | | Development | `*` | Group | [`.gitlab-ci.yml`](../../../ci/yaml/README.html)中設置了以下環境： ``` stages: - test - deploy test: stage: test script: sh test deploy to staging: stage: deploy script: make deploy environment: name: staging/$CI_COMMIT_REF_NAME url: https://staging.example.com/ deploy to production: stage: deploy script: make deploy environment: name: production/$CI_COMMIT_REF_NAME url: https://example.com/ ``` 結果是： * 項目集群用于`test`作業. * 分段群集用于`deploy to staging`作業. * 生產集群用于`deploy to production`作業. ## Cluster environments[](#cluster-environments-premium "Permalink") 有關將哪種 CI [環境](../../../ci/environments/index.html)部署到 Kubernetes 集群的統一視圖，請參閱[集群環境](../../clusters/environments.html)文檔. ## Security of Runners[](#security-of-runners "Permalink") 有關安全配置 GitLab Runners 的重要信息，請參閱項目級集群[的 Runners 安全性](../../project/clusters/add_remove_clusters.html#security-of-gitlab-runners)文檔. ## More information[](#more-information "Permalink") For information on integrating GitLab and Kubernetes, see [Kubernetes clusters](../../project/clusters/index.html).