# K8S Network

> Kubernetes网络 - Agent 使用指南

- Skill: `openbkn-ai/k8s-network` (Agent Skill, multi-file: 16 files)
- Install (CLI): `npx skillmds@latest add openbkn-ai/k8s-network`
- Raw SKILL.md: https://api.skillmd.com/api/skills/openbkn-ai/k8s-network/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: openbkn-ai (https://skillmd.com/u/openbkn-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/openbkn-ai/k8s-network

---

# Kubernetes网络 - Agent 使用指南

## 网络概览

本知识网络描述 Kubernetes 集群的核心资源拓扑结构，采用模块化组织方式，每个定义独立成文件。

## 拓扑结构

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

## 使用建议

### 典型应用场景

1. **故障根因分析**: 通过拓扑关系追溯故障影响链
2. **自动化运维**: 基于行动定义实现故障自愈
3. **容量规划**: 分析 Node 资源与 Pod 分布

### 查询场景

1. **获取所有 Pod 及其所在节点**
   - 读取 `object_types/pod.bkn` 和 `object_types/node.bkn`
   - 通过 `pod_belongs_node` 关系关联

2. **查找 Service 后端 Pod**
   - 读取 `object_types/service.bkn`
   - 通过 `service_routes_pod` 关系查询目标 Pod

### 运维场景

1. **Pod 故障重启**
   - 使用 `restart_pod` 行动
   - 前置检查：确认 Pod 存在且非关键系统 Pod

2. **节点维护**
   - 使用 `cordon_node` 行动隔离节点
   - 驱逐该节点上的 Pod（如有需要）

## 注意事项

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