k8s-network git:20260708.acb43caC

Immutable. This exact content is served forever at /api/v1/blob/51f2b936e2aa99ae.

# 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. 行动定义包含前置条件检查，确保操作安全