K8s Network

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 | 服务暴露与负载均衡 |

核心关系

| 关系 | 文件路径 | 源 → 目标 | 说明 | |------|----------|-----------|------| | podbelongsnode | relation_types/pod_belongs_node.bkn | Pod → Node | Pod 归属节点关系 | | serviceroutespod | relation_types/service_routes_pod.bkn | Service → Pod | 服务路由到 Pod |

可用行动

| 行动 | 文件路径 | 绑定对象 | 说明 | |------|----------|----------|------| | restartpod | action_types/restart_pod.bkn | Pod | 重启指定 Pod | | cordonnode | action_types/cordon_node.bkn | Node | 隔离节点，禁止调度 |

拓扑结构

┌─────────────┐     routes      ┌─────────┐
│  Service    │ ───────────────→│   Pod   │
└─────────────┘                 └────┬────┘
                                     │ belongs
                                     ↓
                                ┌─────────┐
                                │  Node   │
                                └─────────┘

使用建议

查询场景

1. 获取所有 Pod 及其所在节点

• 读取 object_types/pod.bkn 和 object_types/node.bkn
• 通过 pod_belongs_node 关系关联

1. 查找 Service 后端 Pod

• 读取 object_types/service.bkn
• 通过 service_routes_pod 关系查询目标 Pod

运维场景

1. Pod 故障重启

• 使用 restart_pod 行动
• 前置检查：确认 Pod 存在且非关键系统 Pod

1. 节点维护

• 使用 cordon_node 行动隔离节点
• 驱逐该节点上的 Pod（如有需要）

索引表

按类型索引

• 对象定义: object_types/*.bkn
• 关系定义: relation_types/*.bkn
• 行动定义: action_types/*.bkn

按功能索引

• 资源管理: Pod, Node, Service
• 网络路由: serviceroutespod
• 调度归属: podbelongsnode
• 运维操作: restartpod, cordonnode

注意事项

1. 所有定义文件采用模块化组织，便于独立维护
2. 关系定义中明确指定端点类型和数量约束
3. 行动定义包含前置条件检查，确保操作安全

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: kweaver-ai
• Source: kweaver-ai/kweaver-dip
• License: Apache-2.0
• Homepage: https://kweaver.ai

Install and usage instructions live in the source repository linked above.