集群管理

1. 功能概述

集群管理模块是 MDP 运维平台中对接客户 Kubernetes 集群的控制台，面向日常巡检、应急排查和资源变更三类场景。本模块的目标是让运维值班人员无需频繁切换到原生 kubectl，即可完成常见的排查与运维操作。

主要能力：

集群运行总览：节点健康度、应用运行正常率

工作负载管理：Deployment、StatefulSet、DaemonSet、Pod、Job、CronJob 的查看、重启、修改副本数、修改容器资源、查看 YAML

配置管理：ConfigMap 查看、HorizontalPodAutoscaler (HPA) 查看

网络资源：Service、Ingress 查看

Pod 维度诊断：实时日志、崩溃日志、K8s 事件、Web 终端、YAML 查看

1.1 适用对象

角色	常用操作
运维值班	查看节点与 Pod 异常、查询日志、查看事件
现场支持	查看 Deployment 副本状态、镜像版本、资源 Request/Limit
故障应急	重启 Deployment 或 DaemonSet、调整副本数、调整 CPU/Memory
容量规划	查看 HPA 当前副本数与上下限

1.2 不建议在本模块执行的操作

删除命名空间、强制驱逐 Pod、修改 Secret 或 RBAC 资源等敏感操作不在本模块开放范围内，需要回到原生 kubectl 或相关变更工具执行。跨集群批量操作不可用，每次操作仅作用于当前选择的集群与命名空间。一次性下载大文件日志建议使用 Web 终端而非流式日志弹窗。

2. 入口与导航

左侧菜单：运维管理 → 集群管理。

进入后默认选中左侧菜单的 Deployments，命名空间默认选择当前集群下的第一个, 支持自定义选择集群和命名空间。

3. 工作负载

3.1 Deployments

操作步骤：找到目标 Deployment → 点击右上角笔形图标 → 修改弹窗弹出 → 填入新值 → 确认修改。

弹窗支持修改的字段：

副本数（replicas），最小值 0，必须为整数

每个容器的 CPU Request / Limit，单位为"核"，可填 1 或 1000m

每个容器的 Memory Request / Limit，单位为 Mi，可填 512

提交后触发滚动重建，未列出的字段（镜像、env、探针等）不会被改动。

3.1.1 Deployments重启

作步骤：找到目标 Deployment → 点击右上角环形箭头图标 → 确认弹窗弹出 → 核对集群 / 命名空间 / 负载名 → 确认重启。

确认弹窗明示了"重启将导致 Pod 重建，服务可能会短暂中断"。重启会同时重建所有节点上的 Pod。

3.2 Pods

操作步骤：左侧菜单进入 Pods → 下方列出当前命名空间下所有 Pod ，支持Namespaces , Pod 名称，Pod IP , 节点 IP 检索。

此处yaml仅查看。

3.3 Jobs 与 CronJobs

Jobs

操作步骤：左侧菜单进入 Jobs → 表格列出当前命名空间下所有 Job。

可通过Namespaces 和 Name 进行检索。

CronJobs

操作步骤：左侧菜单进入 CronJobs → 表格列出当前命名空间下所有 CronJob。

可通过Namespaces 和 Name 进行检索。
点击 + 号展开后展示由该 CronJob 触发产生的所有 Job 对应的 Pod 子表。

3.4 DaemonSets

操作步骤：左侧菜单进入 DaemonSets。

可通过Namespaces 和负载名称进行检索。
支持的操作：

修改：可改 CPU / Memory，不可改副本数

重启：同时重建所有节点上的 Pod

YAML：仅查看

3.5 StatefulSets

操作步骤：左侧菜单进入 StatefulSets → 表格视图。

不支持修改 StatefulSets 的副本数、CPU/Memory、重启或 Pod 列表。需要的变更请通过原生 kubectl（详见附录 B）。

4. 配置

4.1 ConfigMaps

操作步骤：左侧菜单进入 ConfigMaps → 表格列出当前命名空间下所有 ConfigMap。
【集群管理】不支持键值编辑。变更请移步-配置中心。

4.2 HPA

操作步骤：左侧菜单进入 HPA → 表格列出当前命名空间下所有 HPA。

仅查看。修改 HPA 上下限请通过原生 kubectl。

5. 网络

5.1 Services

操作步骤：左侧菜单进入 Services → 表格列出当前命名空间下所有 Service。

仅查看，修改请通过 mdp 全局配置当中修改。

5.2 Ingresses

操作步骤：左侧菜单进入 Ingresses → 表格列出当前命名空间下所有 Ingress。

仅查看，修改请通过 mdp 全局配置当中修改。

6. 常见操作

6.1 排查 Pod 异常

顶部下拉切到对应集群与命名空间

左侧菜单进入 Pods

按 Pod 名称或 IP 过滤

关注卡片顶部 Phase 字段，Failed 与 Pending 优先处理

健康指示器灰格对应的 Condition 即为问题点

点击行尾「事件」图标查找根因

「日志」看实时输出 / 「崩溃日志」看上次容器输出

6.2 重启 Deployment

左侧 Deployments

找到目标 Deployment

右上角环形箭头图标

确认弹窗核对集群 / 命名空间 / 负载名 → 确认重启

观察卡片底部 Pod 副本状态进度条判断重建进度

6.3 调小 Deployment 副本做验证

进对应 Deployment

笔形「修改」图标

副本数填入新值（调试可设 0）

CPU / Memory 按需调整（非必填）

确认修改，等待滚动

调小副本数前，建议与 SRE 同事确认目标值是否影响线上流量。

6.4 修改 ConfigMap

平台不支持在集群管理-配置-ConfigMap 编辑 ConfigMap 键值。请移步配置中心。

9. 常见问题

Q1：顶部概览显示应用运行正常率不为 100%。

说明当前命名空间下存在不在 Ready 状态的 Pod（包括 Pending、CrashLoopBackOff、Error 等）。请进入左侧 Pods 菜单，按 Pod 名称或 IP 过滤，查看每个非 Ready Pod 的事件与日志。

Q2：点击"修改 Deployment"后弹窗空白。

常见原因有三种：网络抖动、资源对象的 managedFields 数量过多、服务端 API 异常。请先关闭重试；如仍为空，可联系 SRE 提供 cluster / namespace / 负载名以便排查。

Q3：YAML 弹窗内容很大。

正常现象。K8s 资源对象默认会带较多 metadata 和 conditions，关键内容集中在 spec 区段。

Q4：日志弹窗无输出。

容器可能未向 stdout / stderr 输出日志，请确认应用日志输出策略。如容器已崩溃，应改用「崩溃日志」图标拉取上次实例的输出。

Q5：修改副本数或资源后未生效。

平台下发的是 Strategic Merge Patch，K8s 在几秒内会进入 reconcile 流程。如 30 秒内无变化，请回到原生 kubectl describe deployment 查看事件。

Q6：StatefulSets、ConfigMaps、HPA、Services、Ingresses 改不了。

平台仅对这些资源开放查看。修改请通过 mdp 全局配置当中修改，仅支持Services、Ingresses。

附录 A：本平台用到的关键 kubectl 命令

以下命令用于在主机或运维终端上直接执行，作为本模块功能未覆盖时的替代路径。

kubectl describe deployment <name> -n <ns> 可用于排查平台下发修改后的 reconcile 进度。

注意事项：
应避免 kubectl 操作修改 mdp 纳管的资源，如 deployment、configmap、ingress、sts 等，正确操作应使用mdp 后台配置。

附录 B：术语对照

术语	解释
Cluster	目标 K8s 集群，由 MDP 启动时配置下发
Namespace	K8s 命名空间，用于业务或环境隔离
Workload	工作负载，泛指 Deployment、StatefulSet、DaemonSet、Job、CronJob
Pod	K8s 最小调度单元，承载 1 至 N 个容器
HPA	HorizontalPodAutoscaler，基于指标的水平弹性伸缩
Request / Limit	容器资源预留 / 上限，平台支持修改两者
Patch	局部更新，本平台使用 Strategic Merge Patch
STS	StatefulSet 缩写
DS	DaemonSet 缩写

1. 功能概述#

1.1 适用对象#

1.2 不建议在本模块执行的操作#

2. 入口与导航#

3. 工作负载#

3.1 Deployments#

3.1.1 Deployments重启#

3.2 Pods#

3.3 Jobs 与 CronJobs#

Jobs#

CronJobs#

3.4 DaemonSets#

3.5 StatefulSets#

4. 配置#

4.1 ConfigMaps#

4.2 HPA#

5. 网络#

5.1 Services#

5.2 Ingresses#

6. 常见操作#

6.1 排查 Pod 异常#

6.2 重启 Deployment#

6.3 调小 Deployment 副本做验证#

6.4 修改 ConfigMap#

9. 常见问题#

附录 A：本平台用到的关键 kubectl 命令#

附录 B：术语对照#