mcloud-projects

Cloud CLI：プロジェクトコマンド

mcloud projects コマンドを実行して、Cloud プロジェクトを管理します。

制約

• projects delete は取り消せません。関連付けられたすべての環境、デプロイ、リソースが削除されます。削除する前に、必ずプロジェクト ID／ハンドルを確認してください。
• 対話形式ではないコンテキスト（スクリプト、パイプライン、エージェント）で delete を実行する場合は、--yes を使用してください。

コマンド

projects list

組織内のプロジェクトを一覧表示します。--organization を省略した場合（かつアクティブなコンテキスト組織が設定されていない場合）、アクセス権のあるすべての組織のプロジェクトを、組織ごとにグループ化して一覧表示します。

mcloud projects list --organization <org-id> --json

オプション：

• -o/--organization <id> — 組織 ID（アクティブなコンテキストにフォールバックします。設定されていない場合は、すべての組織を対象に一覧表示します）
• --json — JSON 形式で出力します

projects get

ID またはハンドルを指定して、単一のプロジェクトを取得します。

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

引数：

• project — プロジェクト ID またはハンドル（必須）

オプション：

• -o/--organization <id> — 組織 ID（アクティブなコンテキストにフォールバックします。必須）
• --json — JSON 形式で出力します

projects delete

ID またはハンドルを指定して、プロジェクトを削除します。取り消せません。

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

引数：

• project — プロジェクト ID またはハンドル（必須）

オプション：

• -o/--organization <id> — 組織 ID（アクティブなコンテキストにフォールバックします。必須）
• -y/--yes — 確認プロンプトをスキップします（対話形式ではないモードでは必須）
• --json — JSON 形式で出力します

プロジェクトのフィールド（JSON）

フィールド	説明
id	プロジェクト ID
handle	URL で使用できるプロジェクトハンドル（ほとんどのコマンドで使用）
name	表示名
status	正常な場合は ready
region	デプロイリージョン（例：us-east-1）
repository	リンクされた GitHub リポジトリ（owner/repo）
root_path	リポジトリ内のルートパス
organization	所有する組織（id、name、created_at）
environments	関連付けられた環境の配列（各環境には storefront_environments が含まれる場合があります）

例

# List all projects in an organization
mcloud projects list --organization org_123 --json

# Set context to a project by name
PROJECT_HANDLE=$(
  mcloud projects list --organization org_123 --json \
    | jq -r '.[] | select(.name == "My Store") | .handle'
)
mcloud use --project "$PROJECT_HANDLE"

# Get project details including environments
mcloud projects get my-store --organization org_123 --json

# List all environment handles for a project
mcloud projects get my-store --organization org_123 --json \
  | jq -r '.environments[].handle'

# Find project handle by name
mcloud projects list --organization org_123 --json \
  | jq -r '.[] | select(.name == "My Store") | .handle'

# Delete a project (irreversible — confirm before running)
mcloud projects delete old-project --organization org_123 --yes