本仓库的 .github/workflows/rider-build.yml 接收
ltm0203/Knight-boss 的签名 rider-build-request,按请求 SHA 只读检出源码,
全量编译并制作 HostApi、SyncJob、Migrator、Vue、Uni-app H5 五个镜像。
这里不保存 Rider 源码副本、不做 PR 状态回写、不运行自动测试、不部署或执行数据库迁移。
工作流已在本仓库默认分支启用。 私有端也必须提交其 dispatcher、五个标准 Dockerfile 和公网 NuGet.Config, 才能从对应提交构建。请求发送成功不代表镜像已构建成功,实际结果查看本仓库 Actions。
| 位置 | 类型 / 名称 | 用途 |
|---|---|---|
| 私有 Rider | Secret PUBLIC_BUILDER_DISPATCH_TOKEN |
向本仓库发送 repository dispatch;Fine-grained PAT 按 GitHub API 要求授予目标仓库 Contents write,不授权私有源码或 Registry |
| 私有 Rider | Secret PUBLIC_BUILD_DISPATCH_HMAC_SECRET |
随机共享签名密钥,建议至少 32 字节 |
| 本仓库 | Secret RIDER_PRIVATE_SOURCE_PAT |
仅允许读取 Rider Contents 的 Fine-grained PAT;checkout 不持久保存凭据 |
| 本仓库 | Secret RIDER_DISPATCH_HMAC_SECRET |
与私有端 Rider HMAC 密钥相同 |
| 本仓库,可选推送 | Variable RIDER_IMAGE_REGISTRY |
Registry 主机,不带协议,如 registry.cn-chengdu.aliyuncs.com |
| 本仓库,可选推送 | Variable RIDER_IMAGE_REPOSITORY |
namespace/repository,如 yoyosoft/knightboss |
| 本仓库,可选推送 | Variable RIDER_IMAGE_USERNAME |
Registry 登录名 |
| 本仓库,可选推送 | Secret RIDER_IMAGE_PASSWORD |
Registry 推送凭据,仅 publish 步骤读取 |
可选群通知在本仓库配置 Actions Secrets RIDER_BUILD_NOTIFY_WEBHOOK 和
RIDER_BUILD_NOTIFY_SECRET,分别为钉钉机器人 Webhook 和加签密钥。已验签的构建
结束后按 分支验证、正式构建及推送的实际结果发一条通知。缺少配置时跳过,发送失败只记警告。
Markdown 消息区分通知时间和构建时间,提供源码仓库、触发人、提交与日志链接。失败消息区分版本镜像上传超时、普通上传失败和固定标签发布失败。版本镜像单次上传限时 12 分钟,失败后等 5 秒再试一次,上传步骤上限 26 分钟。正式部署由 171 的手动发布流程执行。
所有合法分支均可 push 构建;普通开发分支为 validate,不推送。PR 合并到 main(或直接 push main)自动使用 publish,编译成功后推送;手动执行仍可明确选择 validate/publish,publish 只允许 main。两端使用 git check-ref-format 校验分支格式,不维护名称白名单;tag 和分支删除不触发构建。目标公共仓库和来源私有仓库固定在代码中,不再配置仓库名 Secret。
yoyoboot-public-build/v6 使用七个 client_payload 直接字段:protocol、source_repository、
source_ref、source_sha、request、issued_at、signature。request 包含 build_mode、
source_actor、source_event。签名按协议、仓库、分支引用、提交号、构建模式、时间、
触发账号、触发事件的顺序,对每项追加换行后按 UTF-8 编码并计算 HMAC-SHA256/Base64。
构建范围固定为五个镜像。公共端也接收现有 Rider 分支发来的 v4 和 v5 请求,v4 通知省略发起人。
来源、签名、十分钟时间窗或 mode 不正确时,在 checkout 私有源码前失败。
过期请求从私有入口重新运行发送新签名;不要只重跑公共端旧请求。
- 公共 runner 将私有 Git 根检出到
source/;Docker context 为source/,Dockerfile 为source/src/.../Dockerfile。 - validate 和 publish 共用五服务构建矩阵。publish 由各构建作业上传版本镜像,使用文本制品交接实际 tag。五项成功后,独立发布作业更新固定 tag,失败时汇总已确认更新的固定 tag。
- validate 使用临时本地镜像;runner 结束后不保留镜像。publish 发布
<服务>_main固定标签,并同时保留<服务>_<私有SHA>-<公共run_id>-<attempt>版本标签;固定标签更新串行执行。等待发布期间如 main 已推进,则本次保留版本标签并跳过固定标签更新。构建缓存保留在 runner。 - 当前沿用阿里云仓库
registry.cn-chengdu.aliyuncs.com/yoyosoft/knightboss。推送不是部署,不改现有测试环境使用的 dev/fix-prod 标签。 - Uni-app 保留 NGINX_WAITHOST/NGINX_WAITPORT(默认 localhost:80)。官方 Nginx 的启动钩子复用 Rider 现有 wait-for-it.sh,在依赖 TCP 就绪后继续原 Nginx 启动流程。
- 保留源码 revision 和 Vue buildId。摘要记录实际构建与推送结果,镜像 digest 见推送日志。部署由 171 的手动发布流程执行。
- 首版只使用 runner 内 BuildKit 缓存,不向公开仓库导出包含私有源码层的构建缓存,不上传整个 checkout 或 Docker build record。
- 本仓库日志和摘要公开可见,启用前须确认公开范围;不要把真实凭据提交到任一仓库。
本地公共 checkout 为 D:/new-code/github/ltm0203/.github。工作流与脚本在私有 Rider 的
src/tools/public-build-runner/public-repository/ 维护,以同一批文件同步到本仓库。
私有触发仍位于 Rider 根 .github/workflows/request-public-build.yml。
从 Rider 的 src/ 核对同步和运行本地回归:
$publicRepo = 'D:/new-code/github/ltm0203/.github'
pwsh -File tools/public-build-runner/Sync-RiderPublicBuild.ps1 -PublicRepo $publicRepo -Check
python tools/public-build-runner/tests/test_public_build_runner.py --public-repo $publicRepo -v这组检查只验证签名收发、分支/推送边界和文件接线,不加入 push 流程,不能替代五镜像真实构建。
欢迎来到 yoyoboot/.github 仓库!
这个仓库用于存放 Yoyo Boot 组织的 GitHub 配置文件和模版。通过这个仓库,我们可以集中管理和维护组织的 GitHub 工作流程、Issue 模版、Pull Request 模版等。
该仓库包含以下内容:
- Issue 模版:用于标准化和简化问题报告流程。
- Pull Request 模版:用于规范代码合并请求,确保每个请求都包含必要的信息。
- GitHub Actions:自动化 CI/CD 工作流程,用于持续集成和部署。
- 其他配置文件:包括 CODEOWNERS、CONTRIBUTING 等文件,以帮助维护代码质量和项目协作。
-
克隆仓库:
git clone https://github.com/yoyoboot/.github.git
-
修改配置:根据项目需求修改相应的配置文件和模版。
-
提交更改:
git add . git commit -m "Update GitHub configurations" git push origin main
我们欢迎任何形式的贡献!如果你有任何建议或改进意见,请随时提交 Issue 或 Pull Request。
- Fork 这个仓库
- 创建一个新的分支 (
git checkout -b feature-branch) - 提交你的修改 (
git commit -am 'Add some feature') - 推送到分支 (
git push origin feature-branch) - 创建一个新的 Pull Request
如果你有任何问题或需要帮助,请通过以下方式联系我们:
感谢你对 Yoyo Boot 的支持!
版权所有 © 2025 Yoyo Boot. 保留所有权利。# .github
2026-11-16:Rider 已从本地构建矩阵退出 FengShenAuth,现保留 HostAPI、SyncJob、Migrator、Vue、Uni-app 五个镜像;签名触发及 main 发布规则不变。本轮尚未提交推送。