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 のデプロイログ
Zeabur CLI の実行には、必ず
npx zeabur@latestを使用してください。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/アップロードサービスで、--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 logs ではなく deployment log です |
| サービスの状態を確認する | SERVER STARTED、Ready、listening を探してください |
ログから問題を診断した後、必要に応じて zeabur-restart スキルを使用してサービスを再起動してください。
コメント
Markdown 対応