11.Jenkins 技术

Pupper大约 4 分钟学习笔记软件测试接口测试

1. jenkins 是什么

Jenkins 是一个开源的、提供友好操作界面的持续集成(CI)工具，主要用于持续、自动的构建/测试软件项目、监控外部任务的运行（这个比较抽象，暂且写上，不做解释）。

Jenkins 用 Java 语言编写，可在 Tomcat 等流行的 servlet 容器中运行，也可独立运行。

通常与版本管理工具(SCM)、构建工具结合使用。常用的版本控制工具有 SVN、GIT，构建工具有 Maven、Ant、Gradle。

2. CI --- 持续集成

CI(Continuous integration，中文意思是持续集成)是一种软件开发时间。

持续集成强调开发人员提交了新代码之后，立刻进行构建、（单元）测试。

根据测试结果，我们可以确定新代码和原有代码能否正确地集成在一起。

3. CD --- 持续交付

CD(Continuous Delivery，中文意思持续交付)是在持续集成的基础上，将集成后的代码部署到更贴近真实运行环境(类生产环境)中。

比如，我们完成单元测试后，可以把代码部署到连接数据库的 Staging 环境中更多的测试。

如果代码没有问题，可以继续手动部署到生产环境。

二、 Jenkins 环境搭建

1. 查看本地镜像

docker images

2. 下载镜像

1. 下载官方最新镜像

搜索镜像
```
docker search jenkins
```
下载镜像
```
docker pull jenkins
```

2. 下载指定镜像（阿里云 - 公共仓库）

docker pull registry.cn-hangzhou.aliyuncs.com/sqqdcl/jenkins

查看下载的镜像

docker images

3. 创建容器

1. 创建宿主机挂载目录

mkdir -p /var/jenkins_home

2. 设置挂载目录权限

chmod 777 /var/jenkins_home

3. 创建与启动守护式容器 --- 注意容器中的端口使用 8080

docker run -id --name=sqjenkins -p 8080:8080 -v /var/jenkins_home:/var/jenkins_home registry.cnhangzhou.aliyuncs.com/sqqdcl/jenkins

4. 查看容器

docker ps -a

三、jenkins 设置

1. 访问 jenkins

1. 获取宿主机 IP

ipconfig

2. 访问 jenkins

http://宿主机ip：8080

3. 获取管理员密码

docker logs jenkins

cat /var/jenkins_node/secrets/initialAdminPassword

2. 安装插件

1. 首次进入

选择安装推荐的插件
设置第一个管理员
用户名密码：admin
电子邮件：pupper.cheng@gmail.com

2. 安装插件 --- gitlab，gitlab hook, allure

1. 修改下载源

http://mirror.xmission.com/jenkins/updates/update-center.json

2. 搜索 gitlab ，allure 直接安装

3. 重启 jenkins

docker restart 容器id

3. jenkins 全局设置

1. 设置 JDK

别名：JAVA_HOME

JAVA_HOME：/usr/local/openjdk-8

不要勾选 自动安装

2. git 设置

Name： git

Path to Git executable ： /usr/bin/git

3. allure 设置

别名： allure

安装目录： /opt/allure-2.13.5

4. jenkins 邮件功能设置

1. 发送者邮箱设置

网易邮箱：pupper_cheng@163.com

授权码：DYTDGFPLGXUBYZKA

2. 接受者邮箱设置

四、自动化环境验证

1. python 环境验证

1. 进入容器：

docker exec -it jenkins /bin/bash

2. 验证 python：

python3

3. 验证依赖库

pip3 list

2. pytest 环境验证

1. 以管理员进入容器

docker exec -uroot -it jenkins /bin/bash

2. 加 pytest 软连接

软连接是 linux 中一个常用命令，它的功能是为某一个文件在另外一个位置建立一个同不的链接。

具体用法是：ln -s 源文件目标文件。

ln -s /opt/python3/bin/pytest /usr/bin/pytest

五、 jenkins 实现自动化

1. 将项目文件放到挂载目录

挂载目录为：/var/jenkins_home

2. 创建工程

1. 新建任务

2. 选择自由分格

3. 配置工程

1. 配置构建后发送邮件

<!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">
    <table width="95%" cellpadding="0" cellspacing="0"  style="font-size: 11pt; font-family: Tahoma, Arial, Helvetica, sans-serif">
        <tr>
            本邮件由系统自动发出，无需回复！<br/>
            各位同事，大家好，以下为${PROJECT_NAME }项目构建信息</br>
            <td><font color="#CC0000">构建结果 - ${BUILD_STATUS}</font></td>
        </tr>
        <tr>
            <td><br />
            <b><font color="#0B610B">构建信息</font></b>
            <hr size="2" width="100%" align="center" /></td>
        </tr>
        <tr>
            <td>
                <ul>
                    <li>项目名称 ： ${PROJECT_NAME}</li>
                    <li>构建编号 ： 第${BUILD_NUMBER}次构建</li>
                    <li>触发原因： ${CAUSE}</li>
                    <li>构建状态： ${BUILD_STATUS}</li>
                    <li>构建日志： <a href="${BUILD_URL}console">${BUILD_URL}console</a></li>
                    <li>构建  Url ： <a href="${BUILD_URL}">${BUILD_URL}</a></li>
                    <li>工作目录 ： <a href="${PROJECT_URL}ws">${PROJECT_URL}ws</a></li>
                    <li>项目  Url ： <a href="${PROJECT_URL}">${PROJECT_URL}</a></li>
                     <li>测试报告： <a href="${PROJECT_URL}allure">${PROJECT_URL}allure</a></li>
                </ul>

<h4><font color="#0B610B">失败用例</font></h4>
<hr size="2" width="100%" />
$FAILED_TESTS<br/>

<h4><font color="#0B610B">最近提交(#$SVN_REVISION)</font></h4>
<hr size="2" width="100%" />
<ul>
${CHANGES_SINCE_LAST_SUCCESS, reverse=true, format="%c", changesFormat="<li>%d [%a] %m</li>"}
</ul>
详细提交: <a href="${PROJECT_URL}changes">${PROJECT_URL}changes</a><br/>

            </td>
        </tr>
    </table>
</body>

2. 配置 allure 报告

3. 配置构建命令

#!/bin/bash
rm -rf allure-results
cd /var/jenkins_home/Delivery_System/test_case
pytest -sq --alluredir=${WORKSPACE}/allure-results
exit 0