发布目标

这个博客的发布目标很明确：主分支推送后自动构建，构建产物部署到 Cloudflare Pages，最终通过 blog.coratch.top 访问。

必要配置

发布链路需要几个关键配置：

  • GitHub 仓库保存源码和文章。
  • GitHub Secret 保存 CLOUDFLARE_API_TOKEN。
  • Cloudflare Pages 项目接收构建产物。
  • DNS 中为 blog.coratch.top 配置 CNAME。
  • 根域名使用 Cloudflare Nameserver 托管。

其中令牌只应该放在 GitHub Secret 或本地安全环境变量里，不应该提交到仓库。

构建命令

当前构建命令是：

npm run build

这个命令会先执行 Astro 类型检查，再生成静态文件。构建输出目录是 dist。

检查顺序

部署异常时可以按这个顺序排查：

  1. GitHub Actions 是否成功。
  2. Cloudflare Pages 是否收到最新部署。
  3. 自定义域名是否处于 Active 状态。
  4. DNS 记录是否指向 Pages 项目。
  5. 浏览器访问是否被缓存影响。

多数问题都能在这五步里定位到，不需要直接修改业务代码。

长期维护

发布链路稳定后，重点是减少人工步骤。域名和令牌不需要频繁变更，平时只保留写文章、推送、自动发布这条路径。