docs: add gitea webhook deploy plan

2026-01-26 15:25:23 +08:00
parent 42171c01db
commit b654265d96
1 changed files with 20 additions and 0 deletions
--- a/TODO.md
+++ b/TODO.md
@@ -34,6 +34,26 @@

 ### 高优先级

+- [ ] **Gitea Webhook 自动部署**
+  - Webhook 服务（Go 实现）
+    - 监听端口 9000，接收 Gitea POST 请求
+    - HMAC-SHA256 签名验证
+    - 仅处理 master/main 分支的 push 事件
+    - 执行部署脚本
+  - 部署脚本 (deploy.sh)
+    - `git pull origin master`
+    - `docker-compose up -d --build --remove-orphans`
+    - 自动清理旧镜像
+    - 健康检查验证
+  - docker-compose 配置
+    - webhook 服务定义
+    - 挂载 docker.sock 和项目目录
+    - 环境变量配置（WEBHOOK_SECRET）
+  - Gitea 仓库配置
+    - 添加 Webhook URL: `http://服务器IP:9000/webhook`
+    - 设置 Secret（与服务端一致）
+    - 选择 Push 事件，分支过滤 `refs/heads/master`
+
 - [ ] **SSE 实时状态推送**
  - 服务器实现 `/events` SSE 端点
  - 前端使用 EventSource 接收状态