监控构建
实时跟踪构建进度,了解各个构建阶段,查看结构化构建日志,并从 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 向你发送提醒:
电子邮件
在 Settings → Notifications 中启用构建失败提醒。
Slack
连接 Slack,即可在你的频道中接收构建通知。请参阅 Slack 集成。
构建历史
在 Deployments 标签页中查看最近 30 个构建:
- 构建状态(成功、失败、已取消)
- 持续时间
- 触发类型
- 提交信息
取消构建
要取消正在运行的构建:
- 转到 Deployments 标签页
- 找到正在运行的构建
- 点击 Cancel
上一次成功的构建会继续保持上线状态。
