98 lines
6.3 KiB
Markdown
98 lines
6.3 KiB
Markdown
# iXserverLoopEnv：模拟闭环测试环境
|
||
|
||
在 FG-W11-ICON-DEV 一台机器上把五个角色跑起来，让一条 IG 消息从入站到第三方回复、再回到 IG 全程走真 HTTP。
|
||
方案与取舍见 iXserver 仓库的 `docs/构建模拟闭环测试环境.html`。
|
||
|
||
| 角色 | 端口 | 来源 |
|
||
| --- | --- | --- |
|
||
| ABP（授权 + 消息模板） | https 44332 | `C:\Projects\HKTBAbp` 发布到 `run\abp` |
|
||
| iXserver API（IIS Express） | 8081，WebSocket 33346 | `C:\Projects\iXserver` 整解决方案编译后拷到 `run\ixserver` |
|
||
| 第三方 chatbot 客户端 | 5056 | `iXserver\Tools\ThirdPartyChatbotTestClient` |
|
||
| IG 后端模拟 | 5070 | `iXserver\Tools\IgMockServer` |
|
||
| SCRM 客服系统模拟 | 5080 | `iXserver\Tools\ScrmMockServer` |
|
||
|
||
所有端口只绑本机。iXserver 的旧接口和 WebSocket **没有鉴权**，绝不能对外开放 8081 / 33346。
|
||
|
||
## 这个仓库装什么
|
||
|
||
只装「环境」：`loop.ps1`、`config\`、`db\`、`tools\`、`scenarios\`、`deployed.json`。
|
||
程序本身不在这里——两个模拟服务的代码在 iXserver 的 `Tools\`（它们模拟的是 iXserver 自己的协议，
|
||
要和协议改动同一个提交）；编译产物、日志、上传文件在被忽略的 `run\`。
|
||
|
||
**以 Mac 上的 `~/projects/iXserverLoopEnv` 为准**，用 remote-dev-box 的 `sync.sh` 推到 winbox 的
|
||
`C:\Projects\iXserverLoopEnv`。提交在 Mac 上做，winbox 上只跑。
|
||
|
||
## 第一次
|
||
|
||
```powershell
|
||
.\loop.ps1 reset-abp -Init # iCONAbpFX 拷完后：换 setsail secret 与 admin 密码，留底
|
||
.\loop.ps1 deploy # 编译 iXserver 整解决方案 + 发布 ABP（慢）
|
||
.\loop.ps1 reset # 建 iXserverLoop：EDMX 建表 → FeatureTest 种子 → loop_patch，留底
|
||
.\loop.ps1 up
|
||
```
|
||
|
||
之后日常：
|
||
|
||
```powershell
|
||
.\loop.ps1 status
|
||
.\loop.ps1 deploy -Only ixserver # 改了 iXserver 代码
|
||
.\loop.ps1 deploy -Only ixserver -ConfigOnly # 只改了 config\ixserver\overrides.psd1
|
||
.\loop.ps1 reset -FromBackup # 库回到干净状态（秒级）
|
||
.\loop.ps1 logs -Only ixserver -Tail 100
|
||
.\loop.ps1 down
|
||
```
|
||
|
||
## 场景
|
||
|
||
`scenarios\` 下每个脚本独立可跑，通过退出 0、失败退出 1 并打印两侧记录。前提是 `up` 后五个角色都健康。
|
||
|
||
```powershell
|
||
.\scenarios\s1-ig-text-echo.ps1 # IG 文本 → iXserver → 第三方 chatbot echo → IG 收到
|
||
.\scenarios\s8-human-chain.ps1 # SCRM 开工 → 新 IG 用户 → 人工工单推送 → 指派 / 回复 → IG 收到 → 结束 → 下班
|
||
```
|
||
|
||
S8 结束时会把服务号切回机器人、在线人数归零，所以 S1 / S8 先后跑互不影响；要停在人工状态看页面加 `-KeepShift`。
|
||
|
||
从 Mac 看几个页面用 SSH 本地端口转发：
|
||
|
||
```bash
|
||
ssh -N -L 5056:127.0.0.1:5056 -L 5070:127.0.0.1:5070 -L 5080:127.0.0.1:5080 FG-W11-ICON-DEV
|
||
```
|
||
|
||
## 几个容易踩的点
|
||
|
||
- **库是 iXserverLoop，不是 iXsererTest。** FeatureTest 每个方法都 drop 重建 iXsererTest，
|
||
反过来闭环 API 的连接池连着它会让 FeatureTest 无限卡在删库上。
|
||
- **API 从 `run\ixserver` 跑，不从 `API\` 源码目录跑。** 编译 FeatureTest 会刷新 `API\bin` 里的模块 dll，
|
||
正在跑的站点会被回收、甚至换成依赖不全的版本。
|
||
- **`reset` 把建库与 `loop_patch.sql` 绑在一起。** 种子里有真格式的 FB token 与 api.commas.hk 等真实 webhook，
|
||
补丁把它们全换成假值 / 黑洞，并在末尾自检；不提供「只建不补」。
|
||
- **`OAuth_Authority` 必须逐字等于本地 ABP 签出 token 的 `iss`。** IdentityServer4 没设 IssuerUri，
|
||
iss 取请求的 Host，所以全链路统一用 `https://localhost:44332`，换成 127.0.0.1 就全部 401。
|
||
- **签名密钥不在库里**，在 ABP 进程工作目录的 `tempkey.jwk`。deploy 删掉仓库里那把开发密钥，
|
||
首次 `up` 时 ABP 自己生成一把，留存到 `run\abp-key\`，之后重新部署沿用同一把。
|
||
- **备份在 SQL 实例的默认备份目录**（`*.loop.bak`），不在 `run\backup\`：SQL 服务账号对 `C:\Projects` 不一定有写权限。
|
||
- **进程用 WMI（Win32_Process.Create）起**，不用 Start-Process：经 SSH 起的进程会随会话一起被杀。
|
||
pid 记在 `run\pids\`，`down` 按进程树杀。
|
||
- **VS Code 的自动端口转发会抢闭环端口。** 在 winbox 上用 VS Code Remote-SSH 连 Mac 时，它从终端输出里认
|
||
`localhost:端口`，然后在 winbox 本机占住同一个端口转发回 Mac，闭环角色就报「端口被 Code 占着」。
|
||
Mac 的 `~/.vscode-server/data/Machine/settings.json` 已设 `remote.autoForwardPorts=false`、
|
||
`remote.restoreForwardedPorts=false`；已经转发出去的要在 VS Code「端口」面板里停掉。
|
||
- **WMI 起的进程只有系统环境变量。** `TEMP` 是 `C:\Windows\TEMP`，ASP.NET 编译临时目录也会退回系统目录，
|
||
没写权限，首个请求就 500。`loop.ps1` 给每个角色设了 `TEMP`/`TMP` 指到 `run\data\temp`，
|
||
并在 Web.config 的 `<compilation>` 上写 `tempDirectory`。
|
||
- **ABP 的 HTTPS 证书用的是 IIS Express 自带的 localhost 证书**（LocalMachine\My，到 2030 年，已在当前用户受信任根里）。
|
||
winbox 的 ASP.NET dev 证书 2026-05 已过期；用 IIS Express 这张，iXserver（.NET Framework）连 ABP 不用另外信任、也不弹框。
|
||
- **ABP 的各个 DbContext 按名字找连接串，找不到退回 `Default`**，而仓库 `appsettings.json` 的 `Default` 指向公司内网的库。
|
||
`appsettings.Loop.json` 把所有连接串都盖成本机 iCONAbpFX。
|
||
- PowerShell 5.1 的两个坑已经在 `loop.ps1` 里绕开：原生命令往 stderr 写一行就抛异常（统一走 `Invoke-Native`）；
|
||
`Get-Content` 默认按 GBK 读无 BOM 的 UTF-8（拷配置用 `Copy-Item`，脚本文件一律带 BOM）。
|
||
- `deployed.json` 记录每次部署时两个源码仓库的 commit 与未提交文件。闭环结果离开「当时部署的是哪个版本」没法解读，
|
||
跑场景的记录里引用它。注意 winbox 上 iXserver 仓库的 HEAD 不随 `sync.sh` 前进（只推文件），
|
||
`commit` 字段可能停在很久以前，以 `uncommitted` 清单和 Mac 上的提交为准。
|
||
|
||
## 闭环专用凭据（假值，可公开）
|
||
|
||
见 `config\loop.psd1` 的 `Secrets`：setsail 与 FX_App 的 client secret、ABP admin 密码、所有渠道 token 的替身。
|
||
staging 的 secret 明文不出现在这个仓库里。
|