mcloud-deployments

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Cloud CLI: Deployments Commands

Cloud CLI：部署命令

Execute

mcloud deployments

commands to inspect deployments and their build logs.

执行

mcloud deployments

命令来查看部署及其构建日志。

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.

解析输出时务必传入
```
--json
```
参数——纯文本格式可能会发生变化。
如果尚未知晓组织/项目信息，在运行命令前务必确认上下文（
```
mcloud whoami --json
```
）。
使用格式为
```
depl_*
```
的
```
--deployment
```
ID或构建ID；构建ID会自动解析为其最新的部署。

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

列出项目的近期部署（默认：所有环境下最近的20个部署）。

bash

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

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

通过ID获取单个部署的详情。

bash

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

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

拉取部署的构建日志。用于调试

build-failed

状态。

bash

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格式输出

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

状态	含义
`created`	构建尚未开始
`building`	构建正在运行
`built`	构建成功，等待发布
`deploying`	正在向环境发布
`deployed`	已上线并处理流量
`build-failed`	构建步骤失败——查看 `build-logs`
`deployment-failed`	构建成功，但运行时崩溃——查看 `mcloud logs`
`timed-out`	超出时间预算（仅后端）
`canceled`	被较新的部署取代
`idle`	不再是活跃部署

Examples

示例

bash

undefined

bash

undefined

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

按提交SHA筛选部署

mcloud deployments list --commit a1b2c3d --json | jq '.'

Get deployments for a specific environment

获取特定环境的部署

mcloud deployments list --environment production --json

undefined

mcloud deployments list --environment production --json

undefined