如何为GitLab流水线作业按测试通过率配置自定义状态图标？

开发者阿泽

2026-6-12

GitLab流水线作业自定义状态图标实现方案

GitLab原生不支持直接替换作业状态的内置图标（成功绿色对勾、失败红色叉、警告黄色三角），但可以通过自定义徽章+作业状态控制的组合方式，实现按测试通过率细分状态的需求。

具体实现步骤

1. 在测试作业中计算通过率

首先在测试脚本里统计测试用例的成功数和总数，算出通过率，示例脚本如下（根据你的测试框架调整逻辑）：

# 示例：从JUnit格式的测试报告中提取数据
total_tests=$(grep -c '<testcase' test-results.xml)
passed_tests=$(grep -c '<testcase.*status="passed"' test-results.xml)
# 计算整数通过率
pass_rate=$((passed_tests * 100 / total_tests))
# 将通过率写入环境变量文件，方便后续使用
echo "PASS_RATE=$pass_rate" >> build.env

2. 根据通过率生成自定义徽章并控制作业状态

在同一作业中，根据通过率生成对应状态的SVG徽章，并通过退出码或警告消息控制GitLab作业的原生状态：

# 生成自定义SVG徽章
if [ $pass_rate -eq 100 ]; then
  # 100%通过率：生成成功徽章，作业标记为成功
  echo '<svg xmlns="http://www.w3.org/2000/svg" width="80" height="20"><rect width="80" height="20" fill="#4c1"/><text x="10" y="15" fill="#fff" font-size="12">测试: 成功</text></svg>' > test-status.svg
  exit 0
elif [ $pass_rate -ge 80 ]; then
  # 80%-99%通过率：生成警告徽章，作业标记为带警告的成功
  echo '<svg xmlns="http://www.w3.org/2000/svg" width="80" height="20"><rect width="80" height="20" fill="#dfb317"/><text x="10" y="15" fill="#fff" font-size="12">测试: 警告</text></svg>' > test-status.svg
  # 输出GitLab警告消息，让作业显示黄色警告标记
  echo "::warning::测试通过率为${pass_rate}%，未达到100%"
  exit 0
else
  # 通过率<80%：生成失败徽章，作业标记为失败
  echo '<svg xmlns="http://www.w3.org/2000/svg" width="80" height="20"><rect width="80" height="20" fill="#e05d44"/><text x="10" y="15" fill="#fff" font-size="12">测试: 失败</text></svg>' > test-status.svg
  exit 1
fi

3. 配置GitLab CI作业

在.gitlab-ci.yml中配置测试作业，上传徽章作为产物，并传递环境变量：

test-microservice:
  script:
    - # 运行你的微服务测试命令（比如mvn test、pytest等）
    - # 执行上面的通过率计算和徽章生成脚本
  artifacts:
    paths:
      - test-status.svg # 保存自定义徽章
    reports:
      dotenv: build.env # 传递通过率变量给其他作业（可选）
  allow_failure: false # 通过率<80%时作业失败，如需允许失败可改为true

4. 展示自定义徽章

你可以在项目README、流水线详情页或项目主页中引用这个徽章，示例链接格式：

![测试状态](https://gitlab.example.com/你的项目路径/-/jobs/artifacts/main/raw/test-status.svg?job=test-microservice)

关键说明

GitLab的作业内置状态图标无法自定义，但通过上述方案，既能利用原生状态（成功/失败/警告）的颜色标记，又能通过自定义徽章展示更明确的状态信息
徽章的SVG内容可以根据需求调整样式（比如添加通过率数值），也可以用第三方工具生成，但直接脚本生成无需依赖外部服务

内容的提问来源于stack exchange，提问作者rc22