Kweaver-dip k8s-network

Kubernetes 模块化网络 - Agent 使用指南

install

source · Clone the upstream repo

git clone https://github.com/kweaver-ai/kweaver-dip

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/kweaver-ai/kweaver-dip "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/create-bkn/references/examples/k8s-network" ~/.claude/skills/kweaver-ai-kweaver-dip-k8s-network && rm -rf "$T"

manifest: skills/create-bkn/references/examples/k8s-network/SKILL.md

source content

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	隔离节点，禁止调度

拓扑结构

┌─────────────┐     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
```

按功能索引

资源管理: Pod, Node, Service
网络路由: service_routes_pod
调度归属: pod_belongs_node
运维操作: restart_pod, cordon_node

注意事项

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