5.5 KiB
sw2 Docker 部署
后端镜像发布至 harbor.fuhua91.com/game/sw2-backend:<版本>，前端镜像发布至 harbor.fuhua91.com/game/sw2:<版本>。发布服务器需先通过 docker login harbor.fuhua91.com 配置两个镜像仓库的 push/pull 权限；也可将本应用的 Docker 登录配置放在部署根目录的 harbor-docker/ 下，脚本优先使用该配置。脚本在替换容器前完成两个镜像的推送、拉取和摘要校验，并使用 Harbor 返回的摘要启动容器。前端独立发布入口位于前端仓库 deploy/，也支持直接指定 Harbor 版本拉取部署。
沿用 226 服务器 /www/wwwroot/live.fuhua91.com 的 Docker 网络、持久化目录和宝塔反向代理结构。使用独立的 sw2-backend、sw2-frontend、sw2-net，兼容服务器现有 Docker 18.06，不依赖 Compose。
目录与端口
部署根目录为 /www/wwwroot/sw2.fuhua91.com：
config/config.yaml：后端运行配置，挂载到/data/conf，UID 1000 可写。runtime.env：SDK 兼容参数，通过 Docker--env-file加载，权限 600。log/、uploads/：日志与文件持久化目录。releases/<commit>/：已校验的发布包；current-release记录当前版本。- 后端仅绑定
127.0.0.1:9602，前端仅绑定127.0.0.1:9601。 - 宝塔
sw2.fuhua91.com代理至 9601，前端容器将/api/转发至后端并去除前缀，支持 WebSocket、SSE 和文件上传。
数据库沿用已迁移并验证的 sw10，设置 admin.system.disable_auto_migrate: true，由部署前的独立迁移命令更新结构。平台别名为 lx/hw/yq/oa，其中三个 SDK 别名连接 game_lx/game_hw/game_yq 测试库，Redis 沿用当前关闭状态。生产配置使用 admin.app.env: production，关闭开发 Swagger。七条常规任务启用（四条商务/区服日汇总、预警检测、两条有效端刷新），两个历史回填停用。使用同一 sw10 时只运行一个调度实例，切换到服务器前停止本机的后端服务。
数据库迁移
新副本必须先完整复制旧商务数据库，再执行 旧框架转换 SQL，最后使用本次发布的后端执行全部增量迁移：
/app/kratos-admin -conf /data/conf/config.yaml -migrate
/app/kratos-admin -conf /data/conf/config.yaml -check-schema
框架转换 SQL 的 USE 默认指向 sw10，其他目标库需修改该行。-migrate 使用与服务相同的模块迁移目录，包含新表、字段、索引、权限及任务定义，完成检查后退出；不会启动 HTTP、定时任务或 SDK 连接。-check-schema 只读检查版本、必需表和字段、主键与索引。旧业务表缺失时应重新完成复制，不能用空表替代历史数据。
转换 SQL 和增量迁移必须全部执行。服务关闭自动迁移后，会在连接失败、版本未完成或结构缺失时明确报错，不进入初始化向导。新增迁移需同时更新模块结构检查与相邻回归测试。部署脚本在停止旧调度实例后自动运行 -migrate，全部检查通过才启动新服务。
旧库 tab_promote.id 的 INT 自增容量由增量迁移扩大为同符号 BIGINT，保留现存 ID、自增高水位、关联数据与注释。渠道、玩家、流水等可能变大的旧业务 ID 在 JSON 和 Excel 中使用文本，请求兼容十进制字符串；不降低自增值或重新编号。
构建与发布
Windows 本机安装 Go、Node、pnpm、tar，先提交源代码，再执行：
.\deploy\docker\build-package.ps1
输出位于 .cache/deploy/sw2-<commit>.tar.gz 及对应 SHA-256 文件。后端交叉编译为 Linux amd64，前端执行生产构建；包内只含二进制、前端产物、Dockerfile 和部署配置，真实运行配置及环境变量不进入镜像或 Git。
通过 SSH 将包上传到 226，校验 SHA-256 后解压到 releases/<commit>/。首次部署另行准备上述私有配置文件，保持 admin.router_prefix 为空，并确认主库为 sw10。SDK 环境变量名称为 SW_SDK_AUTH_CODE、SW_SDK_MIGRATE_AUTH_CODE、SW_SDK_TABLE_PREFIX，值从已有私有运行配置取得。
bash /www/wwwroot/sw2.fuhua91.com/releases/<commit>/deploy.sh <commit> --build-only
# 构建和容器配置检查通过后，停止连接同一 sw10 的本机后端。
bash /www/wwwroot/sw2.fuhua91.com/releases/<commit>/deploy.sh <commit>
脚本先构建和检查镜像，再停止当前受管容器，保留一份停止的 -previous 容器。迁移或健康检查失败时恢复前一组容器。配置、上传文件和数据库不随镜像替换；索引在独立迁移容器中按版本执行。
迁移不设置总等待时限，日志记录每一步的名称、结果和耗时；耗时索引完成前不会启动业务服务。业务容器退出或重启时立即回退。切换数据库前需备份运行配置；镜像回退不会自动还原数据库连接配置或撤销已执行的数据库迁移，回退版本需兼容当前结构和迁移版本。
首次接入域名时，备份宝塔原站点配置，再安装 bt-nginx-sw2.fuhua91.com.conf 至 /www/server/panel/vhost/nginx/，执行 /www/server/nginx/sbin/nginx -t 通过后重载。模板保留证书验证目录，当前监听 HTTP；后续由宝塔为 sw2 单独配置匹配域名的证书。
验证首页、静态资源、/api/health、登录状态、商务接口和任务启停/执行日志。回退版本可执行 bash /www/wwwroot/sw2.fuhua91.com/deploy.sh <旧commit>；数据库迁移及业务数据不由镜像回退脚本撤销。