$npx -y skills add kweaver-ai/kweaver-dip --skill k8s-network> 网络ID: k8s-modular > 版本: 1.0.0 > 标签: Kubernetes, 拓扑架构, 运维
| 1 | # Kubernetes 模块化网络 - Agent 使用指南 |
| 2 | |
| 3 | > **网络ID**: k8s-modular |
| 4 | > **版本**: 1.0.0 |
| 5 | > **标签**: Kubernetes, 拓扑架构, 运维 |
| 6 | |
| 7 | ## 网络概览 |
| 8 | |
| 9 | 本知识网络描述 Kubernetes 集群的核心资源拓扑结构,采用模块化组织方式,每个定义独立成文件。 |
| 10 | |
| 11 | ### 核心对象 |
| 12 | |
| 13 | | 对象 | 文件路径 | 说明 | |
| 14 | |------|----------|------| |
| 15 | | Pod | `object_types/pod.bkn` | 最小部署单元,包含容器规格 | |
| 16 | | Node | `object_types/node.bkn` | 集群工作节点 | |
| 17 | | Service | `object_types/service.bkn` | 服务暴露与负载均衡 | |
| 18 | |
| 19 | ### 核心关系 |
| 20 | |
| 21 | | 关系 | 文件路径 | 源 → 目标 | 说明 | |
| 22 | |------|----------|-----------|------| |
| 23 | | pod_belongs_node | `relation_types/pod_belongs_node.bkn` | Pod → Node | Pod 归属节点关系 | |
| 24 | | service_routes_pod | `relation_types/service_routes_pod.bkn` | Service → Pod | 服务路由到 Pod | |
| 25 | |
| 26 | ### 可用行动 |
| 27 | |
| 28 | | 行动 | 文件路径 | 绑定对象 | 说明 | |
| 29 | |------|----------|----------|------| |
| 30 | | restart_pod | `action_types/restart_pod.bkn` | Pod | 重启指定 Pod | |
| 31 | | cordon_node | `action_types/cordon_node.bkn` | Node | 隔离节点,禁止调度 | |
| 32 | |
| 33 | ## 拓扑结构 |
| 34 | |
| 35 | ``` |
| 36 | ┌─────────────┐ routes ┌─────────┐ |
| 37 | │ Service │ ───────────────→│ Pod │ |
| 38 | └─────────────┘ └────┬────┘ |
| 39 | │ belongs |
| 40 | ↓ |
| 41 | ┌─────────┐ |
| 42 | │ Node │ |
| 43 | └─────────┘ |
| 44 | ``` |
| 45 | |
| 46 | ## 使用建议 |
| 47 | |
| 48 | ### 查询场景 |
| 49 | |
| 50 | 1. **获取所有 Pod 及其所在节点** |
| 51 | - 读取 `object_types/pod.bkn` 和 `object_types/node.bkn` |
| 52 | - 通过 `pod_belongs_node` 关系关联 |
| 53 | |
| 54 | 2. **查找 Service 后端 Pod** |
| 55 | - 读取 `object_types/service.bkn` |
| 56 | - 通过 `service_routes_pod` 关系查询目标 Pod |
| 57 | |
| 58 | ### 运维场景 |
| 59 | |
| 60 | 1. **Pod 故障重启** |
| 61 | - 使用 `restart_pod` 行动 |
| 62 | - 前置检查:确认 Pod 存在且非关键系统 Pod |
| 63 | |
| 64 | 2. **节点维护** |
| 65 | - 使用 `cordon_node` 行动隔离节点 |
| 66 | - 驱逐该节点上的 Pod(如有需要) |
| 67 | |
| 68 | ## 索引表 |
| 69 | |
| 70 | ### 按类型索引 |
| 71 | |
| 72 | - **对象定义**: `object_types/*.bkn` |
| 73 | - **关系定义**: `relation_types/*.bkn` |
| 74 | - **行动定义**: `action_types/*.bkn` |
| 75 | |
| 76 | ### 按功能索引 |
| 77 | |
| 78 | - **资源管理**: Pod, Node, Service |
| 79 | - **网络路由**: service_routes_pod |
| 80 | - **调度归属**: pod_belongs_node |
| 81 | - **运维操作**: restart_pod, cordon_node |
| 82 | |
| 83 | ## 注意事项 |
| 84 | |
| 85 | 1. 所有定义文件采用模块化组织,便于独立维护 |
| 86 | 2. 关系定义中明确指定端点类型和数量约束 |
| 87 | 3. 行动定义包含前置条件检查,确保操作安全 |