openbkn-ai

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

3. 行动定义包含前置条件检查,确保操作安全

openbkn-ai 1,399 139 Updated 7mo ago

Resources

7
GitHub

Install

npx skillscat add openbkn-ai/bkn-foundry/adp-bkn-bkn-backend-tests-integration-tests-bkn-helpers-examples-k8s-network

Install via the SkillsCat registry.

SKILL.md

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

风险类型

风险 文件路径 说明
restart_pod_high_risk risk_types/restart_pod_high_risk.bkn 重启 Pod 高风险操作

拓扑结构

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

使用建议

查询场景

  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(如有需要)

索引表

按类型索引

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

按功能索引

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

注意事项

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

Categories