跳到主要内容
版本：Current

生产部署

文档站 不经过主服务器 Nginx。站点使用 Cloudflare Workers Static Assets 托管 Docusaurus 构建产物，Worker 名称见 wrangler.jsonc 中的 bucssa-documentation。主服务器上的 /root/BUCSSA-Documentation 只是源码检出，改文档后需按下面命令发布到 Cloudflare。组织级入口见 基础设施概览。

部署命令​

npm run deploy

等价于：

npm run build && wrangler deploy

首次配置 Wrangler​

  1. 登录 Cloudflare：

    npx wrangler login

  2. 确认 wrangler.jsonc 中 name 与 assets.directory 正确

  3. 执行部署：

    npm run deploy

  4. 在 Cloudflare Dashboard 绑定自定义域名（若需要）

CI/CD 建议​

可在 GitHub Actions 中：

  1. npm ci
  2. npm run build
  3. npx wrangler deploy（使用 CLOUDFLARE_API_TOKEN secret）

推送 main 分支后自动发布，避免本地环境差异。

部署前检查清单​

  • npm run build 本地通过
  • docusaurus.config.ts 中 url 为生产域名
  • 无敏感信息写入文档或配置
  • 新版本文档如需归档，已更新 versioned_docs/ 与 versions.json

回滚​

  • Cloudflare Dashboard 中查看 Workers 部署历史，回滚至上一版本
  • 或 checkout 上一 git tag / commit 后重新 npm run deploy

风险提示​

⚠️ 生产部署会立即覆盖线上静态资源。重大文档结构调整前，建议先在 PR 预览环境或本地 npm run serve 完整走查。