# 🧪 测试环境自动化构建使用手册

本手册用于指导测试人员如何通过 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 无法登录或构建按钮置灰，请联系管理员。