监控构建
实时跟踪构建进度,了解每个构建阶段,阅读结构化构建日志,并在 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 次构建:
- 构建状态(成功、失败、已取消)
- 持续时间
- 触发类型
- 提交信息
取消构建
要取消正在运行的构建:
- 进入 Deployments 标签页
- 找到正在运行的构建
- 点击 Cancel
之前成功的构建仍保持在线。
