Deploy Release System

Weline_Deploy 部署发布系统

命中关键词：Weline_Deploy、deploy:release、deploy:webhook:setup、webhook_secret、~wh~、DeployWebhookRouteService、Controller/Router.php、Gitee/GitHub Webhook。

核心原则

1. 公网 Webhook URL 为随机路径：https://<域名>/~wh~<32位hex>，由 deploy:webhook:setup 生成；禁止使用 /deploy 等常见路径。
2. 路由匹配走模块 Router：app/code/Weline/Deploy/Controller/Router.php 实现 RouterInterface，在 Weline_ModuleRouter 阶段用 ~wh~ 前缀短路后 hash_equals，将 $path 改写为内部 deploy/webhook/deploy（非 Nginx 别名、非独立 PHP 入口）。
3. 访问密码：后台 webhook_secret = Git 平台 Secret/密码。
4. 架构：Git → Nginx → WLS → ModuleRouter(Router.php) → deploy/webhook/deploy → webhook.sh。
5. 分仓口令「分仓」→ CI发布工程师-分仓发布。
6. 分项口令「分项」→ CI发布工程师-分项更新。

ModuleRouter 与本模块（必读）

修改随机路径后须 DeployWebhookRouteService::clearCache()（setup 保存时已调用）。
不要为 Webhook 单独加 Nginx location 或 routes.xml。
通用 ModuleRouter 约定见 框架核心工程师-路由事件与扩展。

CLI

php bin/w command:upgrade -m Weline_Deploy

# 首次：随机路径 + 密钥
php bin/w deploy:webhook:setup --base-url=https://www.example.com

# 轮换密钥 + 路径
php bin/w deploy:webhook:setup --force -y --base-url=https://www.example.com

# 仅轮换路径
php bin/w deploy:webhook:setup --rotate-path -y --base-url=https://www.example.com

输出含：公网路径、webhook_secret、完整 Webhook URL、版本 URL、curl 示例。

鉴权

• Authorization: Bearer <webhook_secret>（推荐）
• X-Gitee-Token、X-Hub-Signature-256、?token=
• GET <webhook_url>?health=1 无需密码

生产 Nginx

全站反代 WLS 即可；公网路径由 ModuleRouter 处理，无需为 ~wh~ 单独配 location。

location / {
    proxy_pass http://127.0.0.1:9501;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-Proto $scheme;
}

触发模式

deploy_trigger_mode：branch | tag | both。过滤：webhook_branch、webhook_tag_prefix。

参考资料

排错