55 lines
2.6 KiB
Markdown
55 lines
2.6 KiB
Markdown
# 🧪 测试环境自动化构建使用手册
|
||
|
||
本手册用于指导测试人员如何通过 Jenkins 快速部署指定分支的代码，并访问对应的测试地址。
|
||
|
||
---
|
||
|
||
### 1. 环境准备
|
||
|
||
| 平台名称 | 地址 |
|
||
| ---------------------- | ------------------------------------------------------------ |
|
||
| Jenkins IM前端构建任务 | [Jenkins](http://192.168.5.100:8100/job/IM前端/build?delay=0sec) |
|
||
| Jenkins IM后端构建任务 | [IM后端 - Jenkins](http://192.168.5.100:8100/job/IM后端/) |
|
||
| 前端分支列表 | https://im.test.nxsir.cn |
|
||
|
||
在开始构建前，请确认：
|
||
|
||
* 已拥有 **Jenkins 登录权限**。
|
||
* **前置环境wireguard**已启动。
|
||
* 已获取需要测试的 **Git 分支名称**（例如：`feature/order-page`）。
|
||
|
||
---
|
||
|
||
### 2. 构建操作步骤流程
|
||
|
||
1. **登录 Jenkins**：访问 [此处输入你的Jenkins地址] 并登录。
|
||
2. **进入任务**：在项目列表中点击进入对应的测试项目。
|
||
3. **参数化构建**：
|
||
* 点击左侧菜单栏的 **Build with Parameters**（带参数构建）。
|
||
* 在 **`BRANCH_NAME`** 输入框中，填入或选择你的 Git 分支名。
|
||
4. **开始构建**：点击下方的 **Build** 按钮。
|
||
|
||
> ⚠️ **提示**：建议直接从代码仓库复制分支名，避免手动输入导致拼写错误。
|
||
|
||
---
|
||
|
||
### 3. 查看构建状态与结果
|
||
|
||
* **观察状态**：在左下角 **Build History** 看到圆形图标变为 **蓝色/绿色**，表示构建成功。
|
||
* **访问网页**：
|
||
* 构建成功后，点击该次构建编号（如 `#10`）。
|
||
* 在详情页中点击 **[访问测试环境]** 链接（通常位于页面显著位置）。
|
||
* 或者直接访问：`https://im.test.nxsir.cn/[分支名]`
|
||
|
||
---
|
||
|
||
### 4. 常见问题排查
|
||
|
||
| 现象 | 可能原因 | 解决方法 |
|
||
| :-------------------------- | :--------------------- | :----------------------------------------------------------- |
|
||
| **构建显示红色（Failure）** | 分支名不存在或代码冲突 | 检查分支名是否已推送到远端仓库。 |
|
||
| **点击链接显示 404** | 部署尚未完全完成 | 构建完成后通常有几秒延迟，请稍后刷新。 |
|
||
| **页面依然显示旧内容** | 浏览器缓存 | 请使用 `Ctrl + F5` (Windows) 或 `Cmd + Shift + R` (Mac) 强制刷新。 |
|
||
|
||
---
|
||
**💡 运维备注**：如遇 Jenkins 无法登录或构建按钮置灰，请联系管理员。 |