30 lines
2.6 KiB
Markdown
30 lines
2.6 KiB
Markdown
# 升级到 1.4.0并保留原连接
|
||
|
||
升级脚本在原Node进程中替换工作台实现,保留现有内存连接对象、项目和会话。它不会读取、打印、导出或复制API Key。普通停止后重启会丢失仅在内存中的Key,需要重新填写。
|
||
|
||
## 升级条件
|
||
|
||
使用已经验收的1.4.0便携包,保留原启动目录和当前实现目录,使用新的独立发行目录。工作台的任务、检查、Git、文件批次和审批没有活动执行,本地9229端口可用。脚本接受127.0.0.1上的0.1.0及1.0.0–1.4.0工作台,先核对PID和原发行路径,再迁移对象。升级后校验公开配置、项目、会话和PID,并关闭本次开启的调试端口。控制请求使用独立HTTP连接。
|
||
|
||
首次从旧JSON进入SQLite时,在保留原字节备份的事务中迁移,旧历史以legacy-import标明来源。已有SQLite实例保留原状态与Map,并补齐新增Git和change_set类型。1.4.0给旧会话增加空的execution.changeSets数组,原字段和实际批次记录保留。随附npm位于新发行runtime,原进程保留原Node可执行路径并使用新npm检查器。
|
||
|
||
## 执行
|
||
|
||
在解压后的1.4.0便携目录打开PowerShell。使用service-info保存的原启动目录,数据目录沿用当前启动配置;此前已热升级的实例另传当前handler目录。运行中的发行目录保持不变,后续打包创建新的时间戳目录。
|
||
|
||
```powershell
|
||
$awNewRoot = (Get-Location).Path
|
||
$awServiceInfo = Get-Content -LiteralPath (Join-Path $env:LOCALAPPDATA 'AgentWorkbench\service-info.json') -Encoding UTF8 -Raw | ConvertFrom-Json
|
||
$awUpgradeArguments = @((Join-Path $awNewRoot 'scripts\upgrade-running.mjs'), '--url', 'http://127.0.0.1:4318', '--pid', $awServiceInfo.pid, '--current-root', $awServiceInfo.appRoot, '--new-root', $awNewRoot)
|
||
if ($awServiceInfo.runtimeRoot) { $awUpgradeArguments += @('--handler-root', $awServiceInfo.runtimeRoot) }
|
||
& (Join-Path $awNewRoot 'runtime\node.exe') @awUpgradeArguments
|
||
```
|
||
|
||
成功后访问 `http://127.0.0.1:4318/?release=1.4.0`,界面显示v1.4.0。「改动」面板可审查整批文件与恢复结果,任务记录可查看工程检查、Git及交付报告;已有项目继续指向原目录。
|
||
|
||
`service-info.json`保留原启动目录,并更新当前实现目录`runtimeRoot`与版本。再次运行启动器会复用当前本地服务;以后需要重启时,从最终1.4.0目录启动。
|
||
|
||
## 验证范围
|
||
|
||
独立旧版进程测试已验证同PID升级、文件及提案保留、合成内存Key的升级后认证和调试端口关闭。正式用户连接与原会话的升级验证单独记录在 [验收记录](VALIDATION.md)。
|