1

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

西街长安 edited this page 2026-01-30 21:34:01 +08:00

Table of Contents

• 🧪 测试环境自动化构建使用手册
• 1. 环境准备
• 2. 构建操作步骤流程
• 3. 查看构建状态与结果
• 4. 常见问题排查

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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

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