自动化测试 / 系统课时

接入持续集成流程

接入持续集成流程

持续集成要解决的不是“在服务器上再跑一次 Selenium”,而是让每次提交都按同一环境安装依赖、启动浏览器、执行测试并留下可追踪的结果。本篇以 GitHub Actions、Python、pytest 和 Chrome 为例,把一条可直接落地的流水线跑通。

学习目标

  • 将 Selenium 测试整理成 CI 可重复执行的命令,并生成 JUnit XML 报告。
  • 配置 GitHub Actions,在提交和拉取请求时自动安装依赖并运行测试。
  • 设置失败门禁、超时与报告归档,使失败提交能够被定位而不是只得到一个红叉。

先把测试变成可重复命令

CI 最怕依赖本机状态。测试应自行创建 WebDriver、使用无界面模式并在结束时调用 quit()。下面的冒烟测试不访问公网,而是加载 data: 页面,因此适合先验证浏览器和 Selenium 环境是否正常。

python
from selenium import webdriver
from selenium.webdriver.common.by import By


def test_ci_smoke():
    options = webdriver.ChromeOptions()
    options.add_argument("--headless=new")

    driver = webdriver.Chrome(options=options)
    try:
        driver.get(
            "data:text/html,%3Ctitle%3ECI%20Smoke%3C/title%3E"
            "%3Ch1%20id%3D%22status%22%3Eready%3C/h1%3E"
        )
        assert driver.title == "CI Smoke"
        assert driver.find_element(By.ID, "status").text == "ready"
    finally:
        driver.quit()

在仓库根目录执行测试,并同时生成机器可读取的 JUnit XML。artifacts 目录必须先创建,避免报告目标目录不存在。

bash
mkdir -p artifacts
python -m pytest tests -q --junitxml=artifacts/junit.xml

预期输出:测试通过时 pytest 返回退出码 0,耗时会随运行环境变化。

text
.                                                                        [100%]
1 passed in <TIME>s

配置 GitHub Actions 工作流

在仓库创建 .github/workflows/selenium.yml。下面配置针对 Python 3.12,在 main 分支的提交和拉取请求上执行,并保留测试报告;timeout-minutes: 15 可以阻止浏览器挂死后无限占用 Runner。

yaml
name: selenium-ci

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
  workflow_dispatch:

jobs:
  selenium:
    runs-on: ubuntu-latest
    timeout-minutes: 15

    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: "3.12"
          cache: pip

      - name: Set up Chrome
        uses: browser-actions/setup-chrome@v1
        with:
          chrome-version: stable

      - name: Install dependencies
        run: |
          python -m pip install --upgrade pip
          python -m pip install selenium pytest

      - name: Run Selenium tests
        run: |
          mkdir -p artifacts
          python -m pytest tests -q --junitxml=artifacts/junit.xml

      - name: Upload test report
        if: always()
        uses: actions/upload-artifact@v4
        with:
          name: selenium-junit-${{ github.run_id }}
          path: artifacts/junit.xml
          if-no-files-found: warn
          retention-days: 14

该配置生效后,推送到 main 或创建指向 main 的 Pull Request 都会创建 selenium job。验证时应同时检查测试步骤状态和 Artifacts 区域:成功或失败运行都应尝试上传 junit.xml,因为上传步骤使用了 if: always()。

Selenium 测试接入持续集成后的执行与报告归档流程

设置触发范围与失败门禁

并不是所有提交都值得跑完整浏览器套件。常见做法是 Pull Request 跑冒烟与核心回归,合并到 main 后再跑完整集合。pytest 可以用 marker 把两类测试分开,例如给核心用例标记 smoke,流水线运行 python -m pytest -m smoke。

如果团队频繁向同一分支推送,可以增加并发控制,让旧运行自动取消,避免 5 次连续提交排队跑 5 份已经过期的浏览器测试。下面是工作流顶层的片段示例,依赖前面的 GitHub Actions 工作流上下文。

yaml
concurrency:
  group: selenium-${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true

生效后,同一工作流和同一 Git ref 的旧运行会在新运行开始时取消。对于要求合并前 Selenium 必须通过的仓库,还应在分支保护规则中把 selenium job 对应的检查设为必需状态检查;这样测试失败时 Pull Request 不能按正常流程合并。

验收一条可用的 CI 流程

首次接入时不要只看 Actions 页面是否出现绿色图标,应实际做一次成功和一次失败验证。成功测试应得到退出码 0 与 JUnit 报告;随后临时把断言改成错误值,例如把 "CI Smoke" 改成 "Wrong Title",确认 pytest 返回非零退出码、job 标记失败,同时报告仍被上传。

验收至少检查以下三点:正常提交能自动触发;断言失败能够阻止测试步骤通过;无论测试成功还是失败,selenium-junit-<RUN_ID> 中都有 junit.xml。完成失败验证后立即恢复正确断言,避免把故意失败的测试提交到主分支。

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

目录与阅读设置

阅读设置

17

记录一个想法

接入持续集成流程

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

登录哪都通