tomevault-io Kubernetes 模块化网络 - Agent 使用指南
网络ID: k8s-modular
版本: 1.0.0
标签: Kubernetes, 拓扑架构, 运维
网络概览
本知识网络描述 Kubernetes 集群的核心资源拓扑结构，采用模块化组织方式，每个定义独立成文件。
核心对象
| 对象 | 文件路径 | 说明 |
|---|---|---|
| Pod | object_types/pod.bkn |
最小部署单元，包含容器规格 |
| Node | object_types/node.bkn |
集群工作节点 |
| Service | object_types/service.bkn |
服务暴露与负载均衡 |
核心关系
| 关系 | 文件路径 | 源 → 目标 | 说明 |
|---|---|---|---|
| pod_belongs_node | relation_types/pod_belongs_node.bkn |
Pod → Node | Pod 归属节点关系 |
| service_routes_pod | relation_types/service_routes_pod.bkn |
Service → Pod | 服务路由到 Pod |
可用行动
| 行动 | 文件路径 | 绑定对象 | 说明 |
|---|---|---|---|
| restart_pod | action_types/restart_pod.bkn |
Pod | 重启指定 Pod |
| cordon_node | action_types/cordon_node.bkn |
Node | 隔离节点，禁止调度 |
风险类型
| 风险 | 文件路径 | 说明 |
|---|---|---|
| restart_pod_high_risk | risk_types/restart_pod_high_risk.bkn |
重启 Pod 高风险操作 |
拓扑结构
┌─────────────┐ routes ┌─────────┐
│ Service │ ───────────────→│ Pod │
└─────────────┘ └────┬────┘
│ belongs
↓
┌─────────┐
│ Node │
└─────────┘
使用建议
查询场景
获取所有 Pod 及其所在节点
- 读取
object_types/pod.bkn和object_types/node.bkn - 通过
pod_belongs_node关系关联
- 读取
查找 Service 后端 Pod
- 读取
object_types/service.bkn - 通过
service_routes_pod关系查询目标 Pod
- 读取
运维场景
Pod 故障重启
- 使用
restart_pod行动 - 前置检查：确认 Pod 存在且非关键系统 Pod
- 使用
节点维护
- 使用
cordon_node行动隔离节点 - 驱逐该节点上的 Pod（如有需要）
- 使用
索引表
按类型索引
- 对象定义:
object_types/*.bkn - 关系定义:
relation_types/*.bkn - 行动定义:
action_types/*.bkn - 风险定义:
risk_types/*.bkn
按功能索引
- 资源管理: Pod, Node, Service
- 网络路由: service_routes_pod
- 调度归属: pod_belongs_node
- 运维操作: restart_pod, cordon_node
- 风险管控: restart_pod_high_risk
注意事项
- 所有定义文件采用模块化组织，便于独立维护
- 关系定义中明确指定端点类型和数量约束
- 行动定义包含前置条件检查，确保操作安全
Source: kweaver-ai/kweaver-core — distributed by TomeVault.