小程序开放平台

文档中心
命令概览
login/logout登录与账号管理
fun 云函数调试
env 云环境相关
命令组合使用示例
常见问题

云环境相关

CLI工具
>
CLI命令行全览
>
env 云环境相关
>
更新时间:2025-12-17 22:00:25

rcb env list
- 查看云环境列表

查询当前账号下所有可用的云环境。

命令格式

rcb env list

使用示例

rcb env list

输出示例

🌐 [rcb-env] 正在查询云环境列表...
🌐 [rcb-env] 云环境列表查询完成

🌐 [rcb-env] 共查询到 2 个云环境:

┌──────────────┬──────────────────┬────────┬──────────────────┬──────────────────┐
│ 云环境 ID     │ 名称              │ 状态   │ 创建时间          │ 更新时间          │
├──────────────┼──────────────────┼────────┼──────────────────┼──────────────────┤
│ env-7k2m9n4p │ xhs-widget-prod  │ 启用   │ 2024-01-15 10:20 │ 2024-11-10 14:30 │
│ env-abc12345 │ xhs-widget-dev   │ 启用   │ 2024-02-01 09:00 │ 2024-11-15 16:45 │
└──────────────┴──────────────────┴────────┴──────────────────┴──────────────────┘

查看环境列表

说明

  • 需要先完成登录:
    rcb login
  • 如果当前账号下暂无云环境,会提示前往平台创建
  • 环境 ID 可用于后续的
    rcb env set
    rcb fun deploy
    等命令

rcb env info
- 查看云环境详情

根据环境 ID 查询指定云环境的详细信息。

命令格式

rcb env info -e <envId>

参数说明

参数
说明
是否必填
-e, --envId <envId>
需要查询的云环境 Id

使用示例

rcb env info -e env-7k2m9n4p

输出示例

🌐 [rcb-env] 正在查询云环境详情...
🌐 [rcb-env] 云环境详情查询完成

┌──────────┬────────────────────────────────────────────┐
│ 字段     │ 值                                          │
├──────────┼────────────────────────────────────────────┤
│ 名称     │ xhs-widget-prod                           │
│ ID       │ env-7k2m9n4p                              │
│ 状态     │ 启用                                       │
│ 描述     │ 小红书小组件生产环境,承载所有线上流量     │
│ 创建时间 │ 2024-01-15 10:20:00                       │
│ 更新时间 │ 2024-11-10 14:30:00                       │
└──────────┴────────────────────────────────────────────┘

查看云环境信息

说明

  • 需要先完成登录:
    rcb login
  • 如果传入的
    envId
    不存在,会给出告警提示
  • 环境必须属于当前登录账号

rcb env set
- 设置默认云环境

为当前 CLI 登录态设置一个默认云环境,后续命令在未显式传入

-e
时会优先使用该默认环境。

命令格式

rcb env set -e <envId>

参数说明

参数
说明
是否必填
-e, --envId <envId>
需要设置为默认环境的云环境 Id

使用示例

# 将 env-7k2m9n4p 设置为默认云环境
rcb env set -e env-7k2m9n4p

输出示例

🌐 [rcb-env] 正在校验云环境(envId=env-7k2m9n4p)...
🌐 [rcb-env] 已选择云环境: xhs-widget-prod (env-7k2m9n4p)
🌐 [rcb-env] 已将当前云环境绑定到登录信息,后续命令可复用该环境配置

说明

  • 命令会先校验
    envId
    是否存在、是否属于当前账号
  • 校验通过后,会将云环境信息写入登录配置
    ~/.rcb/config.json
  • 设置默认环境后,
    rcb fun dev
    rcb fun deploy
    等命令可以省略
    -e
    参数
  • 需要先完成登录:
    rcb login
  • 推荐先使用
    rcb env list
    找到期望的云环境 Id

rcb env create
- 创建云环境

创建一个新的云环境。

命令格式

rcb env create [options]

参数说明

参数
说明
是否必填
-n, --name <name>
云环境名称(cloud_env_name)否(未传则交互输入)
-d, --description <description>
云环境描述否(未传则交互输入)

使用示例

1. 纯交互式(推荐首次使用):

rcb env create

交互过程:

? 请输入云环境名称 (cloud_env_name): xhs-widget-prod-01
? 请输入云环境描述(可选,可留空): 小红书小组件生产环境主节点

2. 半交互式(只交互描述):

rcb env create -n xhs-widget-prod-01

3. 全非交互式

rcb env create -n xhs-widget-prod-01 -d "小红书小组件生产环境主节点,承载所有线上流量"

输出示例

🌐 [rcb-env] 正在创建云环境:xhs-widget-prod-01 ...
🌐 [rcb-env] 云环境创建成功

🌐 [rcb-env] 新建云环境详情如下:

┌──────────┬────────────────────────────────────────────┐
│ 字段     │ 值                                          │
├──────────┼────────────────────────────────────────────┤
│ 名称     │ xhs-widget-prod-01                        │
│ ID       │ env-7k2m9n4p                              │
│ 状态     │ 初始化                                     │
│ 描述     │ 小红书小组件生产环境主节点,承载所有线上流量│
│ 创建时间 │ 2024-11-20 10:30:00                       │
│ 更新时间 │ 2024-11-20 10:30:00                       │
└──────────┴────────────────────────────────────────────┘

说明

  • 需要先完成登录:
    rcb login
  • 云环境名称不能为空,长度不超过 64 个字符
  • 云环境描述为可选,可以留空
  • 创建成功后,环境状态为"初始化",需要等待一段时间后变为"启用"