---
name: Mcloud Deployments
slug: mcloud-deployments
category: DevOps
description: Mcloud Deployments executes mcloud commands to list deployments, inspect deployment details, and fetch build logs. Use it to check status, filter by environment or commit, and debug build failures.
github: "https://github.com/medusajs/medusa-agent-skills/tree/main/plugins/medusa-cloud/skills/mcloud-deployments"
language: JavaScript
stars: 212
forks: 26
install: "npx degit https://github.com/medusajs/medusa-agent-skills/tree/main/plugins/medusa-cloud/skills/mcloud-deployments ~/.claude/skills/mcloud-deployments"
installs_to: ~/.claude/skills/mcloud-deployments
source_path: plugins/medusa-cloud/skills/mcloud-deployments/SKILL.md
collection_size: 18
category_size: 920
collection_url: "https://dirskills.com/collections/medusajs/medusa-agent-skills"
added: 2026-09-04T05:26:08.732Z
last_synced: 2026-09-04T05:26:08.732Z
canonical_url: "https://dirskills.com/skills/mcloud-deployments"
---

# Mcloud Deployments

Mcloud Deployments executes mcloud commands to list deployments, inspect deployment details, and fetch build logs. Use it to check status, filter by environment or commit, and debug build failures.

**Install:**

```bash
npx degit https://github.com/medusajs/medusa-agent-skills/tree/main/plugins/medusa-cloud/skills/mcloud-deployments ~/.claude/skills/mcloud-deployments
```

## README

# Cloud CLI: Deployments Commands

Execute `mcloud deployments` commands to inspect deployments and their build logs.

## Constraints

- Always pass `--json` when parsing output — plaintext format may change.
- Always confirm context (`mcloud whoami --json`) before running commands if org/project are not already known.
- Use `--deployment` IDs in the format `depl_*` or build IDs; build IDs resolve to their latest deployment automatically.

## Commands

### deployments list

List recent deployments for a project (default: 20 most recent across all environments).

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

**Options:**
- `-o/--organization <id>` — Organization ID (falls back to active context)
- `-p/--project <id-or-handle>` — Project ID or handle (falls back to active context)
- `-e/--environment <handle>` — Filter by environment handle
- `--environment-type <production|long-lived|preview>` — Filter by environment type
- `--commit <sha>` — Filter by Git commit SHA (full or prefix)
- `--limit <1-200>` — Max results (default: `20`)
- `--offset <number>` — Pagination offset (default: `0`)
- `--json` — Output as JSON

### deployments get

Retrieve a single deployment's details by ID.

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

**Arguments:**
- `deployment` — Deployment ID (required)

**Options:**
- `-o/--organization <id>`, `-p/--project <id-or-handle>`, `--json`

### deployments build-logs

Fetch build logs for a deployment. Use this to debug `build-failed` status.

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

**Arguments:**
- `deployment` — Deployment ID (required)

**Options:**
- `-o/--organization <id>`, `-p/--project <id-or-handle>`
- `--type <backend|storefront>` — Which build log stream to read (default: `backend`)
- `--json` — Output as JSON

## Deployment Statuses

| Status | Meaning |
|--------|---------|
| `created` | Build not started yet |
| `building` | Build running |
| `built` | Build succeeded, awaiting rollout |
| `deploying` | Rolling out to environment |
| `deployed` | Live and serving traffic |
| `build-failed` | Build step failed — read `build-logs` |
| `deployment-failed` | Build succeeded, runtime crashed — read `mcloud logs` |
| `timed-out` | Exceeded time budget (backend only) |
| `canceled` | Superseded by a newer deployment |
| `idle` | No longer the active deployment |

## Examples

```bash
# 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
```