关于 k8s-manifest-generator
为开发者提供 Kubernetes 清单编写指导，涵盖常见资源类型及安全、健康检查和资源设置等生产实践。
主要功能
- 01Deployment、Service 和存储清单
- 02ConfigMap 与 Secret 配置
- 03资源限制与健康检查
- 04安全上下文与命名规范
- 05多环境部署指导
适用场景
- 01创建 Deployment 和 Service
- 02配置应用设置与机密
- 03为有状态工作负载准备清单
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/k8s-manifest-generator确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
assets/configmap-template.yamldeployment-template.yamlservice-template.yamlreferences/deployment-spec.mddetails.mdservice-spec.md详细介绍
Kubernetes 清单生成器
为创建生产级 Kubernetes 清单提供分步指导，包括 Deployment、Service、ConfigMap、Secret 和 PersistentVolumeClaim。
用途
本技能为生成结构良好、安全且符合生产要求的 Kubernetes 清单提供全面指导，遵循云原生最佳实践和 Kubernetes 约定。
何时使用本技能
当你需要完成以下任务时，可使用本技能：
- 创建新的 Kubernetes Deployment 清单
- 定义用于网络连接的 Service 资源
- 生成用于配置管理的 ConfigMap 和 Secret 资源
- 为有状态工作负载创建 PersistentVolumeClaim 清单
- 遵循 Kubernetes 最佳实践和命名约定
- 实现资源限制、健康检查和安全上下文
- 为多环境部署设计清单
详细模式与完整示例
详细的模式文档位于 references/details.md。当上方的导航层级不够用时，请阅读该文件。
最佳实践摘要
- 始终设置资源请求和限制 - 防止资源耗尽
- 实现健康检查 - 确保 Kubernetes 能够管理你的应用
- 使用具体镜像标签 - 避免不可预测的部署
- 应用安全上下文 - 以非 root 用户运行，移除能力
- 使用 ConfigMap 和 Secret - 将配置与代码分离
- 为所有内容添加标签 - 支持筛选和组织
- 遵循命名约定 - 使用标准 Kubernetes 标签
- 应用前进行验证 - 使用 dry-run 和验证工具
- 对清单进行版本管理 - 保存在 Git 中并使用版本控制
- 使用注解编写文档 - 为其他开发者添加上下文
故障排查
Pod 无法启动：
- 检查镜像拉取错误：
kubectl describe pod <pod-name> - 验证资源可用性：
kubectl get nodes - 检查事件：
kubectl get events --sort-by='.lastTimestamp'
Service 无法访问：
- 验证选择器与 Pod 标签匹配：
kubectl get endpoints <service-name> - 检查 Service 类型和端口配置
- 从集群内部测试：
kubectl run debug --rm -it --image=busybox -- sh
ConfigMap/Secret 未加载：
- 验证 Deployment 中的名称匹配
- 检查命名空间
- 确保资源存在：
kubectl get configmap,secret
后续步骤
创建清单后：
- 存储到 Git 仓库中
- 设置用于部署的 CI/CD 流水线
- 考虑使用 Helm 或 Kustomize 进行模板化
- 使用 ArgoCD 或 Flux 实现 GitOps
- 添加监控和可观测性
相关技能
helm-chart-scaffolding- 用于模板化和打包gitops-workflow- 用于自动化部署k8s-security-policies- 用于高级安全配置
评论
支持 Markdown