Appearance
Everything Claude Code Deployment Patterns Skill 是一套专为现代 Web 应用设计的生产级部署模式工具,涵盖 CI/CD 流水线、Docker 容器化、多种部署策略(滚动、蓝绿、金丝雀)、健康检查、回滚机制与生产就绪清单。通过标准化和自动化部署流程,大幅降低发布风险、提升可维护性,让 Claude Code 等 AI 编程助手在生产环境下实现高效、安全、可回滚的持续交付。
Everything Claude Code Deployment Patterns Skill:CI/CD Pipeline、Docker 部署、健康检查与回滚策略
在 AI 辅助编程和自动化工程实践中,部署环节常常是最容易出错、影响业务连续性的部分。Everything Claude Code Deployment Patterns Skill(以下简称 deployment-patterns Skill)正是为了解决这一痛点而设计:它将业界最佳的 CI/CD 流程、Docker 构建、健康检查、回滚与生产就绪标准封装为可复用的 Skill,帮助开发者和 AI Agent 快速搭建、审查和优化生产级部署体系。
1. deployment-patterns Skill 能解决什么问题?
传统做法的痛点:
- 部署流程不规范,容易遗漏关键步骤(如健康检查、回滚方案、环境配置校验)。
- Docker 镜像体积大、依赖混乱,存在安全隐患。
- CI/CD 流水线缺乏分阶段验证,回滚操作不一致或无法追溯。
- 缺少自动化的生产就绪检查,导致上线后频繁“救火”。
有了 deployment-patterns Skill 后:
- 一键生成或审查标准化的 CI/CD pipeline(如 GitHub Actions),分阶段自动化测试、构建、部署。
- 提供 Node.js、Go、Python/Django 等主流技术栈的多阶段 Dockerfile 模板,自动集成 HEALTHCHECK、非 root 用户、依赖缓存等最佳实践。
- 内置多种部署策略(滚动、蓝绿、金丝雀),结合流量切换、监控与回滚建议,适配不同业务场景。
- 自动生成健康检查端点代码、Kubernetes probe 配置与环境变量校验逻辑。
- 输出详细的生产就绪清单,确保上线前所有环节可追溯、可验证、可回滚。
2. 适用场景与触发条件
建议在以下场景激活 deployment-patterns Skill:
- 新建/重构项目时,需要设计或审查生产部署流程
- 引入 CI/CD、自动化测试与容器化部署
- 需要支持蓝绿、金丝雀、滚动等高级部署模式
- 准备大版本发布、环境切换或多环境配置
- 生产事故后,需完善回滚与健康自检机制
可通过 Claude Code 的 Skill 配置界面,或在 Everything Claude Code 快速上手指南 中的 MCP/Agent 工作流中自动触发。
3. 实际项目中如何用好 deployment-patterns Skill?
Step 1:选择部署策略,生成或审查部署流程
部署前,先根据业务特性选择合适的策略:
- 滚动部署(Rolling):适合大多数兼容性好的后端服务,零停机、平滑升级。
- 蓝绿部署(Blue-Green):适用于核心业务、需一键回滚场景,需双倍资源。
- 金丝雀部署(Canary):适合高流量或风险变更,先小流量验证。
Skill 会自动输出对应的流程图与流量切换建议,例如:
v1: 95% 流量
v2: 5% 流量(canary)
→ 监控通过后逐步扩大 v2 流量Step 2:生成多阶段 Dockerfile,规范容器构建
Skill 根据项目类型生成最优 Dockerfile。例如 Node.js 服务:
dockerfile
FROM node:22-alpine AS deps
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm ci --production=false
FROM node:22-alpine AS builder
WORKDIR /app
COPY --from=deps /app/node_modules ./node_modules
COPY . .
RUN npm run build
RUN npm prune --production
FROM node:22-alpine AS runner
WORKDIR /app
RUN addgroup -g 1001 -S appgroup && adduser -S appuser -u 1001
USER appuser
COPY --from=builder --chown=appuser:appgroup /app/node_modules ./node_modules
COPY --from=builder --chown=appuser:appgroup /app/dist ./dist
COPY --from=builder --chown=appuser:appgroup /app/package.json ./
ENV NODE_ENV=production
EXPOSE 3000
HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
CMD wget --no-verbose --tries=1 --spider http://localhost:3000/health || exit 1
CMD ["node", "dist/server.js"]关键点:
- 多阶段构建,极致瘦身
- 非 root 用户运行
- HEALTHCHECK 自动集成
- 依赖缓存与 .dockerignore 优化
Skill 也支持 Go、Python/Django 等主流栈,详见 Docker Patterns Skill。
Step 3:自动化 CI/CD 流水线集成
Skill 会生成标准的 GitHub Actions 配置,分为 test、build、deploy 三阶段:
yaml
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 22
- run: npm ci
- run: npm run lint
- run: npm run typecheck
- run: npm test -- --coverage
build:
needs: test
runs-on: ubuntu-latest
steps:
- uses: docker/build-push-action@v5
with:
push: true
tags: ghcr.io/${{ github.repository }}:${{ github.sha }}
deploy:
needs: build
runs-on: ubuntu-latest
steps:
- name: Deploy to production
run: |
kubectl set image deployment/app app=ghcr.io/${{ github.repository }}:${{ github.sha }}Skill 会根据部署平台(如 K8s、Vercel、Railway)自动调整 deploy 步骤。
Step 4:健康检查与生产就绪校验
Skill 自动输出健康检查端点代码(Node/Express、Django 等):
typescript
app.get("/health", (req, res) => {
res.status(200).json({ status: "ok" });
});并生成 Kubernetes liveness/readiness/startup probe 配置,确保服务自愈与自动下线:
yaml
livenessProbe:
httpGet:
path: /health
port: 3000
initialDelaySeconds: 10Skill 还会输出环境变量校验代码(如 zod 校验),并生成生产就绪清单(见下文)。
Step 5:回滚策略与应急演练
Skill 提供标准回滚命令与 checklist,例如:
bash
kubectl rollout undo deployment/app
vercel rollback
railway up --commit <previous-sha>并提醒数据库迁移、feature flag、监控告警等回滚相关注意事项。
Step 6:生产就绪清单输出
上线前,Skill 自动输出一份覆盖应用、基础设施、监控、安全、运维的 checklist,确保每个环节可追溯:
- 所有测试(单元、集成、E2E)通过
- 镜像可复现、环境变量校验、资源限额配置
- 日志结构化、监控告警、健康检查端点可用
- 依赖安全扫描、CORS/限流/认证/安全头配置
- 回滚方案、数据库演练、故障 runbook 完备
4. 输出示例
Skill 典型输出包括:
- 针对项目类型的多阶段 Dockerfile
- 标准化 GitHub Actions CI/CD 配置
- 健康检查端点代码与 K8s probe 配置
- 回滚命令与 checklist
- 生产就绪 checklist(可直接用于上线前自查)
5. 常见配套 Agent 与协作关系
- Code Reviewer Agent:结合 deployment-patterns Skill 自动审查 Dockerfile、CI/CD pipeline、健康检查等配置,发现安全与可维护性问题。详细介绍
- Build Error Resolver Agent:当 CI/CD 流水线构建失败时,自动定位并修复构建、依赖、部署相关错误。详细介绍
- Performance Optimizer Agent:可在部署前后分析资源利用与性能瓶颈,辅助调整部署参数。
- Verification Loop Skill:结合端到端验证循环,确保每次部署都经过完整的健康检查与回归测试。详细介绍
6. 与其他 Skill 的协作
- 可与 Docker Patterns Skill 联动,自动生成多语言 Dockerfile 并集成最佳实践。
- 搭配 AI Regression Testing Skill,实现部署前后的自动化回归测试与健康监控。
- 与 Rules 体系 配合,约束部署流程、环境变量和安全策略。
FAQ
Q: deployment-patterns Skill 适合哪些项目? A: 适用于 Node.js、Go、Python/Django 等主流 Web 应用,支持 K8s、Vercel、Railway 等多种部署平台。
Q: 如何确保回滚安全? A: Skill 自动输出回滚命令和 checklist,要求镜像/工件可追溯、数据库迁移可逆、feature flag 可控,并建议在 staging 环境演练。
Q: Skill 会自动生成所有配置吗? A: Skill 会根据项目类型和目标平台智能生成模板与校验代码,开发者可按需调整、补充特定业务逻辑。