CI/CD / 系统课时
运行自动化测试
运行自动化测试
持续集成中的自动化测试不是“跑一下命令”,而是把测试结果转换成可靠门禁:在隔离环境执行、让失败退出码真实传递给流水线,并在成功或失败时都留下可追溯的测试报告。
学习目标
- 在隔离环境中安装测试依赖并执行单元测试
- 正确使用进程退出码决定流水线成功或失败
- 生成并保存 JUnit 测试报告,便于定位失败用例
在隔离环境中执行测试
流水线应从干净环境开始,避免开发机上已有依赖掩盖缺包、版本漂移或隐式环境变量问题。下面用 Python 虚拟环境构造一个最小项目,并通过 pytest 执行测试;真实项目可把依赖固定到 requirements.txt 或锁文件中。
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预期输出
. [100%]
- generated xml file: <PATH>/reports/junit.xml -
1 passed in <TIME>s<PATH> 和 <TIME> 会随运行环境变化。关键结果是测试进程成功结束,并生成 reports/junit.xml。
让退出码成为质量门禁
CI 系统通常只看进程退出码判断步骤是否成功:0 表示成功,非 0 表示失败。不要在测试命令后追加 || true,也不要无条件把脚本最后的退出码改成 0,否则失败用例会被伪装成成功构建。
需要显式记录退出码时,可以在退出前打印它,但最终仍要把原始状态返回给 CI。
python -m pytest -q
status=$?
echo "pytest_exit_code=$status"
exit "$status"当测试全部通过时,预期输出末尾类似:
1 passed in <TIME>s
pytest_exit_code=0如果任一用例失败,pytest 会返回非零退出码,脚本也以相同状态结束,因此流水线必须失败。具体非零值可能随测试框架和失败类型不同,不应在门禁逻辑中把某个固定非零值当作“成功”。
在失败时也保存测试报告
测试失败后,报告反而最有价值。以 GitHub Actions 为例,测试步骤正常传递失败状态,而上传步骤使用 if: always(),这样即使测试失败,JUnit XML 仍会作为构件保存。
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;验证后立即恢复断言。
处理失败时保留可诊断信息
可靠的测试门禁至少要保留失败用例名、断言或异常信息、测试耗时和报告文件。若测试依赖数据库、缓存或消息队列,还应把这些服务固定到可重复创建的测试环境中,避免把偶发环境问题误判为代码回归。
最终验收标准很简单:通过用例使流水线成功;失败用例使流水线失败;两种情况下都能拿到测试报告。只要这三点同时成立,自动化测试才真正成为持续集成门禁。