17 自动部署与 CI/CD

1. 两种部署模式

• Git 集成（Cloudflare Pages 控制台）：提交即触发构建
• CLI 直传（wrangler pages deploy）：适合手动发布或应急

2. GitHub Actions（推荐）

准备 Secrets：

• CLOUDFLARE_API_TOKEN
• CLOUDFLARE_ACCOUNT_ID

工作流文件：.github/workflows/deploy-pages.yml

3. 部署流程建议

• PR 分支：部署 Preview（便于评审）
• main 分支：部署 Production
• 部署后自动做 smoke check（HTTP 200）

4. 回滚策略

• 保留最近 N 次部署记录
• 若发现异常，回滚到上一版本部署 URL
• 回滚后补充问题复盘（原因/修复/防再发）

5. 常见失败

• Token 权限不足（Pages Edit/Account Read）
• 项目名不一致
• 构建目录错误（VitePress 应为 docs/.vitepress/dist）