IM/docs/测试环境文档.md

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

本手册用于指导测试人员如何通过 Jenkins 快速部署指定分支的代码，并访问对应的测试地址。

---

1. 环境准备

平台名称	地址
Jenkins IM前端构建任务	Jenkins
Jenkins IM后端构建任务	IM后端 - Jenkins
前端分支列表	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 无法登录或构建按钮置灰，请联系管理员。