应用部署
v3.0.0+
tcb app 命令自 v3.0.0 起提供。
tcb app 命令用于部署和管理 CloudBase 云应用。每次部署会覆盖上一次，并保留历史部署记录（可通过 tcb app versions 查看）。
适用场景：有构建流程的前端项目
适合以下场景：
- 有安装依赖 + 构建步骤的前端项目（React / Vue / Next.js / Vite / Angular / Nuxt 等）
- 纯静态项目
- CI/CD 流水线中自动化部署
CLI 会自动完成：安装依赖 → 构建 → 上传产物 → 绑定路由，无需手动操作文件。每次部署会覆盖上一次，可通过 tcb app versions list 查看历史部署记录。
tcb app deploy
部署应用。CLI 会自动执行：安装依赖 → 构建 → 上传构建产物 → 绑定路由。
以下三种调用方式完全等价：
tcb app deploy [serviceName] [options] # 完整命令
tcb deploy [serviceName] [options] # 顶层别名
tcb [options] # 裸命令（不带任何子命令时自动路由到 app deploy）
参数
| 参数 | 说明 | 默认值 |
|---|---|---|
[serviceName] | 应用名称（可选，不填则自动从 package.json 读取或交互输入） | — |
-e, --env-id <envId> | 目标环境 ID | — |
--framework <type> | 框架类型：react / vue / vite / next / nuxt / angular / static | — |
--install-command <cmd> | 安装命令（留空则跳过安装） | npm install |
--build-command <cmd> | 构建命令（留空则跳过构建，适合纯静态项目） | — |
--output-dir <dir> | 构建产物目录（默认 ./dist；无需构建时填 ./） | 自动检测 |
--deploy-path <path> | 静态托管挂载路径 | /服务名 |
--cwd <path> | 项目目录（相对路径） | 当前目录 |
-f, --force | 应用名称已存在时跳过确认直接覆盖 | — |
示例
# 部署 Vite 项目（在项目根目录执行）
tcb app deploy --framework vite -e my-env-id
# 使用顶层别名，效果完全相同
tcb deploy --framework vite -e my-env-id
# 裸命令：什么都不加，交互式引导部署
tcb
# 指定项目子目录（monorepo 场景）
tcb app deploy --cwd ./frontend -e my-env-id
# 部署 Next.js 项目，指定构建产物目录
tcb app deploy --framework next --output-dir .next -e my-env-id
# 纯静态项目（跳过构建步骤）
tcb app deploy --framework static --build-command "" --output-dir ./public -e my-env-id
# CI 场景：跳过确认，覆盖更新已有应用
tcb app deploy --framework react --force -e my-env-id
tcb app list
查看当前环境的应用列表。
tcb app list [options]
参数
| 参数 | 说明 | 默认值 |
|---|---|---|
-e, --env-id <envId> | 环境 ID | — |
-l, --limit <n> | 返回数量 | 20 |
-o, --offset <n> | 偏移量 | 0 |
--json | 输出 JSON | — |
示例
tcb app list -e my-env-id
tcb app info
查看指定应用的详情（状态、版本、访问域名等）。
tcb app info <serviceName> [options]
示例
tcb app info my-app -e my-env-id
# JSON 输出（适合脚本读取访问域名）
tcb app info my-app --json -e my-env-id
tcb app versions list
查看应用版本历史列表。
tcb app versions list <serviceName> [options]
参数
| 参数 | 说明 | 默认值 |
|---|---|---|
<serviceName> | 应用名称（必填） | — |
-l, --limit <n> | 返回数量 | 20 |
-o, --offset <n> | 偏移量 | 0 |
-e, --env-id <envId> | 环境 ID | — |
示例
tcb app versions list my-app -e my-env-id
tcb app versions detail
查看应用指定版本的详细信息，默认显示最新版本。
tcb app versions detail <serviceName> [options]
参数
| 参数 | 说明 | 默认值 |
|---|---|---|
<serviceName> | 应用名称（必填） | — |
--version-name <name> | 版本名称（不填则查最新版本） | — |
-e, --env-id <envId> | 环境 ID | — |
示例
# 查看最新版本详情
tcb app versions detail my-app -e my-env-id
# 查看指定版本详情
tcb app versions detail my-app --version-name my-app-001 --env-id env-xxx
tcb app delete
删除应用记录，不会删除底层应用资源文件。
tcb app delete <serviceName> [options]
参数
| 参数 | 说明 | 默认值 |
|---|---|---|
<serviceName> | 应用名称（必填） | — |
-e, --env-id <envId> | 环境 ID | — |
--dry-run | 预览删除操作，不实际执行 | — |
示例
tcb app delete my-app -e my-env-id
# 预览删除（不实际执行）
tcb app delete my-app -e my-env-id --dry-run
注意
此操作会删除应用的所有版本和资源，不可恢复。项目资源文件需单独在静态托管桶中手动清除。