一、持续集成

二、git

1、简介和安装

2、Gitee

2.1 git 和 gitee 管理代码工作原理

2.2 PyCharm 配置 Gitee 插件

3、PyCharm 与 Gitee 相关操作

3.1 将 Gitee的项目 Checkout到 Pycharm中

3.2 推送 PyCharm 新项目到 Gitee远程仓库

3.3 将 Pycharm代码 push到 Gitee远程仓库

3.4 将 Gitee仓库的新代码 pull 到 PyCharm中

3.5 解决冲突

三、Jenkins

1、简介、安装、启动

2、插件安装介绍

3、系统设置

四、持续集成-Postman

1、准备工作

2、使用Jenkins管理-手动构建

3、使用Jenkins管理-自动构建

五、持续集成-代码

1、准备工作

2、使用Jenkins管理-手动构建

3、使用Jenkins管理-自动构建

一、持续集成

概念：

团队成员将自己的工作成果，持续集成到一个公共平台的过程。成员可以每天集成一次，也可以一天集成多次。

相关工具：

本地代码管理：git
远程代码管理：gitee(国内)、github(国外)、gitlib(公司私有服务器)
持续集成：jenkins

二、git

1、简介和安装

安装：
双击 exe文件，一路 next 自动安装，全部默认选项。（不建议修改默认安装目录）
查看：
cmd打开终端，输入 git --version 能看到版本信息，说明安装成功
配置：
安装成功后，打开 cmd 输入命令。这一步必须操作！！！操作后无返回结果！！！
git config --global user.email "你⾃⼰的邮箱名@xxx.com"
git config --global user.name "⽤户名（可任意写,不要⽤中⽂）"
简介：
git 是一款在本地管理代码的工具。自带一个小型仓库，存储本地代码。
官网：Git

GUI Clients：Git - GUI Clients

2、Gitee

官网：Gitee - 基于 Git 的代码托管和研发协作平台

2.1 git 和 gitee 管理代码工作原理

2.2 PyCharm 配置 Gitee 插件

3、PyCharm 与 Gitee 相关操作

3.1 将 Gitee的项目 Checkout到 Pycharm中

使用场景：

第一次加入某个项目，第一次从 gitee 获取代码时。

3.2 推送 PyCharm 新项目到 Gitee远程仓库

应用场景：

本地开发的项目，第一次上传到 gitee 中。

3.3 将 Pycharm代码 push到 Gitee远程仓库

应用场景：

本地和 gitee 有相同的项目。本地代码做了新增。需要将新增的代码，推送gitee上。

3.4 将 Gitee仓库的新代码 pull 到 PyCharm中

应用场景：

本地和 gitee 有相同的项目。 gitee上代码做了新增。需要将新增的代码，拿到本地来。

3.5 解决冲突

应用场景

本地和 gitee 有相同的项目。 gitee上代码做了新增。本地对同一处代码，做了不同的新增

结论：避免少出现冲突：建议，先 pull ，再 push。

三、Jenkins

1、简介、安装、启动

简介：
基于Java开发（必须安装jdk）的一种开源、跨平台的持续集成工具
安装：
操作细节见《Jenkins安装及配置.pdf》中 “安装JDK” 及 “离线安装Jenkins” 小节。
链接：https://pan.baidu.com/s/1Q1At9cdDZgGDgEhtex89Og?pwd=fthq
必须安装 jdk，要配置环境变量。
查验：java -version 能看到 1.8 版 jdk 即可。
启动：
1. 在 jenkins.war 文件所在目录地址栏输入 cmd 打开终端。
2. 输入命令 java -jar jenkins.war 启动服务。
3. 启动成功后，终端窗口不能关闭。最小化。
4. 在浏览器地址栏输入 localhost:8080

2、插件安装介绍

Jenkins左侧菜单栏 —> “Manage Jenkins” —> 选择 “Manage Plugins” —> “可选插件” —> 插件名称，如：“HTML Publisher”

3、系统设置

操作细节见《 Jenkins安装及配置.pdf》中 “配置Jenkins系统邮箱” 小节。
链接：https://pan.baidu.com/s/1Q1At9cdDZgGDgEhtex89Og?pwd=fthq

配置小结：
1. Manage Jenkins —> Configure System
2. Jenkins Location：
        系统管理员邮件地址： —— 自己申请的邮箱。（黄色警告，不理）
3. Extended E-mail Notification:（第一个“高级”）

        SMTP Password：POP3/SMTP 服务授权码
        SMTP Username：自己申请的邮箱
4. 邮件通知：（勾选“使用SMTP认证”）
        用户名：—— 自己申请的邮箱
        密码： —— POP3/SMTP 服务授权码。
5. 点击 “应用” —> “保存”

四、持续集成-Postman

1、准备工作

1. 打开已完成并测试无误的 postman 项目脚本。再次执行测试。
2. 导出（测试用例集、环境变量两个文件）“不支持中文” —— 全部改成英文！
3. 文件所在目录地址栏输入 cmd 打开终端。注意：用 “绝对路径” 测试。方便使用Jenkins。
4. 执行无误，查看生成的测试报告文件
# extra版报告
newman run 测试用例集名.json -e 环境变量文件.json -d 数据文件.json -r htmlextra --reporterhtmlextra-export 报告名称.html

# 示例：
newman run "C:\Users\xwp\Desktop\postman_jenkins\iHRM.postman_collection.json" -e
"C:\Users\xwp\Desktop\postman_jenkins\iHRM_env.postman_environment.json" -r htmlextra --
reporter-htmlextra-export report.html

# 示例：
newman run "C:\Users\xwp\Desktop\ihrm\ihrm.postman_collection.json" -e
"C:\Users\xwp\Desktop\ihrm\postman_environment.json" -r htmlextra --reporter-htmlextra-export report.html

2、使用Jenkins管理-手动构建

操作步骤：
1. 打开 Jenkins 首页，点击 “新建Item” 创建一个新任务
2. 输入任务名，如：bjtestAPITestIHRMPostman。选择 “Freestyle project”，点 “确定” 。跳至 “配置”页面。
3. 回主页，可看到，多出任务 bjtestAPITestIHRMPostman。点任务名称，“配置” 可以继续刚才的配置。
4. 跳至 “构建” 标签。（General 、源码管理、构建触发器、构建环境四个标签先跳过）
        1. 点击 “增加构建步骤”，选择 “Execute Windows batch command” 选项（macOS选择 “Execute shell”）
        2. 将 cmd 终端测试无误的命令，粘入“命令” 编辑框中（如有红色浪线警告，忽略）。
5. “构建后操作” 标签。
        1. 点击 “增加构建后操作步骤”，选择 “Pulish HTML reports”，点击 “新增” 按钮。
        2. 将 Index page[s] 后的值改为：“report.html” 。名称应与上面命令中生成的测试报告名称一致。
        说明：
        因为生成报告时，没有指定目录。所以：上面 “HTML directory to archive” 是空的。
        如果，指定报告生成到其他位置。要配置 “HTML directory to archive”的值。
        3. Report title 是生成的报告标题，可修改为 “Report666” 试试看。
6. 点击 “应用” --> “保存”。
7. 在自动跳至页面中，点击 “Build Now”，可在下面 Build History（构建历史）中，看到构建正在进行。
        1. 点 #1 后面的名称，点击 “控制台输出” 查看执行的命令。
        2. 再次点 “Build Now”，可以再构建一次 #2。以此类推。
8. 完成后，左侧菜单中多出 “Report666” 菜单栏。点击可查看测试报告。可能会样式错乱。后续解决。
        特别说明：
        如有红色 “失败” 提示，检验是否测试用例断言没有通过！用例断言失败， Jenkins 自动判定为失败！

图片步骤：

3、使用Jenkins管理-自动构建

简单来说：自动构建，就是设置一个定时器，定时时间到， Jenkins 自动执行测试用例。

操作步骤：
1. Jenkins 首页，点击任务名：如： bjtestAPITestIHRMPostman。跳至 “配置” 页面。
2. “构建触发器” 标签。选择 “Build periodically（定期地）”
3. “日程表” 中写入：* * * * *（空格隔分） —> 分别对应 “分时日月年”

修改：10 16 * * * 就是每天的 16 点 10 分执行。

4. 点击 “应用” --> “保存”。等待。。。自动构建 —— 成功！
5. 报告样式错乱原因：

Jenkins为了避免受到恶意攻击，设置了CSP安全策略。只允许加载 Jenkins服务器上托管的 CSS文件和图片文件。
我们的用例、代码都是放在自己的服务器上，被恶意攻击的可能性极低。

6. 解决报告样式错乱：
1. 在启动时，添加参数：
java -Dhudson.model.DirectoryBrowserSupport.CSP= -jar Jenkins.war
2. 如果，已生成的报告，样式依然错乱，重新 “Build Now” 生成新的报告即可。

五、持续集成-代码

1、准备工作

将 运行无误，能生成报告的 iHRM项目代码上传至 Gitee中。

2、使用Jenkins管理-手动构建

1. 打开 Jenkins 首页，点击 “新建Item” 创建一个新任务。
2. 输入任务名，如: bjtestAPITestIHRMCode。选择 “Freestyle project”，点 “确定”，跳至 “配置” 页面。
3. “源码管理” 标签。选择 “Git”。在 Repository URL 后写入项目代码在 Gitee的 URL。
4. “构建” 标签。
        1. 点击 “增加构建步骤”，选择 “Execute Windows batch command” 选项（macOS选择 “Execute shell”）
        2. 输入命令 python run_suite.py ( 与在 pycharm 的 Terminal 中执行，相同含义)
5. “构建后操作” 标签
        1. 点击 “增加构建后操作步骤”，选择 “Pulish HTML reports”，点击 “新增” 按钮。
        2. 在 “HTML directory to archive” 中写入报告生成的位置。如：./report (与项目目录一致)
        3. Index page[s] 后的值，与 run_suite.py 中代码，生成的测试报告名称保持一致。如：ihrm.html。

6. 再次点击 “增加构建后操作步骤”，选择 “Editable Email Notification” 设置邮件发送测试报告。
        1. 在 “Project Recipient List” ，$DEFAULT_RECIPIENTS 后使用英文 “,” 隔分，添加邮箱地址。
        2. 下面 “Content-Type” 的值，选择 HTML（text/html）
        3. 复制讲义中 “邮件测试报告模板” 代码到 “Default Content ” 中
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>${ENV, var="JOB_NAME"}-第${BUILD_NUMBER}次构建日志</title>
</head>
<body leftmargin="8" marginwidth="0" topmargin="8" marginheight="4" offset="0">
<div>
<h2>项目信息</h2>
<ul>
<li>项目名称：${PROJECT_NAME}</li>
<li>详细测试报告：<a
href="${PROJECT_URL}HTML_20Report/">${PROJECT_URL}HTML_20Report/</a></li>
<li>触发原因：${CAUSE}</li>
<li>项目Url：<a href="${PROJECT_URL}">${PROJECT_URL}</a></li>
</ul>
<hr/>
<h2>构建日志</h2>
<div>${JELLY_SCRIPT,template="html"}</div>
<hr/>
</div>
</body>
</html>
7. 点击右下角 “Advanced Settings” 按钮。将 “Trigger” 原有的内容点最外层 “红叉” 删除。
点击 “Add Trigger” 选择 Always 。
8. 点击 “应用” --> “保存”。
9. 点击 “Build Now” 开始手动构建。

图片步骤详情如下：

3、使用Jenkins管理-自动构建

1. 点击 “配置” 查看，在 “构建触发器” 标签。选择 “Build periodically（定期地）” 添加定时构建！
2. “日程表” 中写入：* * * * *（空格隔分） —> 分别对应 “分时日月年”
修改：10 16 * * * 就是每天的 16 点 10 分执行。
3. 也可以在 “构建触发器” 标签中选择 “Poll SCM”。写入：*/1 * * * * （空格隔分）
代表1分钟检查一次 gitee 上的代码，查验是否有更新。
4. PyCharm 修改代码 Commit、Push，或者直接在 Gitee修改，导致 Gitee上的代码有变动。会触发Jenkins会自动构建。