Kubernetes 仪表盘（Beta）

引入于 16.1 版本，功能标志为 environment_settings_to_graphql、kas_user_access、kas_user_access_project 和 expose_authorized_cluster_agents。此功能处于 Beta 阶段。

使用 Kubernetes 仪表盘通过直观的可视化界面了解集群的状态。 该仪表盘适用于每个连接的 Kubernetes 集群，无论您是使用 CI/CD 还是 GitOps 部署它们。

对于 Flux 用户，给定环境的同步状态不会显示在仪表盘中。

配置仪表盘

配置仪表盘，将其用于特定环境。 您可以为已存在的环境配置仪表盘，也可以在创建环境时添加仪表盘。

先决条件：

  • Kubernetes 代理必须使用 user_access 关键字与环境的项目或其父组共享。

环境已经存在

  1. 在左侧边栏中，选择 搜索或转到 并找到您的项目。
  2. 选择 运维 > 环境。
  3. 选择要关联 Kubernetes 的环境。
  4. 选择 编辑。
  5. 选择适用于 Kubernetes 的极狐GitLab 代理。
  6. 选择 保存。

环境不存在

  1. 在左侧边栏中，选择 搜索或转到 并找到您的项目。
  2. 选择 运维 > 环境。
  3. 选择 新建环境。
  4. 填写 名称 字段。
  5. 选择适用于 Kubernetes 的极狐GitLab 代理。
  6. 选择 保存。

查看仪表盘

要查看配置的仪表盘：

  1. 在左侧边栏中，选择 搜索或转到 并找到您的项目。
  2. 选择 运维 > 环境。
  3. 扩展与适用于 Kubernetes 的极狐GitLab 代理关联的环境。
  4. 展开 Kubernetes 概述。

Flux 同步状态

  • 引入于极狐GitLab 16.3。
  • 自定义 Flux 资源的名称引入于极狐GitLab 16.3，功能标志为 flux_resource_for_environment。
  • 自定义 Flux 资源的名称普遍可用于极狐GitLab 16.4。移除功能标志 flux_resource_for_environment。

仪表盘展示 Flux 部署的同步状态。

状态 描述
已协调 部署成功与其环境相协调
协调中 正在进行协调
停滞 由于存在错误，如果没有人为干预就无法解决，协调会陷入困境
失败 由于出现不可恢复的错误，部署无法协调
未知 无法检索部署的同步状态
不可用 无法检索 Kustomization 或 HelmRelease 资源

部署依赖 Flux Kustomization 和 HelmRelease 资源来收集给定环境的状态，这需要为环境配置命名空间。 默认情况下，极狐GitLab 会在 Kustomization 和 HelmRelease 资源中搜索项目 slug 的名称。 您可以自定义极狐GitLab 在环境设置中查找的名称。

故障排除

使用 Kubernetes 仪表盘时，您可能会遇到以下问题。

用户无法列出 API 组中的资源

您可能会收到一条错误，Error: services is forbidden: User "gitlab:user:<user-name>" cannot list resource "<resource-name>" in API group "" at the cluster scope。

当不允许用户在 Kubernetes RBAC 中执行指定操作时，会发生此错误。

要解决此问题，请检查您的 RBAC 配置。如果 RBAC 配置正确，请联系 Kubernetes 管理员。