### 使用 Docker 部署包含 Jenkins 和 Postman 的持续集成环境 为了实现基于 Docker 的 Jenkins 和 Postman 持续集成环境，以下是详细的说明和配置方法。 #### 1. 准备工作 确保本地已安装 Docker 并正常运行。可以通过以下命令验证： ```bash docker --version ``` 如果未安装 Docker 或版本过旧，请先完成安装并更新至最新稳定版[^3]。 --- #### 2. 启动 Jenkins 容器 使用官方推荐的 `jenkinsci/blueocean` 镜像启动 Jenkins 容器，并挂载必要的卷以保存数据： ```bash docker run \ -u root \ --rm \ -d \ -p 8081:8080 \ -p 50000:50000 \ -v jenkins-data:/var/jenkins_home \ -v $PWD/allure-results:/allure-results \ -v /var/run/docker.sock:/var/run/docker.sock \ jenkinsci/blueocean ``` 此命令中： - `-p 8081:8080`: 将主机的 8081 端口映射到容器内的 8080 端口。 - `-v jenkins-data:/var/jenkins_home`: 数据持久化存储于 `/var/jenkins_home` 卷中。 - `$PWD/allure-results`: 可选路径用于存储测试报告。 - `/var/run/docker.sock`: 提供对宿主机 Docker Daemon 的访问权限[^1]。 > **注意事项**: 如果默认端口被占用，可调整外部端口号（如改为 9090），但需保持内部端口一致[^3]。 --- #### 3. 安装 Newman 插件 Newman 是 Postman 的 CLI 工具，允许在命令行环境中运行 Postman Collection 测试脚本。将其作为插件引入 Jenkins 中以便自动化执行接口测试。 ##### 步骤一：安装 Node.js 和 npm 进入 Jenkins 主机或容器内，安装 Node.js 和 npm： ```bash apt-get update && apt-get install -y nodejs npm npm install newman -g ``` ##### 步骤二：上传 Postman Collection 文件 将 `.json` 格式的 Postman Collection 文件放置到指定目录（例如 `/var/jenkins_home/collections/`）。可通过 SCP 或其他方式传输文件。 --- #### 4. 创建 Jenkins Pipeline 定义一个简单的 Jenkinsfile 来触发 Newman 测试流程： ```groovy pipeline { agent any stages { stage('Run Newman Tests') { steps { script { echo 'Running Postman collection tests...' sh ''' mkdir -p reports/ newman run collections/my-collection.json \ --environment environments/dev-env.json \ --reporters cli,junit,html \ --reporter-html-export reports/newman-report.html ls -l reports/ ''' } } } stage('Publish Results') { steps { junit 'reports/*.xml' archiveArtifacts artifacts: 'reports/*', fingerprint: true publishHTML(target: [ allowMissing : false, alwaysLinkToLastBuild: false, keepAll : true, reportDir : 'reports', reportFiles : 'newman-report.html', reportName : 'Postman Test Report' ]) } } } } ``` 在此配置中： - `collections/my-collection.json`: 替换为实际的 Postman Collection 文件名。 - `environments/dev-env.json`: 替换为目标环境变量文件名称。 - 报告生成后会自动发布 HTML 页面以及 JUnit XML 结果[^2]。 --- #### 5. 访问 Jenkins Web UI 打开浏览器访问地址 http://<your-host>:8081 ，登录初始管理员密码位于日志输出中的位置（通常为 `/var/jenkins_home/secrets/initialAdminPassword`）[^5]。 完成后即可按照提示完成插件安装及后续设置操作。 --- #### 总结 通过以上步骤实现了完整的 CI/CD 环境搭建过程，其中涵盖了从基础服务部署到高级功能扩展的具体实践方案[^4]。