CI/CD / 系统课时

运行自动化测试

运行自动化测试

持续集成中的自动化测试不是“跑一下命令”,而是把测试结果转换成可靠门禁:在隔离环境执行、让失败退出码真实传递给流水线,并在成功或失败时都留下可追溯的测试报告。

学习目标

  • 在隔离环境中安装测试依赖并执行单元测试
  • 正确使用进程退出码决定流水线成功或失败
  • 生成并保存 JUnit 测试报告,便于定位失败用例

在隔离环境中执行测试

流水线应从干净环境开始,避免开发机上已有依赖掩盖缺包、版本漂移或隐式环境变量问题。下面用 Python 虚拟环境构造一个最小项目,并通过 pytest 执行测试;真实项目可把依赖固定到 requirements.txt 或锁文件中。

bash
set -euo pipefail
python -m venv .venv
. .venv/bin/activate
python -m pip install -q pytest
mkdir -p tests reports
cat > app.py <<'PY'
def add(a, b):
    return a + b
PY
cat > tests/test_app.py <<'PY'
from app import add

def test_add():
    assert add(2, 3) == 5
PY
python -m pytest -q --junitxml=reports/junit.xml

预期输出

text
.                                                                        [100%]
- generated xml file: <PATH>/reports/junit.xml -
1 passed in <TIME>s

<PATH> 和 <TIME> 会随运行环境变化。关键结果是测试进程成功结束,并生成 reports/junit.xml。

让退出码成为质量门禁

CI 系统通常只看进程退出码判断步骤是否成功:0 表示成功,非 0 表示失败。不要在测试命令后追加 || true,也不要无条件把脚本最后的退出码改成 0,否则失败用例会被伪装成成功构建。

需要显式记录退出码时,可以在退出前打印它,但最终仍要把原始状态返回给 CI。

bash
python -m pytest -q
status=$?
echo "pytest_exit_code=$status"
exit "$status"

当测试全部通过时,预期输出末尾类似:

text
1 passed in <TIME>s
pytest_exit_code=0

如果任一用例失败,pytest 会返回非零退出码,脚本也以相同状态结束,因此流水线必须失败。具体非零值可能随测试框架和失败类型不同,不应在门禁逻辑中把某个固定非零值当作“成功”。

在失败时也保存测试报告

测试失败后,报告反而最有价值。以 GitHub Actions 为例,测试步骤正常传递失败状态,而上传步骤使用 if: always(),这样即使测试失败,JUnit XML 仍会作为构件保存。

yaml
name: test

on:
  push:
  pull_request:

jobs:
  unit-test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: "3.12"
      - run: |
          python -m pip install pytest
          mkdir -p reports
          python -m pytest -q --junitxml=reports/junit.xml
      - name: Upload test report
        if: always()
        uses: actions/upload-artifact@v4
        with:
          name: junit-report
          path: reports/junit.xml

这段配置的生效行为是:测试失败时 unit-test 作业保持失败状态,但上传步骤仍尝试保存 reports/junit.xml。验证时可故意把断言改错并提交一次临时分支,确认流水线变红且仍能下载 junit-report;验证后立即恢复断言。

处理失败时保留可诊断信息

可靠的测试门禁至少要保留失败用例名、断言或异常信息、测试耗时和报告文件。若测试依赖数据库、缓存或消息队列,还应把这些服务固定到可重复创建的测试环境中,避免把偶发环境问题误判为代码回归。

最终验收标准很简单:通过用例使流水线成功;失败用例使流水线失败;两种情况下都能拿到测试报告。只要这三点同时成立,自动化测试才真正成为持续集成门禁。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

运行自动化测试

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通