SuperAPI AI 工具集

ci-cd-pipelines

部署与运维

查看项目

更新于 10-26 16:19

技能介绍

用途

本技能是一份面向生产系统的持续集成与持续交付实践指南,覆盖流水线设计、GitHub Actions 工作流、部署策略以及保障软件安全快速交付的运维模式。其核心观点是:CI/CD 不是工具配置问题,而是一项软件交付纪律。流水线是产品团队与生产环境之间的契约——每个通过的提交都是候选发布版本,流水线自动执行该契约。

主要能力

技能围绕若干关键原则展开:快速失败(先运行 lint 和类型检查,再运行测试;先单元测试后集成测试);积极缓存(node_modules、Maven .m2、pip wheels、Docker 层缓存,按 lockfile 哈希缓存);保持流水线在 10 分钟以内;主干开发(短生命周期分支频繁合并);不可变产物(一次构建,到处部署,绝不在部署时从源码重建)。

核心概念包括:按顺序执行的流水线阶段(build -> test -> deploy:staging -> approve -> deploy:production);触发器(push、pull_request、schedule、workflow_dispatch);环境(staging、production,各自拥有密钥、保护规则和部署历史);密钥管理(GitHub Secrets 或外部 vault,运行时注入为环境变量,绝不打印到日志,定期轮换);产物存储(GitHub Artifacts 或注册表,镜像以提交 SHA 打标签)。

使用方式

技能提供多种常见任务的实现示例:为 Node.js 设置 GitHub Actions(使用 npm ci、依赖缓存、上传产物);实现 PR 检查(lint、test、typecheck 作业,配合分支保护规则);设置带审批的部署环境(使用 GitHub Environments 门禁生产部署);实现蓝绿部署(在两个相同环境间切换流量,失败时切回);实现带回滚的金丝雀发布(先路由小比例流量,监控错误率,再全量推广);缓存依赖与构建产物(restore-then-save,缓存键从最具体到最不具体);设置矩阵构建(跨多个 Node 版本和操作系统并行测试,使用 fail-fast: false)。

技能还包含错误处理对照表(如 npm ci 锁文件不匹配、缓存未命中、fork PR 中密钥不可用、工作流挂起、部署失败但预发通过、矩阵作业跨操作系统差异)以及注意事项(fork PR 密钥不可用、必需状态检查名称必须完全匹配、restore-keys 缓存污染、不可变产物漂移、矩阵 fail-fast 掩盖失败)。

适用场景

当用户创建或修改 GitHub Actions、GitLab CI 或 Jenkins 流水线;实现 PR 检查、分支保护规则或必需状态检查;设置带晋级门禁的部署环境;实现蓝绿、金丝雀、滚动或重建部署策略;配置依赖或构建产物缓存以加速流水线;设置矩阵构建以跨多个 Node 版本或操作系统测试;自动化密钥注入、环境晋级或回滚流程;诊断缓慢流水线并找出可并行化或缓存的部分时,触发本技能。

限制

不适用于从零搭建基础设施(应使用 Terraform/Kubernetes 技能),也不适用于与流水线结构无关的应用层测试策略。技能激活时首次响应需以 🧢 emoji 开头。详细部署策略参考文件(references/deployment-strategies.md)仅在选择或实现特定部署策略时加载,因其内容详细会消耗上下文。首次激活时会检查已安装的配套技能,缺失时提示安装命令:npx skills add AbsolutelySkilled/AbsolutelySkilled --skill <name>。