Help us learn about your current experience with the documentation. Take the survey.

集群管理项目(已弃用)

  • Tier: Free, Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

集群管理项目在 GitLab 14.5 中已被弃用。 要管理集群应用,请使用 GitLab agent for KubernetesCluster Management Project Template

在 GitLab 自托管版中,默认情况下此功能不可用。要启用此功能,管理员可以启用名为 certificate_based_clusters 的功能标志

项目可以被指定为集群的管理项目。 管理项目可用于运行具有 Kubernetes cluster-admin 权限的部署作业。

这可以用于:

  • 创建管道来安装集群范围内的应用程序到您的集群,详细信息请参见管理项目模板
  • 任何需要 cluster-admin 权限的作业。

权限

只有管理项目获得 cluster-admin 权限。所有 其他项目继续获得命名空间范围的 edit 级别权限

管理项目限制在以下情况:

  • 对于项目级集群,管理项目必须与集群项目在同一个 命名空间(或子命名空间)中。
  • 对于组级集群,管理项目必须与集群组在同一个 组(或子组)中。
  • 对于实例级集群,没有此类限制。

如何创建和配置集群管理项目

要使用集群管理项目来管理您的集群:

  1. 创建一个新项目作为您的集群的管理项目。
  2. 将集群与管理项目关联
  3. 配置您的集群管道
  4. 设置环境范围

将集群管理项目与集群关联

要将集群管理项目与您的集群关联:

  1. 转到相应的配置页面。对于:
    • 项目级集群,转到您的项目 Operate > Kubernetes clusters 页面。
    • 组级集群,转到您的组的 Kubernetes 页面。
    • 实例级集群
      1. 在左侧边栏底部,选择 Admin
      2. 选择 Kubernetes
  2. 展开 Advanced settings
  3. Cluster management project 下拉列表中,选择您在上一步中创建的集群管理项目。

配置您的管道

在将项目指定为集群的管理项目后, 在该项目中添加一个 .gitlab-ci.yml 文件。例如:

configure cluster:
  stage: deploy
  script: kubectl get namespaces
  environment:
    name: production

设置环境范围

当将多个集群关联到同一个管理项目时, 可以使用环境范围

每个范围只能由单个集群用于管理项目。

例如,以下 Kubernetes 集群已关联 到管理项目:

Cluster Environment scope
Development *
Staging staging
Production production

.gitlab-ci.yml 文件中设置的环境将部署到 开发、预生产和生产集群。

stages:
  - deploy

configure development cluster:
  stage: deploy
  script: kubectl get namespaces
  environment:
    name: development

configure staging cluster:
  stage: deploy
  script: kubectl get namespaces
  environment:
    name: staging

configure production cluster:
  stage: deploy
  script: kubectl get namespaces
  environment:
    name: production