mcpField
M
mcloud-deployments

mcloud-deployments

github.com/medusajs云与 DevOps2341.4k 次安装1 周前更新
代码仓库

关于 mcloud-deployments

面向使用 mcloud CLI 的 AI Agent，提供 Medusa Cloud 部署查询与构建日志操作指南。内容包括筛选部署、查看详情和按状态选择排错方向。

主要功能

  1. 01列出并筛选部署
  2. 02按 ID 查询部署详情
  3. 03获取构建日志
  4. 04说明部署状态含义

适用场景

  1. 01查看项目近期部署
  2. 02按环境或提交筛选部署
  3. 03调查构建失败原因

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/medusajs/medusa-agent-skills --skill mcloud-deployments

安装后在 Claude Code 中输入/mcloud-deployments确认已加载。

详细介绍

Cloud CLI：部署命令

执行 mcloud deployments 命令，检查部署及其构建日志。

限制

  • 解析输出时始终传入 --json——纯文本格式可能会发生变化。
  • 如果尚未确定组织／项目，运行命令前始终确认当前上下文（mcloud whoami --json）。
  • 使用 depl_* 格式的 --deployment 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超出时间限制（仅限 backend）
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

评论

支持 Markdown