用途:为自动化构建生成完整、可复制粘贴的 CI/CD 流水线配置,安装 Newman 并运行 Postman 集合,实现 API 测试自动化。
主要能力:生成 GitHub Actions、GitLab CI、Jenkins(声明式流水线)、Azure DevOps、CircleCI 等平台的配置模板;支持本地集合文件或 Postman API URL;支持本地环境文件或 CI 密钥注入的环境变量;可输出 JUnit XML(用于 CI 测试结果面板)、HTML 报告或两者;默认 Node.js 18;可配置触发条件(push、pull request、定时或部署后);可设置测试失败时使构建失败。
使用方式:生成前需确认 CI 平台、集合来源、环境来源、所需报告器、Node.js 版本、触发条件以及是否在测试失败时使构建失败。配置中通过 npm install -g newman 与 npm install -g newman-reporter-htmlextra 安装工具,使用 newman run 命令运行集合,并通过 --reporter-junit-export 与 --reporter-htmlextra-export 导出报告。敏感值应通过 CI 环境变量或密钥注入,使用 --env-var "KEY=$SECRET_NAME" 引用,切勿硬编码凭据。建议将集合与环境文件存放在仓库中,并将 results/ 加入 .gitignore。发布测试结果步骤应使用 if: always() 或 when: always,确保 Newman 失败时仍能发布产物。Newman 在测试失败时退出码为 1,会自动使流水线步骤失败;可使用 --bail 在首次失败时停止。
适用场景:需要在 CI/CD 中自动执行 Postman 集合 API 测试的团队。
限制:资料未提供各平台之外的更多细节;生成配置后,技能会询问是否生成 Postman 测试用例,若 postman-testcase-generator 技能未安装则无法继续。