Tracera
开始试用

集成

连接 CI 流水线，以便从 Tracera 通过 运行 与 重跑 启动各提供方的构建。

项目设置中的集成与 CI 流水线列表
集成：在 项目设置 中管理流水线，用 添加 连接提供方。

开始之前

  1. 打开 项目设置 → 集成（需要项目设置权限）。
  2. 将项目 Autotest 令牌保存在 CI secrets 中 — 见 令牌。Tracera 启动流水线时 不会 发送该令牌。
  3. 使用在设置了 TRACERA_TEST_RUN_ID 时上报结果的适配器 — 见 适配器。

工作原理

  1. 在 集成 中选择 添加 并挑选提供方。
  2. 填写 流水线、连接 以及可选的 参数 选项卡，然后保存。
添加 GitHub Actions 流水线对话框，含流水线、连接与参数选项卡
添加 流水线：流水线、连接 以及可选的 参数。
  1. 当你 运行 或 重跑 且项目已有流水线时，Tracera 会打开 在 CI 中运行 对话框。最多选择 10 条流水线（预勾选遵循 默认）。
在 CI 中运行对话框，含流水线复选框
在 CI 中运行：启动或重跑后最多选择 10 条流水线——已开启 默认 的会勾选。
  1. Tracera 创建运行，然后触发所选流水线。始终发送 TRACERA_TEST_RUN_ID、TRACERA_BASE_URL 和 TRACERA_PROJECT_ID（UI 对这些键的覆盖会被忽略）。流水线的自定义参数会一并包含。不会发送 Autotest Bearer。
  2. 在 CI 中将这些值映射到任务环境，将 Autotest 令牌放在 secrets 中，并用设置了 TRACERA_TEST_RUN_ID 的适配器上报。

多条流水线可以共用一个连接。更新该连接上的令牌会作用于使用它的所有流水线。

提供商

GitHub Actions

流水线：仓库（owner/repo）、工作流 文件（例如 e2e.yml）、引用。可选 服务器 URL（留空 = api.github.com）。

在 workflow 文件中将 TRACERA_TEST_RUN_ID、TRACERA_BASE_URL、TRACERA_PROJECT_ID 以及任意自定义参数声明为 workflow_dispatch inputs。否则 GitHub 会拒绝意外的 inputs。

Jenkins

流水线：任务 URL（必须包含 /job/… 段）。连接：用户名 与 API 令牌，服务器来自任务 URL。

GitLab CI

流水线：GitLab 项目（路径 group/project 或数字 id）与 引用。可选 服务器 URL（留空 = gitlab.com）。

TeamCity

流水线：构建类型 id。连接：服务器 URL（必填）与令牌。

Azure Pipelines

流水线：组织、Azure 项目、流水线 id 与 分支。可选 服务器 URL（留空 = dev.azure.com）。

相关：项目设置、令牌、适配器。