基于docker搭建pytest自动化测试环境（docker+pytest+jenkins+allure）

本是古典何须时尚 2024-03-24 18:11 52阅读 0赞

## pytest搭建自动化测试环境（docker+pytest+jenkins+allure） ##

> 这里我以ubuntu18为例
> 
>  *  如果有docker环境，可以直接拉取我打包好的镜像
>  *  `docker pull ziyigun/jenkins:v1.0`

### 1 搭建Docker ###

#### 1.1 安装docker ####

# 配置docker安装环境
    sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common
    # 添加阿里的GPG秘钥
    curl -fsSL http://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo apt-key add -
    
    # 添加阿里镜像源
    sudo add-apt-repository "deb [arch=amd64] http://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable"
    
    # 更新apt
    sudo apt-get update
    
    # 查询docker有哪些版本 第二列是版本号，第三列是存储库的名称。
    apt-cache madison docker-ce
    
    # 安装最新版本
    sudo apt-get install -y docker-ce
     
    #或者安装指定版本(根据操作系统版本来安装对应docker版本)
    # sudo apt-get install -y docker-ce=5:19.03.1~3-0~ubuntu-cosmic
    
    # 查看docker版本
    sudo docker version

#### 1.2 配置镜像加速 ####

sudo vi /etc/docker/daemon.json

# 保存如下内容
    {
        
      "registry-mirrors": [
        "https://ooq07srv.mirror.aliyuncs.com"，
        "https://registry.cn-hangzhou.aliyuncs.com",
        "http://hub-mirror.c.163.com", 
        "https://docker.mirrors.ustc.edu.cn", 
        "https://registry.docker-cn.com" 
      ] 
    }
    
    # 重启docker验证是否成功
    sudo service docker restart
    #或者
    sudo systemctl restart docker

##### bug1:ExecStart=/usr/bin/dockerd -H fd:// #####

>  *  如果发现docker启动或者重启报错：  
>     ExecStart=/usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock (code=exited, status=1/FAILURE)

解决办法：  
方法一：

cp /etc/docker/daemon.json /etc/docker/daemon.conf
    sudo systemctl restart docker

方法二：

sudo edit /usr/lib/systemd/system/docker.service
    # 原来的内容
    ExecStart=/usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock
    # 改为如下的内容
    ExecStart=/usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock --graph /usr/local/docker
    
    # 重启docker
    systemctl daemon-reload
    systemctl restart docker

##### bug2:mediaType in manifest should be … #####

>  *  如果发现报错：  
>     mediaType in manifest should be ‘application/vnd.docker.distribution.manifest.v2+json’ not ‘application/vnd.oci.image.manifest.v1+json’

解决办法：

方法一：

# 升级Docker版本： 您可以尝试升级Docker到支持OCI格式的版本
    sudo apt-get purge docker-ce docker-ce-cli containerd.io
    # 安装最新的docker版本
    sudo apt-get install -y docker-ce

方法二：

# Docker Registry API v2
    docker pull --disable-content-trust jenkins/jenkins

#### 1.3 卸载docker ####

> 如果使用完成之后想要卸载docker

# 卸载docker
    sudo apt-get purge docker-ce docker-ce-cli containerd.io

### 2 搭建Jenkins ###

#### 2.1 拉取并运行Jenkins镜像 ####

# 拉取最新稳定版的jenkins
    docker pull jenkins/jenkins:lts
    
    # 创建目录，挂载jenkins信息
    mkdir -p /var/jenkins_node
    
    # 设置目录权限
    chmod -R 777 /var/jenkins_node
    
    # 创建jenkins容器
    docker run -d -uroot -p 80:8080 --name jenkins -v /var/jenkins_node:/var/jenkins_home jenkins/jenkins:lts
    #说明：-d: 指定容器运行于前台还是后台，默认为false
    #-u: 指定容器的用户-p: 指定容器暴露的端口，主机的80端口映射容器的8080端口
    #--name: 容器名称-v:　给容器挂载存储卷，挂载到容器的某个目录
    
    # 查看容器运行状态
    docker ps | grep jenkins
    
    # 进入jenkins容器内部
    docker exec -it -uroot jenkins bash

#### 2.2 浏览器访问Jenkins并配置 ####

> 在浏览器中输入宿主机ip，即可访问到jenkins页面，如：10.16.53.10

# 查看jenkins默认密码(在容器外部执行命令)
    docker exec jenkins tail /var/jenkins_home/secrets/initialAdminPassword

然后根据自己的需求来选择是否需要安装Jenkins需要的插件（我这里选择接受推荐的插件）：  
![在这里插入图片描述][214d987cf59d4a70aa9dd73969d8e8e9.png]

> 完成之后，创建一个用户,设置用户名密码、邮箱等

*  修改时区  
    ![在这里插入图片描述][ccbcb02ec04b4d588b38e69f4a8fb350.png]

### 3 配置Python ###

> 在jenkins容器中，执行如下命令:

#### 3.1 更新apt软件包 ####

# 获取最新的软件包
    apt-get update
    #升级已安装的软件包
    apt-get upgrade  
    #提前安装，以便接下来的配置操作
    apt-get -y install gcc automake autoconf libtool make
    apt-get -y install make* 
    apt-get -y install zlib*
    apt-get -y install openssl libssl-dev
    apt-get install sudo

#### 3.2 下载python3源码 ####

cd /usr/local/src
    # 安装wget命令
    apt-get install wget
    wget https://www.python.org/ftp/python/3.6.8/Python-3.6.8.tgz
    tar -zxvf Python-3.6.8.tgz 
    mv Python-3.6.8 py3.6
    cd py3.6

#### 3.3 编译并配置环境变量 ####

# 在/usr/local/src/py3.6目录执行以下命令
    ./configure --prefix=/var/jenkins_home/python3 --with-ssl
    make
    make install
    
    #添加python3软链接
     
    ln -s /var/jenkins_home/python3/bin/python3 /usr/bin/python3
    
    # rm -f /usr/bin/python3即可删除软链接
     
    #添加pip3软链接
    # 将/var/jenkins_home/python3/bin/pip3链接到/usr/bin/pip3
    ln -s /var/jenkins_home/python3/bin/pip3 /usr/bin/pip3
    
    # 查看安装结果
    # 输入python3，查看是否有对应信息输出
    python3
    # 输入exit()即可退出python的交互页面

![在这里插入图片描述][a41b4dceca5c4351ab257eb98f04ca78.png]

#### 3.4 安装项目所需python包依赖 ####

# 在python根目录下生成requirements.txt(指定python项目所依赖的包)
    pip3 freeze > requirements.txt　　
    # 将requirements.txt上传到主机
    docker cp requirements.txt jenkins:/usr/local/src
    # 安装所需的依赖到jenkins中
    pip3 install -r requirements.txt

### 4 安装allure依赖：输出测试报告 ###

# 退出jenkins容器，执行下面命令
    # 官网地址：https://github.com/allure-framework/allure2/releases  建议选择最新版本下载
    # 下载成功之后上传到服务器 或者直接通过wget命令下载也可以
    wget https://github.com/allure-framework/allure2/releases/download/2.23.1/allure-2.23.1.zip
    docker cp allure-2.23.1.zip jenkins:/usr/local/src
    
    # 重新进入jenkins容器中执行下面命令
    docker exec -itu root jenkins bash
    
    # 解压
    unzip allure-2.23.1.zip
    
    mv allure-2.23.1 allure
    
    # /var/jenkins_home/python3/bin/python3.6 
    #配置python和allure环境
    cat >> /root/.bashrc << "EOF"
    export PATH=/usr/local/src/allure/bin:$PATH
    export PATH=/usr/local/src/py3.6/bin:$PATH
    EOF
    
    # 更新环境变量配置
    source /root/.bashrc
    
    # 验证环境变量
    allure --version

### 5 安装Java环境：allure需要有java环境 ###

> 运行allure需要java环境

cd /usr/local
    wget https://download.java.net/openjdk/jdk8u43/ri/openjdk-8u43-linux-x64.tar.gz
    
    tar -xzf openjdk-8u43-linux-x64.tar.gz -C /usr/local/src/
    cd /usr/local/src
    mv java-se-8u43-ri java8
    
    # 配置Java环境变量
    echo "export JAVA_HOME=/usr/local/src/java8" >> /root/.bashrc
    echo "export PATH=\$JAVA_HOME/bin:\$PATH" >> /root/.bashrc
    
    source /root/.bashrc
    # 验证Java安装
    java -version

![在这里插入图片描述][ffbcf726625d49978db72f7c893a16d3.png]

### 6 安装pytest ###

pip3 install pytest
    ln -s /var/jenkins_home/python3/bin/pytest /usr/bin/pytest
    export PATH=/usr/local/src/pytest/bin:$PATH
    source /root/.bashrc
    # 输入pytest查看是否安装成功

### 7 配置jenkins中的插件和git地址 ###

#### 7.1安装allure插件 ####

![在这里插入图片描述][68e63fda67164114b400217169a102a1.png]

#### 7.2 设置本地jenkins容器中allure的可执行文件地址 ####

![在这里插入图片描述][20e9b9ba4e5a4b99935d2f32168ccff0.png]

#### 7.3 新建jenkins项目(项目风格可以选择自由风格) ####

①Item- 新建- 选择Freestyle project - 填写项目名称  
![在这里插入图片描述][0dbd81e27e2a4aef9f696000e33af265.png]

②填写项目描述信息，并配置源码管理（配置git仓库地址和凭证）  
![在这里插入图片描述][b6c1f0e8e7094c37a731d41596f439e6.png]

> 编写好自动化测试脚本（python代码）后，上传到git仓库中
> 
>  *  例如：https://gitee.com/Zifasdfa/pytest.git

③配置构建步骤  
![在这里插入图片描述][acf8450a75bc47eda9098117d4533f24.png]④添加构建的步骤（生成allure报告）  
![在这里插入图片描述][21b843c7196e459eb12b5cbfbbfd6854.png]

> 在allure report模块下，点击高级

![在这里插入图片描述][39cb8887a6cd4ccb9cb92d3d0ce12384.png]  
点击应用，然后点击保存

⑤构建任务，点击立即构建  
![在这里插入图片描述][6eba2748ab3f454d8999245244aa6726.png]  
⑥构建结果  
![在这里插入图片描述][579fd6835a2e4c92abfb976cf31bfc59.png]

> 点击allure report，跳转用例输出界面，查看具体测试结果信息

![在这里插入图片描述][7d3a9897dd7b4788bf0346d034fe00dc.png]

> 根据需求，可以将本地已经部署好的jenkins容器打包本地镜像上传到dockerhub

docker tag jenkins/jenkins:lts ziyigun/jenkins:v1.0
    docker login
    # 输入用户名和密码
    # 推送到dockerhub仓库
    docker push ziyigun/jenkins:v1.0

[214d987cf59d4a70aa9dd73969d8e8e9.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/13/f981cb4ae45249b8aa996e3b2267d96c.png
[ccbcb02ec04b4d588b38e69f4a8fb350.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/13/b8f14c6b04b849799b32ccdb83bdc391.png
[a41b4dceca5c4351ab257eb98f04ca78.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/13/09268611799a4d5b8974c2f100d3ab1d.png
[ffbcf726625d49978db72f7c893a16d3.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/13/e2eae9a3493546c985d4df1613f70e17.png
[68e63fda67164114b400217169a102a1.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/13/23319733f45148079892169de062c67a.png
[20e9b9ba4e5a4b99935d2f32168ccff0.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/13/e51280b39be14520987689d4340f93aa.png
[0dbd81e27e2a4aef9f696000e33af265.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/13/f119edeb289e4cfca09fa5cc18fb759a.png
[b6c1f0e8e7094c37a731d41596f439e6.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/13/de38a4aa2e2f4fc9a6dd1a97cbbd88c7.png
[acf8450a75bc47eda9098117d4533f24.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/13/eae8450dc943481881a9f74638d27422.png
[21b843c7196e459eb12b5cbfbbfd6854.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/13/b0179ad1dde946c88aa4b2972faa2b12.png
[39cb8887a6cd4ccb9cb92d3d0ce12384.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/13/3ec798087d5b431792558acf67b694ac.png
[6eba2748ab3f454d8999245244aa6726.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/13/2604374833c845a58891caeebf7b7cb9.png
[579fd6835a2e4c92abfb976cf31bfc59.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/13/51847586416c450eac278c1d37d2d140.png
[7d3a9897dd7b4788bf0346d034fe00dc.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/13/4589935c1ec74b228d67f2e399e0e6ef.png