平台集成jenkins教程

平台配置流程如下

一.本平台「Jenkins 集成」页面怎么配置

打开侧栏 「Jenkins 集成」，从上到下说明每一项。

1. 启用 Jenkins 触发

打开 「启用 Jenkins 触发」 开关。
关掉时，点「触发 Jenkins」会提示未启用。

2. Jenkins 根地址（必填）

填 Jenkins 在浏览器里能打开的地址，不要带末尾斜杠后的多余路径。
示例：
http://192.168.1.10:8080
https://jenkins.公司域名.com
要求：跑本平台的这台机器（或容器）能访问这个地址。

3. Job 路径（必填）

填任务在 Jenkins 里的路径，不是完整 URL。
没有文件夹：任务名叫 auto-test，就填：
auto-test
有多层文件夹：例如文件夹 qa 下任务 regression，填：
qa/regression
（用英文 / 分隔，和 Jenkins 左侧任务树一致。）

4. 用户名

填 Jenkins 里有权限触发该任务的用户登录名（不是邮箱显示名）。

5. API Token（Jenkins 侧生成）

在 Jenkins：右上角用户名 → 设置（Configure）→ API Token → Add new Token → 生成，复制令牌。
第一次在本平台保存时，把完整 Token 粘贴进 API Token 框。
以后若不改密码：可以留空保存，表示不修改已保存的 Token。
页面会显示类似 abcd****wxyz 的脱敏，表示已保存过。

6. 参数名 · 套件 ID / 用例 ID（一般保持默认即可）

默认一般是：
套件 ID 参数名：AUTOTEST_SUITE_ID
用例 ID 参数名：AUTOTEST_CASE_ID
必须和 Jenkins 任务里「参数的名字」完全一致（区分大小写）。若你改了这里，Jenkins 里参数名也要一起改。

7. 保存

点 「保存配置」。
若勾选了 「重新生成远程令牌」 并保存，会弹窗显示一整串新令牌——这是给 Jenkins 调本平台用的，复制保存到安全地方（或 Jenkins 凭据），关闭后平台只显示脱敏。

8. 页面下方的 curl 示例（远程执行）

平台根 URL：一般就是当前浏览器地址的 http(s)😕/主机:端口，示例里的 curl 会用它。
<远程令牌>：换成你保存的远程令牌（不是 Jenkins API Token）。
{"suite_id":1} / {"test_case_id":2}：把数字换成你的真实套件 ID、用例 ID。

二.Jenkins 端要怎么配置（按顺序）

步骤 1：新建任务

新建 Pipeline 或 自由风格 都可以；下面以「需要参数」为前提。

步骤 2：勾选「参数化构建」

在任务配置里找到 「参数化构建过程」 / This project is parameterized。
添加 String Parameter（字符串参数），建两个：
参数名（Name） 说明
AUTOTEST_SUITE_ID 对应平台「套件 ID」；不用时可默认空字符串。
AUTOTEST_CASE_ID 对应平台「用例 ID」；不用时可默认空字符串。
名字要和本平台「Jenkins 集成」里配置的两项完全一致。

步骤 3：在构建步骤里写逻辑（至少选一种）

方案 1：让 Jenkins 去调本平台执行测试（推荐和「触发 Jenkins」配合）

在 Jenkins 里配置一个凭据（Secret text），内容为平台给的 远程令牌。

在任务里勾选 「Use secret text(s) or file(s)」（或绑定该凭据到环境变量，例如 AUTOTEST_REMOTE_TOKEN）

构建步骤用「Execute Windows batch command」+ curl

点击查看代码

set PLATFORM=http://127.0.0.1:8000
set TOKEN=你的远程令牌

if not "%AUTOTEST_SUITE_ID%"=="" (
  curl -sS -X POST "%PLATFORM%/api/integrations/jenkins/remote-run" -H "Content-Type: application/json" -H "X-AutoTest-Token: %TOKEN%" -d "{\"suite_id\": %AUTOTEST_SUITE_ID%}"
  exit /b %ERRORLEVEL%
)
if not "%AUTOTEST_CASE_ID%"=="" (
  curl -sS -X POST "%PLATFORM%/api/integrations/jenkins/remote-run" -H "Content-Type: application/json" -H "X-AutoTest-Token: %TOKEN%" -d "{\"test_case_id\": %AUTOTEST_CASE_ID%}"
  exit /b %ERRORLEVEL%
)
echo 未设置 AUTOTEST_SUITE_ID 或 AUTOTEST_CASE_ID
exit /b 1

自测 Jenkins 能否被触发

在 Jenkins 任务页点 「Build with Parameters」，手动填一个套件 ID 或 用例 ID，看能否成功构建。
再回到本平台，在套件/用例卡片上点 「触发 Jenkins」，看 Jenkins 是否出现新构建。

流程 1：只在本平台点「触发 Jenkins」

本平台填好 Jenkins 地址、Job 路径、用户、API Token，启用。
Jenkins 任务必须：参数化 + 参数名与平台一致。
Jenkins 里想在本平台跑测：在构建步骤里用 远程令牌 调 remote-run（见上文方案 1）。

流程 2：定时 / 只在 Jenkins 里跑

在 Jenkins 配定时器，构建步骤里直接 curl 调
POST .../api/integrations/jenkins/remote-run
带上 X-AutoTest-Token 和 {"suite_id":xxx} 或 {"test_case_id":xxx}。
不必点本平台的「触发 Jenkins」，但远程令牌必须在平台里已生成并保存好。