K8s清单生成入门

K8s清单生成入门（免费版）

概述

本工具为个人开发者提供K8s YAML清单生成能力。支持常用K8s资源的清单生成、模板化创建和基础校验，帮助开发者快速编写规范的K8s配置文件.

核心能力

清单生成功能

处理: 解析清单生成功能的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回清单生成功能的响应数据,包含状态码、结果和日志.

核心功能执行

用input_params参数进行配置.

处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回核心功能执行的响应数据,包含状态码、结果和日志.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置.

处理: 解析参数配置与调用的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回参数配置与调用的响应数据,包含状态码、结果和日志.

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

使用场景

场景一：生成Deployment清单

用户输入："帮我生成一个Web应用的Deployment清单"

# 生成Deployment清单
python3 （请参考skill目录中的脚本文件） deployment \
  --name web-app \
  --image nginx:1.25 \
  --replicas 3 \
  --port 80 \
  --output deployment.yaml
# ..
# 输出文件内容
cat deployment.yaml

场景二：生成完整应用栈

用户输入："生成Web+数据库的完整K8s清单"

# 生成应用栈
python3 （请参考skill目录中的脚本文件） stack \
  --template "web_db" \
  --app-name my-app \
  --app-image my-app:v1 \
  --db-image postgres:15 \
  --output-dir ./manifests/
# ..
# 输出：
# ./manifests/deployment.yaml
# ./manifests/service.yaml
# ./manifests/configmap.yaml
# ./manifests/secret.yaml
# ./manifests/pvc.yaml

场景三：校验清单

用户输入："检查我的YAML清单有没有问题"

# 校验清单
python3 （请参考skill目录中的脚本文件） validate \
  --file deployment.yaml \
  --dry-run
# ..
# 输出：
# [OK] 语法正确
# [OK] 必填字段完整
# 已知限制
# [建议] 添加livenessProbe

快速开始

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

环境准备

# 依赖说明
pip install pyyaml jsonschema
# ..
# 生成清单
python3 （请参考skill目录中的脚本文件） deployment --name my-app --image nginx:1.25

常用命令

# 生成单个资源
python3 （请参考skill目录中的脚本文件） deployment --name my-app --image my-image:v1 --replicas 3
python3 （请参考skill目录中的脚本文件） service --name my-service --port 80 --type ClusterIP
python3 （请参考skill目录中的脚本文件） configmap --name my-config --from-file ./config.yaml
# ..
# 生成应用栈
python3 （请参考skill目录中的脚本文件） stack --template "web_db" --app-name my-app
# ..
# 校验清单
python3 （请参考skill目录中的脚本文件） validate --file deployment.yaml --dry-run
# ..
# 查看模板列表
python3 （请参考skill目录中的脚本文件） templates list

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

示例

生成模板配置

generate_config:
  defaults:
    api_version: "apps/v1"
    namespace: "default"
    replicas: 2
    image_pull_policy: "IfNotPresent"
# ..
  resources:
    requests:
      cpu: "100m"
      memory: "128Mi"
    limits:
      cpu: "500m"
      memory: "512Mi"
# ..
  templates:
    - name: "web_app"
      resources: ["deployment", "service", "configmap", "ingress"]
    - name: "web_db"
      resources: ["deployment", "service", "configmap", "secret", "pvc"]
    - name: "cron_job"
      resources: ["cronjob", "configmap"]
# ..
  validation:
    schema_check: true
    dry_run: true               # kubectl dry-run验证
    best_practices: true         # 最佳实践检查

最佳实践

1. 模板复用：将常用配置保存为模板，避免重复编写
2. 校验优先：生成后先校验再应用，避免配置错误
3. 版本控制：将清单文件纳入Git管理
4. 标签统一：使用统一的标签规范

已知限制

• 本skill的能力范围受限于核心能力章节中定义的功能,不支持超出范围的操作
• 复杂业务场景建议结合人工经验判断
• 执行效率受模型能力与网络环境影响

常见问题

Q1：免费版支持Helm Chart吗？

免费版不包含Helm Chart生成。如需Helm支持，建议升级PRO版.

Q2：生成的清单可以直接apply吗？

可以。生成后通过 kubectl apply -f 直接应用。建议先用 --dry-run 校验.

Q3：支持Kustomize吗？

免费版不包含Kustomize支持。如需Kustomize覆盖层管理，建议升级PRO版.

Q4：模板可以自定义吗？

免费版提供预置模板，不支持自定义模板。如需自定义模板系统，建议升级PRO版.

依赖说明

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux
• Python版本: 3.8+
• kubectl: 可选（dry-run校验需要）

第三方依赖

API Key 配置

• 免费版无需API Key
• 纯本地生成与校验

可用性分类

• 分类: MD+EXEC（Markdown指令+Python脚本执行）
• 说明: K8s YAML清单生成与校验工具
• 免费版限制: 基础资源生成、不支持Helm/Kustomize与自定义模板

错误处理