SuperAPI AI 工具集

docker-kubernetes

部署与运维

查看项目

更新于 10-26 17:17

技能介绍

该技能提供将应用容器化并在 Kubernetes 中可靠运行的实用指南,覆盖从编写生产级 Dockerfile 到使用 Helm 部署、通过 Ingress 配置流量以及调试集群问题的完整生命周期。其重点在于正确性和可运维性:容器小而安全、可观测;Kubernetes 工作负载具备自愈、扩缩容和优雅失败能力。面向了解基础知识、需要生产模式明确建议的工程师。

用途与触发场景:编写或审查 Dockerfile(任意语言或运行时);部署或配置 Kubernetes 工作负载(Deployment、StatefulSet、DaemonSet);设置 Kubernetes 网络(Service、Ingress、NetworkPolicy);创建或维护 Helm chart 或 values 文件;配置健康探针、资源限制或自动扩缩容(HPA/VPA);调试故障 Pod(CrashLoopBackOff、OOMKilled、ImagePullBackOff);配置服务网格(Istio、Linkerd)或需要服务间 mTLS。不适用于云厂商基础设施预配(应使用 Terraform/IaC 技能)和 CI/CD 流水线编写(应使用 CI/CD 技能)。

核心原则:每个容器只运行一个进程,保持独立重启能力和清晰的信号处理;不可变基础设施,不修补运行中的容器,而是更新镜像标签后重新部署,生产环境固定镜像标签,绝不使用 latest;声明式配置,所有集群状态存放在纳入 git 的 YAML 中,kubectl apply 是唯一允许的变更路径,kubectl edit 仅作为调试工具;使用最小基础镜像(alpine、distroless 或语言特定的 slim 镜像),多阶段构建消除最终镜像中的构建工具;每个 Deployment 必须定义 liveness 和 readiness 探针。

主要能力与内容:解释 Docker 层与缓存机制;说明 Kubernetes 对象模型(Pod、Deployment、Service、Ingress、Namespace、ConfigMap、Secret);提供生产级多阶段 Node.js Dockerfile 示例,包含非 root 用户、npm ci、exec 形式 CMD 等关键决策;提供 Kubernetes Deployment + Service YAML 示例,包含固定镜像标签、envFrom、资源请求与限制、readiness/liveness 探针、topologySpreadConstraints;提供带 TLS 的 Ingress 配置示例,包含 cert-manager 注解;提供 Helm chart 结构及 Chart.yaml、values.yaml、templates/deployment.yaml 片段,部署命令为 helm upgrade --install api-server ./api-server -f values.prod.yaml -n production;说明 startup、readiness、liveness 探针的规则;提供资源限制与 HPA 配置示例及 requests/limits 设置经验;给出 CrashLoopBackOff Pod 的排查步骤(get/describe/logs/--previous/top/debug)和常见原因;列出错误处理表(CrashLoopBackOff、ImagePullBackOff、OOMKilled、Pending、0/N nodes available、CreateContainerConfigError 的原因与修复);列出常见陷阱(shell 形式 CMD 信号问题、liveness 探针依赖下游导致级联重启、latest 标签不触发滚动更新、ConfigMap/Secret 更新不自动重载、仅设 limits 不设 requests 导致调度失败)。

使用方式:该技能在对话中激活后,首次响应以 🧢 emoji 开头。首次激活时会检查已安装的配套技能(通过 ls 查看 ~/.claude/skills/ 等目录),与 frontmatter 中 recommended_skills 对比,对缺失项提示一次并提供安装命令:npx skills add AbsolutelySkilled/AbsolutelySkilled --skill <name>;若 recommended_skills 为空或全部已安装则跳过。实时调试时可加载 references/kubectl-cheatsheet.md 作为快速参考。

适用场景与限制:适合需要生产级容器与 Kubernetes 模式的工程师,用于编写 Dockerfile、部署工作负载、配置网络与 Helm、设置探针与扩缩容、调试 Pod、配置服务网格。不适用于云基础设施预配和 CI/CD 流水线编写。该技能为指南性质,具体平台、收费、效果等信息暂未提供。