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	修复位于跟踪分支的源代码中——启动新构建

示例

# 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}'