mcloud-deployments

Cloud CLI：デプロイコマンド

mcloud deployments コマンドを実行して、デプロイとそのビルドログを確認します。

制約

• 出力を解析する際は、必ず --json を指定してください。プレーンテキスト形式は変更される場合があります。
• 組織／プロジェクトがすでに判明していない場合は、コマンドを実行する前に必ずコンテキスト（mcloud whoami --json）を確認してください。
• --deployment には depl_* 形式の ID またはビルド ID を指定してください。ビルド ID は最新のデプロイに自動的に解決されます。

コマンド

deployments list

プロジェクトの最近のデプロイを一覧表示します（デフォルト：すべての環境で直近の 20 件）。

mcloud deployments list --organization <org-id> --project <project-id-or-handle> --json

オプション：

• -o/--organization <id> — 組織 ID（アクティブなコンテキストにフォールバックします）
• -p/--project <id-or-handle> — プロジェクト ID またはハンドル（アクティブなコンテキストにフォールバックします）
• -e/--environment <handle> — 環境ハンドルで絞り込みます
• --environment-type <production|long-lived|preview> — 環境タイプで絞り込みます
• --commit <sha> — Git コミット SHA（全体またはプレフィックス）で絞り込みます
• --limit <1-200> — 最大件数（デフォルト：20）
• --offset <number> — ページネーションのオフセット（デフォルト：0）
• --json — JSON 形式で出力します

deployments get

ID を指定して、単一のデプロイの詳細を取得します。

mcloud deployments get <deployment-id> --organization <org-id> --project <project-id-or-handle> --json

引数：

• deployment — デプロイ ID（必須）

オプション：

• -o/--organization <id>、-p/--project <id-or-handle>、--json

deployments build-logs

デプロイのビルドログを取得します。build-failed ステータスのデバッグに使用してください。

mcloud deployments build-logs <deployment-id> --organization <org-id> --project <project-id-or-handle>

引数：

• deployment — デプロイ ID（必須）

オプション：

• -o/--organization <id>、-p/--project <id-or-handle>
• --type <backend|storefront> — 読み込むビルドログのストリーム（デフォルト：backend）
• --json — JSON 形式で出力します

デプロイのステータス

ステータス	意味
created	ビルドはまだ開始されていません
building	ビルドを実行中です
built	ビルドに成功し、ロールアウトを待っています
deploying	環境にロールアウトしています
deployed	公開され、トラフィックを処理しています
build-failed	ビルド手順に失敗しました — build-logs を確認してください
deployment-failed	ビルドには成功しましたが、ランタイムがクラッシュしました — mcloud logs を確認してください
timed-out	制限時間を超過しました（バックエンドのみ）
canceled	新しいデプロイに置き換えられました
idle	アクティブなデプロイではなくなりました

例

# List all deployments (with active context set)
mcloud deployments list --json

# Find most recent build-failed deployment
mcloud deployments list --json \
  | jq -r '[.[] | select(.backend_status == "build-failed")][0].id'

# Get deployment details
mcloud deployments get bld_01ABC123 --json

# Read backend build logs
mcloud deployments build-logs bld_01ABC123

# Read storefront build logs
mcloud deployments build-logs bld_01ABC123 --type storefront

# Filter deployments by commit SHA
mcloud deployments list --commit a1b2c3d --json | jq '.'

# Get deployments for a specific environment
mcloud deployments list --environment production --json