126 lines
2.5 KiB
Markdown
126 lines
2.5 KiB
Markdown
# 内容仓库更新自动触发构建 - 快速参考
|
|
|
|
## 🎯 问题
|
|
|
|
启用内容分离后,内容仓库 (Mizuki-Content) 更新不会自动触发代码仓库 (Mizuki) 的重新部署。
|
|
|
|
## ✅ 解决方案 (推荐)
|
|
|
|
使用 **Repository Dispatch** 让内容更新时自动触发构建,适用于所有部署平台。
|
|
|
|
---
|
|
|
|
## 📝 5 步快速配置
|
|
|
|
### Step 1: 创建 GitHub Token
|
|
|
|
访问: https://github.com/settings/tokens
|
|
|
|
- 点击 **Generate new token (classic)**
|
|
- Note: `Mizuki Content Trigger`
|
|
- Scopes: 勾选 ✅ `repo`
|
|
- 点击生成并**复制 Token** ⚠️ (只显示一次)
|
|
|
|
### Step 2: 添加 Secret
|
|
|
|
在**内容仓库** (Mizuki-Content):
|
|
|
|
Settings → Secrets and variables → Actions → New repository secret
|
|
|
|
- Name: `DISPATCH_TOKEN`
|
|
- Secret: 粘贴刚才的 Token
|
|
|
|
### Step 3: 修改触发器配置
|
|
|
|
编辑内容仓库的 `.github/workflows/trigger-build.yml`
|
|
|
|
找到第 27 行,修改为你的代码仓库:
|
|
|
|
```yaml
|
|
repository: your-username/Mizuki # 改为你的
|
|
```
|
|
|
|
例如: `matsuzaka-yuki/Mizuki`
|
|
|
|
### Step 4: 更新代码仓库工作流
|
|
|
|
编辑**代码仓库**的 `.github/workflows/deploy.yml`
|
|
|
|
在 `on:` 部分添加:
|
|
|
|
```yaml
|
|
on:
|
|
push:
|
|
branches:
|
|
- main
|
|
repository_dispatch: # 👈 添加这个
|
|
types:
|
|
- content-updated
|
|
workflow_dispatch:
|
|
```
|
|
|
|
### Step 5: 测试
|
|
|
|
在内容仓库推送一次:
|
|
|
|
```bash
|
|
git add .
|
|
git commit -m "test: trigger build"
|
|
git push
|
|
```
|
|
|
|
查看:
|
|
1. 内容仓库 Actions - 确认触发器运行
|
|
2. 代码仓库 Actions - 确认部署被触发
|
|
|
|
---
|
|
|
|
## 🔍 故障排查
|
|
|
|
### Token 问题
|
|
|
|
**错误**: `Bad credentials`
|
|
|
|
**解决**:
|
|
- 确认 Token 复制完整
|
|
- 确认 Token 有 `repo` 权限
|
|
- 重新生成 Token
|
|
|
|
### 仓库名称问题
|
|
|
|
**错误**: `Not Found`
|
|
|
|
**解决**:
|
|
- 确认格式: `owner/repo` (用斜杠分隔)
|
|
- 确认拼写正确
|
|
- 示例: `matsuzaka-yuki/Mizuki`
|
|
|
|
### 代码仓库未触发
|
|
|
|
**检查**:
|
|
- [ ] `.github/workflows/deploy.yml` 包含 `repository_dispatch`
|
|
- [ ] Event type 为 `content-updated`
|
|
- [ ] 代码仓库 Actions 已启用
|
|
|
|
---
|
|
|
|
## 📚 详细文档
|
|
|
|
需要更多配置选项? 查看:
|
|
- [部署指南 - 完整说明](./DEPLOYMENT.md#内容仓库更新触发构建) - 包含 Webhook、定时构建等其他方案
|
|
- [内容仓库配置指南](../Mizuki-Content/.github/workflows/README.md) - 工作流详细说明
|
|
|
|
---
|
|
|
|
## 💡 提示
|
|
|
|
配置成功后:
|
|
- ✅ 内容仓库每次推送都会自动触发部署
|
|
- ✅ 可在 Actions 页面查看触发历史
|
|
- ✅ 支持手动触发 (workflow_dispatch)
|
|
|
|
---
|
|
|
|
**配置时间**: 约 5 分钟
|
|
**一次配置,长期有效** ✨
|