Jamdesk Documentation logo

监控构建

实时跟踪构建进度,了解各个构建阶段,查看结构化构建日志,并从 Jamdesk 仪表板的构建页面诊断失败原因。

每个构建都会从排队到上线经历多个阶段。你可以从 Deployments 标签页监控进度。

构建阶段

1
排队中

构建正在等待开始。大多数构建会在几秒内启动。

2
克隆中

正在从 GitHub 拉取你的仓库内容。

3
验证中

正在检查 docs.json 配置和 MDX 语法。

4
处理中

正在解析 MDX 文件并解析导入内容。

5
构建中

正在将 MDX 编译为 HTML,并应用语法高亮。

6
部署中

正在上传到 CDN 并清除缓存。

7
已上线

构建完成。你的文档已更新。

查看构建状态

仪表板概览

项目主页会显示:

  • 当前构建状态
  • 上次成功部署的时间
  • 最近的构建历史记录

构建详情

点击任意构建即可查看:

  • 开始和结束时间
  • 持续时间
  • 触发方式(推送、手动、CLI)
  • 提交哈希和消息
  • 完整构建日志

警告和建议

已完成的构建可能包含两级反馈:

  • Warnings(橙色徽章)— 值得修复的问题,例如链接失效或资源缺失。这些问题不会导致构建失败。
  • Suggestions(灯泡图标)— 针对网站品牌和 SEO 的可选优化,例如添加 favicon、描述或徽标。建议仅显示在最近一次已完成的构建中,不计入警告徽章,也不会通过电子邮件发送。

许多链接失效和描述缺失警告都可以自动修复。当最近一次构建包含可修复的问题时,使用 Fix with AI 查看并应用更改,无需手动编辑 MDX。

构建日志

详细日志有助于调试问题:

[12:34:56] Starting build...
[12:34:57] Cloning repository...
[12:34:59] Found docs.json at root
[12:35:00] Validating configuration...
[12:35:01] Processing 45 pages...
[12:35:15] Building search index...
[12:35:18] Deploying to CDN...
[12:35:22] Build complete!

构建通知

构建完成或失败时,Jamdesk 可以通过电子邮件或 Slack 向你发送提醒:

电子邮件

SettingsNotifications 中启用构建失败提醒。

Slack

连接 Slack,即可在你的频道中接收构建通知。请参阅 Slack 集成

构建历史

Deployments 标签页中查看最近 30 个构建:

  • 构建状态(成功、失败、已取消)
  • 持续时间
  • 触发类型
  • 提交信息

取消构建

要取消正在运行的构建:

  1. 转到 Deployments 标签页
  2. 找到正在运行的构建
  3. 点击 Cancel

上一次成功的构建会继续保持上线状态。

相关文章

使用 AI 修复

自动修复链接失效和描述缺失问题

触发构建

手动触发构建或在推送时触发

构建故障排除

修复失败的构建