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

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

文章目录 🚀前言🔑开通GitLink个人建站服务1. 前提条件2. 登录GitLink平台（ .gitlink.org /login）3. 进入设置>个人建站>我的站点4. 新建站点5. 去仓部进行部署6. 安装Bot"个人建站自动部署" 💻推送Allure HTML报告到个人建站服务仓库✅查看测试报告

🚀前言

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

🔑开通GitLink个人建站服务 1. 前提条件 拥有一个GitLink平台的账号，可通过如下链接进行注册： .gitlink.org /registerGitLink平台账号已完成实名认证。 2. 登录GitLink平台（ .gitlink.org /login）

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

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

4. 新建站点

5. 去仓部进行部署

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

Bot地址： .gitlink.org /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， 例如： gitlink.org /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" {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="C:\1projects\apiautotest_ky\outputs\report\allure_html", username="xxxxx", password="xxxxx"]) ✅查看测试报告

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