mcpField
Z
zeabur-deployment-logs

zeabur-deployment-logs

github.com/zeaburクラウド・DevOps39198 回インストール7 週間前に更新
リポジトリ

zeabur-deployment-logs について

zeabur-deployment-logsは、Zeabur CLIでサービスのデプロイログを取得するスキルです。ランタイムとビルドのログを扱い、最新デプロイの自動解決や特定デプロイの指定方法も説明します。

主な機能

  1. 01ランタイムログの取得
  2. 02ビルドログの取得
  3. 03最新デプロイの自動解決
  4. 04特定デプロイの指定
  5. 05ログ出力の絞り込みや末尾表示

活用シーン

  1. 01サービスの直近の実行内容を確認
  2. 02ビルド失敗の調査
  3. 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 スキルを使用してサービスを再起動してください。

コメント