工程开发
k8s-yaml-generator avatar

k8s-yaml-generator

生成生产就绪的 Kubernetes 清单(包含 Deployment、Service、CRD 等),并内置验证机制。

简介

k8s-yaml-generator 是一款专为 DevOps 工程师和平台运维人员设计的精密工具,旨在无需牺牲稳定性的前提下快速构建基础设施即代码 (IaC) 产物。该技能超越了简单的模板创建,提供了一种确定性的工作流,包括运行前检查、受限的 CRD 查询以及强制性的验证阶段。无论您是要生成带有持久卷声明 (PVC) 的复杂 StatefulSet、配置 Ingress 控制器,还是为如 Argo CD 等 GitOps 工具构建自定义资源定义 (CRD),该代理程序都能确保您的清单符合现代 Kubernetes 的最佳实践。

  • 生成各类资源类型,包括 Deployment、Service、ConfigMap、Ingress、RBAC 以及复杂的 CRD。

  • 采用确定性的执行模型,包含预检、输入捕获、CRD 解析、生成及验证等固定步骤。

  • 严格执行质量标准,如标签一致性 (app.kubernetes.io/*)、资源限制与需求、就绪/存活探针 (probes) 以及 securityContext 安全设置。

  • 提供受限的 CRD 查询工作流,利用特定的工具文档解析功能,避免无限循环并确保准确性。

  • 执行强制性的生成后验证,通过 k8s-yaml-validator、kubeconform 及服务端 Dry-run 检查,在部署前发现语法或 Schema 错误。

  • 提供详细的验证报告,包含语法结果、Schema 合规性以及 Dry-run 状态,以维持基础设施创建流程的可观察性。

  • 用户需提供明确的资源类型意图、Pod 容器镜像及命名空间要求,以便开始生成。

  • 该技能采用安全第一的方法;若工具特定的验证失败,会提供文档记录的备援路径或明确报告阻塞问题。

  • 如有可能,请定义目标 Kubernetes 版本,以确保生成的 YAML 使用当前非弃用的 API 组与版本。

  • 处理 CRD 时,若已知 API 版本与组别,请提供这些信息,或允许代理程序使用其配置的 Context7 工具链进行有限搜索。

  • 此技能严格用于生成与编排;若仅需验证任务,请使用独立的 k8s-yaml-validator 技能,以避免冗余的处理开销。

仓库统计

Star 数
201
Fork 数
24
Open Issue 数
1
主要语言
Python
默认分支
main
同步状态
空闲
最近同步时间
2026年5月3日 16:56
在 GitHub 查看