112 lines
2.6 KiB
Markdown
112 lines
2.6 KiB
Markdown
# 09 domainCheck 交付打包说明
|
|
|
|
## 一、用途
|
|
|
|
用于在 Windows 本地把当前可交付内容整理成一份压缩包，便于：
|
|
|
|
- 发给运维或部署同事
|
|
- 存档版本快照
|
|
- 迁移到 Linux 服务器前做交付留档
|
|
|
|
## 二、打包脚本
|
|
|
|
根目录脚本：
|
|
|
|
- `package_domain_release.ps1`
|
|
- `verify_domain_release.ps1`
|
|
- `prepare_final_release.ps1`
|
|
- `show_latest_release.ps1`
|
|
|
|
执行方式：
|
|
|
|
```powershell
|
|
powershell -ExecutionPolicy Bypass -File .\package_domain_release.ps1
|
|
```
|
|
|
|
如需一键完成“打包 + 验包 + 生成最终准备报告”：
|
|
|
|
```powershell
|
|
powershell -ExecutionPolicy Bypass -File .\prepare_final_release.ps1
|
|
```
|
|
|
|
如需快速查看当前最新交付物：
|
|
|
|
```powershell
|
|
powershell -ExecutionPolicy Bypass -File .\show_latest_release.ps1
|
|
```
|
|
|
|
## 三、输出位置
|
|
|
|
打包后会生成：
|
|
|
|
- `release/domaincheck_release_时间戳/`
|
|
- `release/domaincheck_release_时间戳.zip`
|
|
- `release/domaincheck_release_时间戳.sha256.txt`
|
|
- `release/latest_release.txt`
|
|
- `release/latest_release.json`
|
|
- `release/final_release_report.json`
|
|
|
|
## 四、当前会包含的内容
|
|
|
|
- `docs/`
|
|
- `scripts/`
|
|
- `domain-api/`
|
|
- `app`
|
|
- `deploy`
|
|
- `README.md`
|
|
- `requirements.txt`
|
|
- `.env.example`
|
|
- `domain-web/`
|
|
- `src`
|
|
- `deploy`
|
|
- `README.md`
|
|
- `package.json`
|
|
- `package-lock.json`
|
|
- `tsconfig`
|
|
- `vite.config.ts`
|
|
- `.env.example`
|
|
- `.env.production.example`
|
|
- 若存在则带上 `dist`
|
|
|
|
同时会生成：
|
|
|
|
- `release_manifest.json`
|
|
- `README_RELEASE.txt`
|
|
- `smoke_test_report.json`
|
|
- 若打包时本机 Web/API 正常运行，则自动生成并随包带出
|
|
- `.sha256.txt`
|
|
- 用于校验 zip 交付包完整性
|
|
|
|
## 五、建议使用顺序
|
|
|
|
1. 先阅读 `docs/08_domainCheck_交付说明.md`
|
|
2. 查看 `release_manifest.json`
|
|
3. 查看 `smoke_test_report.json`
|
|
4. 核对 `.sha256.txt`
|
|
或执行：
|
|
|
|
```powershell
|
|
powershell -ExecutionPolicy Bypass -File .\verify_domain_release.ps1
|
|
```
|
|
|
|
5. Windows 联调先跑 `scripts/smoke_test_stack.ps1`
|
|
6. Linux 部署前阅读：
|
|
- `docs/05_domainCheck_Linux部署清单.md`
|
|
- `docs/07_domainCheck_WebLinux发布验收清单.md`
|
|
- `domain-api/deploy/linux/README.md`
|
|
|
|
## 六、说明
|
|
|
|
当前打包内容偏向“交付部署包”和“源代码归档包”，不包含：
|
|
|
|
- `node_modules`
|
|
- Python 虚拟环境
|
|
- 临时运行日志
|
|
- 数据库数据本体
|
|
|
|
这样更适合交付、存档和迁移。
|
|
|
|
`latest_release.txt / latest_release.json` 用于快速定位“当前最新一份交付包”，避免人工翻目录。
|
|
|
|
`final_release_report.json` 用于记录最近一次“打包 + 验包”的最终状态。
|