mcloud-environments

Cloud CLI：環境コマンド

mcloud environments コマンドを実行して、環境のライフサイクルとデプロイを管理します。

制約

• 本番環境は削除できません。 自動化で削除を試みる前に、必ず environments get --json で type を確認してください。
• 非対話型のコンテキストでは、破壊的な操作（delete）に --yes を使用してください。
• redeploy と trigger-build は相互に置き換えられません。修正内容に応じて適切な方を選んでください。

コマンド

environments list

プロジェクト内のすべての環境を一覧表示します。

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

オプション：

• -o/--organization <id> — 組織 ID（アクティブなコンテキストがあればそちらを使用します）
• -p/--project <id-or-handle> — プロジェクト ID またはハンドル（アクティブなコンテキストがあればそちらを使用します）
• --json — JSON 形式で出力します

environments get

ID またはハンドルで単一の環境を取得します。

mcloud environments get <environment-id-or-handle> --organization <org-id> --project <project-id-or-handle> --json

引数：

• environment — 環境 ID またはハンドル（必須）

オプション：

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

environments create

新しい長期稼働環境を作成します。

mcloud environments create \
  --organization <org-id> \
  --project <project-id-or-handle> \
  --name "Staging" \
  --branch develop \
  --json

オプション：

• -o/--organization <id>、-p/--project <id-or-handle>
• -n/--name <name> — 環境名（必須）
• -b/--branch <branch> — 追跡する Git ブランチ（必須）
• --custom-subdomain <subdomain> — 任意のカスタムサブドメイン
• --json — JSON 形式で出力します

environments delete

環境を削除します。本番環境は削除できません。

mcloud environments delete <environment-id-or-handle> \
  --organization <org-id> \
  --project <project-id-or-handle> \
  --yes

引数：

• environment — 環境 ID またはハンドル（必須）

オプション：

• -o/--organization <id>、-p/--project <id-or-handle>
• -y/--yes — 確認プロンプトをスキップします（非対話型モードでは必須）
• --json — JSON 形式で出力します

environments redeploy

アクティブなデプロイに対して既存のビルドを再実行します。修正が環境側のもの（変数の変更、インフラの問題）の場合に使用します。新しいビルドは開始しません。

mcloud environments redeploy <environment-id-or-handle> \
  --organization <org-id> \
  --project <project-id-or-handle> \
  --json

引数：

• environment — 環境 ID またはハンドル（必須）

オプション：

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

環境にアクティブなデプロイがあることが必要です。ない場合は、先に trigger-build を使用してください。

environments trigger-build

追跡対象のブランチから新しいビルドを開始します。修正がコミット済みのコードである場合に使用します。新しいデプロイが作成されます。

mcloud environments trigger-build <environment-id-or-handle> \
  --organization <org-id> \
  --project <project-id-or-handle> \
  --json

引数：

• environment — 環境 ID またはハンドル（必須）

オプション：

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

Redeploy と Trigger-Build の使い分け

コマンド	使用する状況
redeploy	修正が環境側のもの（変数の変更、インフラ設定）— 既存のビルドを再実行します
trigger-build	修正が追跡対象のブランチ上のソースコードにある — 新しいビルドを開始します

例

# List all environments
mcloud environments list --json

# Get environment details and check type before deleting
mcloud environments get staging --json | jq '{id, name, type, status}'

# Create a new environment tracking the develop branch
mcloud environments create --name "Staging" --branch develop --json

# Delete a non-production environment
mcloud environments delete staging --yes

# Redeploy after a variable change
mcloud environments redeploy production --json

# Trigger a fresh build from source
mcloud environments trigger-build production --json

# Find environment handles by name
mcloud environments list --json \
  | jq -r '.[] | select(.name == "Production") | .handle'

# Verify new build started
mcloud deployments list --environment production --limit 5 --json \
  | jq '.[] | {id, backend_status, updated_at}'