打包由框架的 fr-build 负责,上线由部署机上的计划任务负责。以前那套 Gitea Actions 流水线(CI / Deploy Server / Build Client / Sync Docs 四个 job、两台 runner)随旧仓库退役了。
1. 打包目标:build.json
{
"targets": {
"web": { "kind": "creator", "platform": "web-mobile",
"before": ["sync-client-shared --check", "client/version"],
"after": ["build/web-version", "build/web-packs"] },
"server": { "kind": "script", "pool": "docker", "entry": "scripts/build/server.mjs" }
},
"notify": { "when": "deploy" }
}
(示意,真实文件里是完整的命令数组。)
- web:在 Windows 打包机上用 Creator 命令行打 web-mobile。打之前查共享代码没过期、算版本号;打完写版本信息、合图片包。发成仓库的 Release(标签
web-<版本>,附件web.zip和构建信息),只留最新一个。 - server:在 cnb 的 Linux 节点上用
deploy/Dockerfile打镜像,推到仓库的制品库,标签是完整提交号和latest。镜像不含网页。 - 发版要 web 和 server 一起打(仓库页面上的「打包全部」),原因见下面的部署规则。
改了 build.json 之后,node bootstrap/general/core/cli.mjs build pipeline --game idlehd 重新生成 .cnb.yml 和 .cnb/web_trigger.yml,不手改。仓库页面上有「打包全部」「打包 web」「打包 server」三个按钮,Agent 也可以用 cli.mjs build trigger --game idlehd --target all 触发。web 作业在打包机上会先把框架工作区快进到最新,再按 engine.json 准备引擎。
2. 版本号与更新公告
- 版本号
v<主.次>.<补丁>:主.次写在client/VERSION(现在是 0.0),补丁号 = 已有最大标签 + 1;重打同一个提交不跳号。 - 更新内容取
client/RELEASE_NOTES.md里上个版本以来新加的-行:游戏里的「更新公告」弹窗、部署后的群通知都用它。写法见 工作区与源码 。
3. 服务器镜像
- 基础镜像
node:24-alpine,只拷 core、client-logic、配表工具、配表和 server。 - 构建时跑全部测试,测试挂了镜像就出不来。提交号和构建时间这两个参数放在测试之后,免得每次都让测试那层缓存失效。
- 以
node用户运行,数据在卷/data,监听 8020;健康检查每 30 秒请求一次/idle/api/healthz。 - compose 里容器不发布端口:它和站点的 Caddy 在同一个 docker 网络里,Caddy 把
/idle/*原样转给它,证书和公网通路都和站点共用。内存上限 1 GB。
4. 部署:只在同一个提交时动手
部署机上的计划任务每 5 分钟跑一次 node scripts/deploy/idlehd.mjs --env-file <env 文件>(--check 只报告不改动):
- 取最新的 web Release 和制品库里最新的服务器镜像。两边不是同一个提交打出来的 → 报告
waiting,什么都不动。只打了一边、另一边还在路上时,线上不会出现「新网页配旧服务器」。 - 和本机正在跑的一样 → 跳过。
- 准备网页:下载
web.zip(核对大小和 sha256),先解压到.partial再改名成releases/<版本>/。 - 准备 CDN(开了的话,见下节)。CDN 没就绪就整个版本不部署。
- 换服务器:拉
server:<提交号>,docker compose up -d,等健康检查通过(最多 3 分钟)。 - 切网页:原子写
CURRENT(先写临时文件再改名);旧版本按时间清理,留几个。 - 删本机旧镜像,删制品库里别的标签(流水线的令牌没有删除权限,用框架的令牌删)。
- 发群通知:版本、提交、CDN 占用、更新内容、试玩链接。
build.json写了notify.when = deploy,所以打包成功时不发,真正上线了才发。通知失败不影响部署结果。
顺序是「先换服务器、健康检查过了再切网页」:新网页上线的那一刻,它要调的接口一定已经在了。
部署机上那份代码和框架都不会自动更新,改了部署脚本要去那边拉一下。env 文件(域名、密钥、网页目录)在部署机上,不进 Git。
5. 资源全部走 CDN
网页版的全部 bundle(包括引擎启动就要的 main、internal)都从 Cloudflare R2 的一个桶下。部署时:
- 把新版本的 bundle 同步进桶的
remote/<名字>/,入口页以外的网页文件(引擎脚本、样式)进web/。只传桶里没有或大小不同的,带哈希的文件设一年 immutable。 - 核对:重新列一遍对大小;再从公网地址抽查各 bundle 和引擎入口脚本,要求下得到、内容一致、CORS 放行本站的域名。
- 都过了才在版本目录写
cdn.json,然后才换服务器、切网页。 - 最后删掉桶里不属于当前版本的对象:桶里只留最新一版。
服务器看到 cdn.json 就改写引擎的设置文件:全部 bundle 远程、远程地址指向 CDN;入口页里带哈希的引用改指 CDN 的 web/;本服务器的 assets/、remote/ 一律 404,不退回本地下载。入口页 CSP 只多放行 CDN 这一个源。入口页本身和接口仍由游戏服务器给。
请求数方面:每个 bundle 的 import JSON 合成一个;图片合成图片包(见 客户端 ),CDN 上的文件数大约减半。
6. 本地开发
npm install
npm run ci # 提交前全绿
IDLE_DEV_AUTH=1 npm run dev:server # 本机开发登录,只在 localhost 允许
npm run sync:client # 改了 packages/ 之后同步进 Cocos 工程
Windows / Android 安装包的打包配置已经生成,但还没接入框架的打包流程;iOS 要 Mac 打包机,框架的打包池里留了 mac 这一类。