K8s集群管理入门（免费版）

概述

本工具为个人开发者和小团队提供K8s集群管理能力。采用多Agent协作模式，支持常用K8s资源的创建、查询与管理。适合个人开发环境与小规模集群的日常运维。

核心能力

管理功能

输入: 用户提供管理功能所需的指令和必要参数。 处理: 解析管理功能的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回管理功能的响应数据,包含状态码、结果和日志。

支持的资源类型

输入: 用户提供支持的资源类型所需的指令和必要参数。 处理: 解析支持的资源类型的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回支持的资源类型的响应数据,包含状态码、结果和日志。

核心功能执行

用input_params参数进行配置。

输入: 用户提供核心功能执行所需的指令和必要参数。 处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回核心功能执行的响应数据,包含状态码、结果和日志。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：Kubernetes、集群基础管理工具、支持多、协作与常用资源操、面向个人开发者与、小团队的、集群管理工具、协作模式、等常用资源的创建、Use、when、需要代码生成、编程辅助、调试测试、开发部署时使用、不适用于无明确技、术栈的模糊需求、适用于独立开发者、企业团队和自动化、工作流场景等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一：部署应用

用户输入："帮我部署一个Nginx应用"

输入格式

# 创建Deployment
python3 （请参考skill目录中的脚本文件） deploy \
  --name nginx-app \
  --image nginx:1.25 \
  --replicas 3 \
  --port 80 \
  --namespace default
# ...
# 创建Service
python3 （请参考skill目录中的脚本文件） expose \
  --deployment nginx-app \
  --port 80 \
  --type ClusterIP \
  --name nginx-service

场景二：多Agent协作管理

用户输入："让多个Agent分别管理不同命名空间"

# 配置多Agent
python3 （请参考skill目录中的脚本文件） agents config \
  --agent dev-agent --namespace development \
  --agent staging-agent --namespace staging \
  --agent prod-agent --namespace production
# ...
# 各Agent独立管理各自命名空间
python3 （请参考skill目录中的脚本文件） agents status

场景三：资源查询

用户输入："查看default命名空间的所有资源"

# 查询资源
python3 （请参考skill目录中的脚本文件） list --namespace default --all-resources
# ...
# 输出：
# Deployments: nginx-app (3/3)
# Services: nginx-service (ClusterIP: 10.96.0.10)
# ConfigMaps: nginx-config
# Pods: nginx-app-xxx (running)

快速开始

1. 阅读## 核心能力章节了解skill功能
2. 按## 依赖说明配置环境
3. 执行所需能力对应的命令
4. 参考## 错误处理章节处理异常
5. 查看## FAQ解答常见疑问

环境准备

# 依赖说明
# 安装Python依赖
pip install kubernetes
# ...
# 验证连接
python3 （请参考skill目录中的脚本文件） info

常用命令

# 部署应用
python3 （请参考skill目录中的脚本文件） deploy --name my-app --image my-image:v1 --replicas 3
# ...
# 查询资源
python3 （请参考skill目录中的脚本文件） list --namespace default
python3 （请参考skill目录中的脚本文件） get pod --name my-app-xxx
python3 （请参考skill目录中的脚本文件） logs --name my-app-xxx --tail 100
# ...
# 更新资源
python3 （请参考skill目录中的脚本文件） scale --deployment my-app --replicas 5
python3 （请参考skill目录中的脚本文件） rollout --deployment my-app --status
# ...
# 配置管理
python3 （请参考skill目录中的脚本文件） configmap create --name my-config --from-file ./config.yaml
python3 （请参考skill目录中的脚本文件） secret create --name my-secret --from-literal password=xxx
# ...
# 故障排查
python3 （请参考skill目录中的脚本文件） diagnose --pod my-app-xxx

响应解析: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤。

示例

K8s管理配置

k8s_config:
  kubeconfig: "~/.kube/config"
  context: "default"
  namespace: "default"
# ...
  agents:
    mode: "collaborative"         # collaborative | single
    max_agents: 5
    namespaces:
      - agent: "dev-agent"
        namespace: "development"
      - agent: "prod-agent"
        namespace: "production"
# ...
  defaults:
    replicas: 2
    image_pull_policy: "IfNotPresent"
    restart_policy: "Always"
    service_type: "ClusterIP"
# ...
  resources:
    default_requests:
      cpu: "100m"
      memory: "128Mi"
    default_limits:
      cpu: "500m"
      memory: "512Mi"

最佳实践

1. 命名规范：统一资源命名规范，便于管理
2. 标签管理：使用标签组织资源，便于查询筛选
3. 命名空间隔离：不同环境使用不同命名空间
4. 配置分离：使用ConfigMap/Secret管理配置

常见问题

Q1：多Agent协作如何工作？

多个Agent各自管理指定命名空间的资源，互不干扰。中央协调器负责跨命名空间的协调与冲突检测。适合团队按环境或项目分工。

Q2：免费版支持多少个命名空间？

免费版支持最多5个命名空间的管理。如需管理更多命名空间或大规模集群，建议升级PRO版。

Q3：支持CRD（自定义资源）吗？

免费版支持查询CRD，但创建和管理CRD能力有限。如需完整CRD支持，建议升级PRO版。

Q4：如何接入已有集群？

配置kubeconfig文件指向已有集群的API Server。本工具通过kubernetes-python客户端连接集群，无需在集群内部署。

依赖说明

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux
• Python版本: 3.8+
• kubectl: 已配置集群访问

第三方依赖

API Key 配置

• 通过kubeconfig认证集群
• 无需额外API Key
• kubeconfig文件包含集群访问凭证

可用性分类

• 分类: MD+EXEC（Markdown指令+Python脚本+kubectl执行）
• 说明: 通过kubernetes-python客户端管理K8s集群
• 免费版限制: 基础资源管理、5命名空间、不支持监控与策略治理

已知限制

• 需LLM支持,无LLM环境不可用
• 复杂业务场景建议结合人工经验判断
• 执行效率受模型能力与网络环境影响

错误处理

• 边界输入处理: 空输入返回提示信息, 超长输入自动截断
• 降级策略: 异常时返回默认值, 确保流程不中断 - 处理方式: 按上述步骤操作并确认结果
• 完成ping命令测试网络连通性,检查防火墙和代理设置连接后重新完成命令机制: 失败时自动完成ping命令测试网络连通性,检查防火墙和代理设置连接后重新完成命令, 最多3次 - 解析方式: 按上述步骤任务并确认响应

案例展示

{
  "input": "示例输入",
  "output": "处理结果"
}

输出格式

处理结果以结构化格式返回, 包含状态码、消息和数据字段。