跳到主要内容

部署

API 是位于 src/main.ts 的 Deno 服务。文档站是位于 docs-site/ 的 Docusaurus 应用。

部署 API 到 Deno Deploy​

使用 Deno Deploy 控制台：

  1. 将仓库推送到 GitHub。
  2. 打开 Deno Deploy 控制台。
  3. 在你的组织下创建新应用。
  4. 选择 GitHub 仓库，或使用本地源码部署流程。
  5. 入口文件设置为 src/main.ts。
  6. 构建命令留空。
  7. 部署到生产环境。

也可以在当前目录使用新版 Deno Deploy CLI 创建并部署：

deno deploy create --org=<your-org-slug> --app=<your-app> --source=local --region=global --runtime-mode=dynamic --entrypoint=src/main.ts .
deno deploy --org=<your-org-slug> --app=<your-app> --prod .

部署文档站​

构建 Docusaurus：

cd docs-site
npm run build

如果需要让 canonical 和 Open Graph 链接使用生产域名，可以在构建时设置 SITE_URL：

SITE_URL=https://your-production-domain npm run build

静态产物会输出到：

docs-site/build

可以把这个目录部署到任意静态托管服务。

同域在线测试​

在线测试会把 API 基础地址填成当前页面域名。最佳体验是让文档站和 API 使用同一个域名，或者在前面放一个反向代理：

/docs      -> Docusaurus 文档站
/resolve   -> Deno API
/download  -> Deno API

如果文档站和 API 分开部署，用户仍然可以在在线测试里手动修改 API 基础地址。

部署后验证​

当前 API 基础地址正在读取当前页面域名...
/health
/resolve?url=https://v.douyin.com/2LjM6XJNEXQ/