40 lines
1.4 KiB
Markdown
40 lines
1.4 KiB
Markdown
# 部署手册
|
||
|
||
## 环境要求
|
||
|
||
- Windows 10/11 或 Windows Server，系统时区 `China Standard Time`
|
||
- Python 3.12、`uv`、Windows Task Scheduler
|
||
- 凭据由环境变量或外部密钥系统提供，不写入源码或清单
|
||
|
||
## 安装
|
||
|
||
```powershell
|
||
cd D:\gyxx-flow
|
||
uv sync --python 3.12 --extra test
|
||
$env:GYXX_DATA_ROOT = 'D:\gyxx-flow\var'
|
||
.\.venv\Scripts\python.exe -m gyxx_flow doctor --json
|
||
.\.venv\Scripts\python.exe -m pytest
|
||
```
|
||
|
||
不再配置任何 `GYXX_LEGACY_*_ROOT`。运行代码和资源随 `gyxx_flow` 包部署，
|
||
四个旧项目可以不挂载。商品模块需要独立配置时，可设置 `GYXX_PRODUCT_CONFIG`；
|
||
该变量只指向新部署的配置文件。
|
||
|
||
## 生成候选调度计划
|
||
|
||
```powershell
|
||
.\.venv\Scripts\python.exe -m gyxx_flow schedule plan `
|
||
--output D:\gyxx-flow\var\schedule-plan\candidate `
|
||
--start-date 2026-07-27 `
|
||
--python-executable D:\gyxx-flow\.venv\Scripts\python.exe
|
||
```
|
||
|
||
输出包含 21 个 XML、`install.ps1`、`plan.json` 和 `drift.json`。生成计划不会
|
||
注册任务。只有生产门禁通过并获得明确授权后，才能人工审阅并逐个使用
|
||
`install.ps1 -Apply -WorkflowId <id>`；安装器强制一次只处理一个任务。
|
||
|
||
## 可迁移部署
|
||
|
||
复制项目或安装 wheel 后，只需重新设置 `GYXX_DATA_ROOT` 和凭据。禁止在生产任务
|
||
命令中出现旧项目盘符、用户目录解释器或旧项目工作目录。
|