统一各平台发布包目录结构并补齐配置迁移工具
This commit is contained in:
1 parent
33783c435d
commit
e1cbac2947
7 files changed
+238
-56
No files matched your search
+20
-3
@@ -43,8 +43,25 @@ node deploy/build-plugins.mjs --target=windows_amd64
|
||||
node deploy/build-plugins.mjs --all
|
||||
```
|
||||
|
||||
支持 Linux、Windows、macOS 的 amd64 和 arm64。插件产物位于 `out/plugins/<平台>_<架构>`,发布目录位于 `out/package/<平台>_<架构>`。每个平台的发布目录均包含主程序、管理工具、三个插件及发布元数据;插件使用后端目录中约定的固定文件名,不需要手动去掉平台后缀。
|
||||
支持 Linux、Windows、macOS 的 amd64 和 arm64。插件编译中间产物位于 `out/plugins/<平台>_<架构>`,发布目录位于 `out/package/Smail_<系统>_<架构>/smail/`。系统名使用 `linux`、`windows`、`darwin`。压缩包输出到 `out/release/`,例如 `Smail_linux_amd64.tar.gz`、`Smail_windows_amd64.zip`。Windows 使用 ZIP,其余平台使用 TAR.GZ。
|
||||
|
||||
GitHub 发布工作流复用相同的插件构建脚本。三个插件保持独立进程,随主程序一起交付,并非合并进主程序执行文件;原有启停配置和进程隔离检查不变。编译成功不代表第三方服务已配置、推送已送达或生产平台隔离验收完成。Windows 生产模式现有的插件隔离限制仍然保留,不会因打包而绕过。
|
||||
每个压缩包解压后直接得到以下结构,Windows 的三个程序带 `.exe` 后缀:
|
||||
|
||||
构建和打包不清理旧文件。旧版平铺产物会保留,但不会被新的按平台打包流程选入。
|
||||
```text
|
||||
smail/
|
||||
├── smail
|
||||
├── smail-admin
|
||||
├── smail-config
|
||||
├── config/
|
||||
├── data/
|
||||
├── ssl/
|
||||
└── log/
|
||||
```
|
||||
|
||||
网页和三个插件的可执行文件内嵌于主程序。插件运行时仍是独立进程,原有启停配置和进程隔离检查不变。包内四个目录为空,不携带本机配置、数据库、密钥、证书、部署或续期脚本;首次运行通过项目初始化流程生成配置。管理员恢复工具和配置迁移工具均为编译后的程序。
|
||||
|
||||
Makefile 和 GitHub 发布工作流统一调用 `node deploy/package.mjs`。已有编译产物时可附加平台参数单独打包,例如 `node deploy/package.mjs linux_amd64`。Windows 主机生成 Linux/macOS 压缩包时自动使用 Git for Windows 附带的 GNU tar,以写入 Unix 可执行权限,也可通过环境变量 `SMAIL_TAR` 指定其他 GNU tar 路径;Windows ZIP 使用系统 tar,Linux/macOS 主机分别使用 tar 和 zip。上述工具仅在构建机器使用,部署服务器不需要构建或部署脚本。
|
||||
|
||||
打包先检查三个程序,再从全新目录生成发布包。相同名字的旧目录、压缩包和回执移入 `out/build-history/release-*/` 保留,旧版平铺产物不参与打包。校验回执在 `out/release-receipts/Smail_<系统>_<架构>.json`,包含程序和压缩包的 SHA-256,不进入发布包。
|
||||
|
||||
编译成功不代表第三方服务已配置、推送已送达或生产平台隔离验收完成。Windows 生产模式现有的插件隔离限制仍然保留,不会因打包而绕过。
|
||||
+1
-1
@@ -33,7 +33,7 @@ Smail/
|
||||
└── docs/ # 项目文档
|
||||
```
|
||||
|
||||
`out/package/` 和 `out/release/` 分别供 Makefile 打包及 CI 发布使用。开发日志由 `deploy/start-dev.ps1` 写入 `test-log/runtime/`,测试入口为 `node test/run.mjs all`。
|
||||
Makefile 与 CI 使用相同打包流程:`out/package/Smail_<系统>_<架构>/smail/` 保存部署目录,`out/release/` 保存同名压缩包,校验回执独立保存在 `out/release-receipts/`。部署包固定包含三个程序和 `config/data/ssl/log` 四个空目录,完整说明见《插件构建与配置》。开发日志由 `deploy/start-dev.ps1` 写入 `test-log/runtime/`,测试入口为 `node test/run.mjs all`。
|
||||
|
||||
## 必须保留的例外
|
||||
|
||||
|
||||
Reference in new issue
Block a user