使用GitLink个人建站服务部署Allure在线测试报告

更多技术文章，点击访问软件测试社区

🚀前言

在实际工作中，我们常常需要将测试报告发送给相关方。然而，使用Allure报告存在一定的操作门槛。例如，用户需要先安装Allure程序，再通过特定命令才能查看报告。对于非技术人员来说，这一过程不够友好，不仅增加了使用成本，还降低了工作效率。
为了解决这一问题，我们可以通过GitLink个人建站服务来托管Allure报告。借助这种方式，相关方只需点击一个链接，即可直接查看报告，无需安装任何工具或执行复杂命令。这不仅极大提升了报告的易用性和访问效率，还简化了操作流程，降低了使用门槛，使报告分享变得更加便捷。

🔑开通GitLink个人建站服务

1. 前提条件

• 拥有一个GitLink平台的账号，可通过如下链接进行注册：https://www.gitlink.org.cn/register
• GitLink平台账号已完成实名认证。

2. 登录GitLink平台（https://www.gitlink.org.cn/login）

3. 进入设置>个人建站>我的站点

如果用户未完成实名认证审核，将提示“您尚未通过实名认证，无法使用此服务，如需使用，请先进行实名认证。”， 可点击“前往验证”完成实名认证。

4. 新建站点

实名认证审核通过后，按照要求新建站点即可。
站点新建成功后， 会生成一个对应的仓库，仓库名格式参考如下：{平台登录的login}.gitlink.net。同时部署的服务的网址格式如下：http://{平台登录的login}.gitlink.net/

5. 去仓部进行部署

点击“去仓库”，可以查看到刚刚构建的个人建站服务仓库。
正常流程下：将allure html报告的文件推送到仓库，在"服务tab>个人建站服务”，点击部署即可成功部署Allure测试报告在线服务。
这里我们将使用Bot自动部署服务。

6. 安装Bot"个人建站自动部署"

Bot地址：https://www.gitlink.org.cn/softbot/10039

点击“安装此Bot”将Bot安装到个人建站服务的仓库。

安装完成后，在个人建站服务仓库可以查看到已安装的Bot。 Bot检测到仓库有代码推送会自动部署个人建站服务，无需手动点击部署。

💻推送Allure HTML报告到个人建站服务仓库

我们需要把Allure生成的HTML报告全部推送到个人建站服务仓库。具体参考如下：

推送的方式各异，我这里是自动化测试运行结束后，调用了方法push_allure_report将Allure生成的HTML报告全部推送到个人建站服务仓库。
大家可以参考我的写法。

push_allure_report.py文件具体内容：

# 第三方模块
from loguru import logger
# 标准库导入
import subprocess
import shutil
import os

"""
subprocess.run: 用于执行系统命令。

 check=True 表示如果命令执行失败会抛出异常。

 -C 参数用于指定Git命令的工作目录。
 
"""
def copy_all_files(src_dir, dst_dir):
    """
    将源目录中的所有文件和子目录复制到目标目录中。

    参数:
        src_dir (str): 源目录路径。
        dst_dir (str): 目标目录路径。
    """
    try:
        # 确保目标目录存在
        os.makedirs(dst_dir, exist_ok=True)

        # 遍历源目录中的所有文件和子目录
        for item in os.listdir(src_dir):
            src_item = os.path.join(src_dir, item)  # 源文件/目录的完整路径
            dst_item = os.path.join(dst_dir, item)  # 目标文件/目录的完整路径

            if os.path.isfile(src_item):
                # 如果是文件，直接复制
                shutil.copy2(src_item, dst_item)
                print(f"复制文件: {src_item} -> {dst_item}")
            elif os.path.isdir(src_item):
                # 如果是目录，递归复制
                shutil.copytree(src_item, dst_item, dirs_exist_ok=True)
                print(f"复制目录: {src_item} -> {dst_item}")
    except Exception as e:
        print(f"复制失败: {e}")

def push_allure_report(allure_report_dir: str, remote_url: str, username: str, password: str, branch: str = "master",
                       message: str = "update report"):
    """
    将本地生成的 Allure HTML 报告推送到指定的 GitLink 仓库。
    :param allure_report_dir : 本地生成的 Allure HTML 报告目录路径。
    :param remote_url:  远程仓库的HTTP地址， 需要带有.git， 例如：https://gitlink.org.cn/floraachy/floraachy.gitlink.net.git。
    :param branch:  远程仓库的分支。
    :param username:  登录远程仓库的用户名。
    :param password:  登录远程仓库的密码。
    :param message: 提交更改的说明信息。
    """

    repo_name = remote_url[:-4].split("/")[-1]
    repo_path = os.path.join(os.path.dirname(allure_report_dir), repo_name)
    print(f"本地仓库地址：{repo_path}")
    logger.info(f"本地仓库地址：{repo_path}")

    try:
        # 检查目录是否存在
        if os.path.exists(repo_path):
            print(f"目录已存在，正在删除: {repo_path}")
            logger.info(f"目录已存在，正在删除: {repo_path}")
            shutil.rmtree(repo_path)  # 删除目录及其内容

        # 重新创建目录
        os.makedirs(repo_path)
        logger.info(f"目录已重新创建: {repo_path}")
        print(f"目录已重新创建: {repo_path}")
    except Exception as e:
        logger.error(f"操作失败: {e}")
        print(f"操作失败: {e}")

    try:
        # -------------初始化本地仓库并提交代码 -----------------
        subprocess.run(["git", "-C", repo_path, "init"], check=True)
        print("初始化本地仓库成功")
        logger.info("初始化本地仓库成功")

        auth_remote_url = f"https://{username}:{password}@{remote_url.split("//")[-1]}"
        print(f"添加远程仓库: {auth_remote_url}")
        logger.info(f"添加远程仓库: {auth_remote_url}")
        subprocess.run(["git", "-C", repo_path, "remote", "add", "origin", auth_remote_url], check=True)

        print("复制 Allure HTML报告所有文件到本地仓库")
        logger.info("复制 Allure HTML报告所有文件到本地仓库")
        copy_all_files(src_dir=allure_report_dir, dst_dir=repo_path)

        print("将更改添加到暂存区")
        logger.info("将更改添加到暂存区")
        subprocess.run(["git", "-C", repo_path, "add", "."], check=True)

        print("提交更改")
        logger.info("提交更改")
        subprocess.run(["git", "-C", repo_path, "commit", "-m", message], check=True)

        print("强制推送代码")
        logger.info("强制推送代码")
        subprocess.run(["git", "-C", repo_path, "push", "--force", "origin", branch], check=True)

        print("Allure 报告推送成功！")
        logger.success("Allure 报告推送成功！")
    except subprocess.CalledProcessError as e:
        print(f"Git 操作失败: {e}")
        logger.error(f"Git 操作失败: {e}")

然后在run.py中调用方法push_allure_report，按照要求传入指定参数，例如：

push_allure_report(allure_report_dir="\report\allure_html", remote_url="http:xxxxxxx.git",
                           username="xxxxx", password="xxxxx"])

✅查看测试报告

当Allure HTML最新报告推送到个人建站仓库后，会自动触发Bot"个人建站自动部署"自动部署最新代码。部署完成后访问网站地址即可查看最新报告。