SuperAPI AI 工具集

zeabur-deployment-logs

部署与运维

查看项目

更新于 10-15 12:00

技能介绍

Zeabur Deployment Logs 是 Zeabur 官方 agent-skills 提供的一项技能,用途是查看服务的运行时日志或构建日志。当用户需要查看日志、排查部署失败原因、检查构建输出或调试运行时错误时,可以使用该技能。

主要能力 该技能围绕 Zeabur CLI 的 deployment log 命令展开,支持以下日志查看方式:

  • 运行时日志:查看服务运行时的输出。
  • 构建日志:查看服务构建过程的输出。
  • 指定部署的日志:通过 --deployment-id 查看某个特定部署(而非最新部署)的运行时或构建日志。
  • 实时跟踪日志:通过 -w 参数持续跟踪(live tail)日志输出。

使用方式 技能明确要求:始终使用 npx zeabur@latest 来调用 Zeabur CLI,绝不要直接使用 zeabur 或任何其他安装方式。如果 npx 不可用,需要先安装 Node.js。

工作流程如下:

  1. 获取服务 ID(使用 zeabur-service-list 技能): npx zeabur@latest service list --project-id <project-id> -i=false

  2. 查看运行时日志: npx zeabur@latest deployment log --service-id <service-id> -t runtime -i=false 2>&1 | tail -50

日志类型对应的命令:

  • 运行时日志(CLI 在需要时自动解析最新部署): npx zeabur@latest deployment log --service-id <id> -t runtime -i=false
  • 指定部署的运行时日志: npx zeabur@latest deployment log --service-id <id> --deployment-id <id> -t runtime -i=false
  • 构建日志(CLI 在需要时自动解析最新部署): npx zeabur@latest deployment log --service-id <id> -t build -i=false
  • 指定部署的构建日志: npx zeabur@latest deployment log --deployment-id <id> -t build -i=false
  • 实时跟踪日志(live tail): npx zeabur@latest deployment log --service-id <id> -w -i=false

DeploymentID 行为 当未提供 --deployment-id 时,CLI 会自动解析最新部署,具体行为如下:

  • Git/上传类服务,未提供 --deployment-id:CLI 自动解析最新部署,返回日志。
  • 纯镜像服务(例如 Docker 镜像),运行时日志:不存在部署记录,回退到预构建查询,返回日志。
  • 纯镜像服务,构建日志:不存在部署记录,返回错误(镜像服务没有构建日志)。
  • 显式提供 --deployment-id:直接使用提供的 ID,不进行自动解析。

当需要查看某个特定部署(而非最新部署)的日志时,应使用 --deployment-id。可通过以下命令列出部署: npx zeabur@latest deployment list --service-id <service-id> -i=false

提示

  • 使用 tail -50:日志可能很长,可通过管道传给 tail 查看最近的条目。
  • 使用 grep 过滤:可结合 grep 筛选日志内容。
  • 注意单数:命令是 deployment log,不是 deployment logs。
  • 检查服务状态:可留意日志中的 SERVER STARTED、Ready、listening 等标志。
  • 在通过日志诊断问题后,如有需要,可使用 zeabur-restart 技能重启服务。

适用场景 适用于需要查看 Zeabur 服务运行时或构建日志、排查部署失败、检查构建输出、调试运行时错误,以及实时跟踪日志的场景。

限制 该技能要求必须通过 npx zeabur@latest 调用 CLI,不能直接使用 zeabur 或其他安装方式;若 npx 不可用需先安装 Node.js。纯镜像服务没有构建日志,查询构建日志会返回错误。关于收费、价格、平台支持范围等更多信息,资料中暂未提供。