Jamdesk Documentation logo

监控构建

实时跟踪构建进度,了解每个构建阶段,阅读结构化构建日志,并在 Jamdesk 仪表板构建页面中诊断失败原因。

每次构建都会经历从排队到上线的几个阶段。请在 Deployments 标签页中监控进度。

构建阶段

1
排队中

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

2
克隆

从 GitHub 拉取你的仓库内容。

3
验证

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

4
处理

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

5
构建

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

6
部署

上传到 CDN 并清除缓存。

7
已上线

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

查看构建状态

仪表板概览

项目的主页面显示:

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

构建详情

点击任意构建可查看:

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

警告和建议

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

  • 警告(橙色标记):值得修复的问题,例如失效链接或缺失资源。它们不会导致构建失败。
  • 建议(灯泡图标):关于站点品牌和 SEO 的可选优化,例如添加网站图标、描述或徽标。建议仅出现在你最新完成的构建中,不计入警告标记。Jamdesk 从不通过邮件发送这些建议。

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 提醒你:

电子邮件

在 Settings → Notifications 中启用构建失败提醒。

Slack

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

构建历史

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

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

取消构建

要取消正在运行的构建:

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

之前成功的构建仍保持在线。

相关文章

Fix with AI

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

触发构建

手动或推送时启动构建

构建故障排除

修复失败的构建