关于 zeabur-deployment-logs
zeabur-deployment-logs 使用 Zeabur CLI 获取服务部署日志,面向排查服务问题的用户。涵盖运行时和构建日志,并说明自动定位最新部署或指定部署的方式。
主要功能
- 01获取运行时日志
- 02获取构建日志
- 03自动定位最新部署
- 04指定某次部署
- 05筛选或截取日志输出
适用场景
- 01检查服务近期运行输出
- 02排查构建失败
- 03查看指定部署的日志
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ zeabur/ agent-skills --skill zeabur-deployment-logs安装后在 Claude Code 中输入/zeabur-deployment-logs确认已加载。
详细介绍
Zeabur 部署日志
**始终使用
npx zeabur@latest调用 Zeabur CLI。**切勿直接使用zeabur或通过其他安装方式使用。如果没有npx,请先安装 Node.js。
工作流
# 1. Get service ID (use the `zeabur-service-list` skill)
npx zeabur@latest service list --project-id <project-id> -i=false
# 2. View runtime logs
npx zeabur@latest deployment log --service-id <service-id> -t runtime -i=false 2>&1 | tail -50
日志类型
# Runtime logs (CLI auto-resolves the latest deployment if needed)
npx zeabur@latest deployment log --service-id <id> -t runtime -i=false
# Runtime logs for a specific deployment
npx zeabur@latest deployment log --service-id <id> --deployment-id <deployment-id> -t runtime -i=false
# Build logs (CLI auto-resolves the latest deployment if needed)
npx zeabur@latest deployment log --service-id <id> -t build -i=false
# Build logs for a specific deployment
npx zeabur@latest deployment log --deployment-id <deployment-id> -t build -i=false
# Watch logs (live tail)
npx zeabur@latest deployment log --service-id <id> -w -i=false
DeploymentID 行为
如果未提供 --deployment-id,CLI 会自动解析最新部署:
| 场景 | 结果 |
|---|---|
Git/Upload 服务,未提供 --deployment-id | CLI 自动解析最新部署 → 返回日志 |
| 纯镜像服务(例如 Docker 镜像),运行时日志 | 不存在部署 → 回退到预构建查询 → 返回日志 |
| 纯镜像服务,构建日志 | 不存在部署 → 返回错误(镜像服务没有构建日志) |
已提供 --deployment-id | 直接使用提供的 ID,不会自动解析 |
当你需要查看特定部署(而非最新部署)的日志时,请使用 --deployment-id。使用以下命令列出部署:
npx zeabur@latest deployment list --service-id <service-id> -i=false
提示
| 提示 | 详情 |
|---|---|
使用 tail -50 | 日志可能很冗长,可通过管道传给 tail 查看最近的条目 |
使用 grep 筛选 | `... 2>&1 |
| 注意单数形式 | 使用 deployment log,而非 deployment logs |
| 检查服务状态 | 查找 SERVER STARTED、Ready、listening |
根据日志诊断问题后,如果需要,请使用 zeabur-restart 技能重启服务。
评论
支持 Markdown