附录 B 部署与配置速查
附录 B 部署与配置速查
收拢部署、升级、运维的常用命令与配置要点，按场景组织。端口、环境变量名与命令形态为示意写法，逐项以官方文档为准；标注（官方口径）的条目出自官方 README。
一、容器与进程角色
| 容器/进程（示意名） | 职责 | 健康关键点 |
|---|---|---|
| migration | 数据库结构迁移，升级时最先启动 | 迁移日志与退出码（第 11.2 节） |
| backend | HTTP API 与前端服务 | 请求延迟、错误率（第 2.1 节） |
| trading-worker | 交易长循环与策略运行时 | 订单延迟、对账一致（第 2.1 节） |
| scheduler-worker | 定时调度 | 调度延迟、漏跑（第 2.1 节） |
| celery-worker / celery-beat | 异步任务与定时触发 | 队列深度、任务耗时（第 2.1 节） |
| PostgreSQL 18 | 主数据库（官方技术栈口径） | 备份三要素（第 11.2 节） |
| Redis 8 | 队列与缓存（官方技术栈口径） | 可重建，明确不备份（第 11.2 节） |
| Prometheus / Grafana | 可观测层（官方口径） | 三类关键指标红绿灯（第 11.1 节） |
二、部署命令
# bash —— 部署与日常操作（写法示意，以官方文档为准） # 一键安装（第 1.1 节）：克隆仓库后由 Docker Compose 拉起全套服务 git clone <官方仓库地址> && cd QuantDinger docker compose up -d # 查看各容器状态与最近日志 docker compose ps docker compose logs -f --tail=100 trading-worker # 源码部署（第 1.2 节）：装依赖、初始化配置、按进程分别启动 python -m venv .venv && source .venv/bin/activate pip install -r requirements.txt cp config/example.yaml config/local.yaml # 配置模板（文件名示意）
三、升级四步速查（第 11.2 节）
# bash —— 升级固定次序：预检 → 冻结备份 → 先 migration → 滚动重启 # 1. 预检：记下当前版本号（回滚锚点），核对 PG 18 / Redis 8 兼容矩阵 git rev-parse HEAD > /backup/version_before_upgrade.txt # 2. 冻结与备份：暂停开新仓（联动应急开关），做升级前备份 pg_dump -Fc -d quantdinger -f /backup/pre_upgrade.dump # 3. 迁移：只启动 migration，成功（退出码 0）才继续 docker compose run --rm migration # 4. 滚动重启：backend → 数据/调度 → trading-worker 最后恢复交易 docker compose up -d backend scheduler-worker celery-worker celery-beat docker compose up -d trading-worker
四、备份与恢复速查（第 11.2 节）
# bash —— 备份、校验、恢复三件套（写法示意） # 每日全量 + 校验和（cron 调度） pg_dump -Fc -d quantdinger -f /backup/qd_$(date +%F).dump sha256sum /backup/qd_$(date +%F).dump > /backup/qd_$(date +%F).sha256 # 恢复到隔离环境（演练或事故恢复，计时） time pg_restore -d quantdinger_drill -c /backup/qd_latest.dump # 演练三验证：成交记录数对账 / 第 5.3 节对账逻辑 / on_start 预热出值
五、环境变量与配置分类
| 分类 | 代表变量（示意名） | 说明 |
|---|---|---|
| 服务端点 | DB_HOST / REDIS_URL / BACKEND_PORT | 端口以官方文档为准，不暴露公网（第 1.3 节） |
| 凭据 | 交易所 API_KEY / API_SECRET | 只开交易权限、禁提现（第 8.1 节） |
| 决策门 | JEV_ENDPOINT / JEV_TIMEOUT / FAIL_MODE | 决策服务地址、超时与 fail-open/closed 选择（第 9.2 节） |
| Agent | AGENT_TOKEN_SCOPE / AGENT_PAPER_ONLY | 作用域 token 分级，paper 默认开（第 10.1 节） |
| 可观测 | PROMETHEUS_RETENTION / GRAFANA_ADMIN | 指标保留期与面板管理（第 11.1 节） |
六、应急操作速查（第 10.3 节）
| 状况 | 第一动作 | 对应开关（名称以官方文档为准） |
|---|---|---|
| 策略异常开仓 | 停止接受新开仓意图 | 停新单开关 |
| 挂单失控 | 全部撤单 | 撤单开关 |
| 需要清空敞口 | 按预案平仓（先人工确认） | 平仓开关 |
| 数据源损坏 / 决策失灵 | 切断交易外联 | 断网熔断 |
配套纪律：开关触发前先看 11.1 的红绿灯定位问题；每月一次停新单演练；每次触发写事件记录。
提醒：本速查的命令与变量名均为教学示意，落地前逐条对照官方 README 与 config 模板；升级与应急操作务必先在 paper 环境走一遍。
评论区
(0)
U