tcb config pull
从云端拉取已部署资源的配置,写入本地 cloudbaserc.json,用于同步云端状态或初始化本地配置。
语法
tcb config pull <module> [name...] [options]
<module> 为资源模块:
| 模块 | 说明 |
|---|---|
fn | 拉取云函数配置 |
integration | 拉取集成配置 |
参数
| 参数 | 必填 | 说明 | 默认值 |
|---|---|---|---|
[name...] | 否 | 资源名称,支持一个或多个 | — |
--all | 否 | 拉取配置文件中所有资源的配置 | false |
-e, --env-id <envId> | 否 | 环境 ID | — |
-o, --output <output> | 否 | 输出文件路径,相对路径以当前目录为基准 | cloudbaserc.json |
--stdout | 否 | 输出到控制台,不写文件 | false |
--code-secret <codeSecret> | 否 | 代码加密函数的 CodeSecret | — |
--dir <dir> | 否 | 用于推测配置的目录,云端资源不存在时使用 | — |
--yes | 否 | 跳过交互确认,自动覆盖已存在的同名配置 | false |
示例
# 拉取单个云函数
tcb config pull fn myFunc
# 拉取多个云函数
tcb config pull fn func1 func2 func3
# 拉取配置文件中所有云函数
tcb config pull fn --all
# 输出到控制台,不写文件
tcb config pull fn func1 --stdout
# 指定输出文件并跳过确认
tcb config pull fn --all -o ./config/cloudbaserc.json --yes
# 拉取单个集成
tcb config pull integration myPayment
# 拉取所有集成
tcb config pull integration --all --yes
命令行为
| 场景 | 行为 |
|---|---|
| 本地配置不存在 | 自动创建并写入拉取的配置 |
| 同名资源已存在 | 交互询问是否覆盖,--yes 直接覆盖 |
| 不同名资源 | 追加到 functions / integrations 数组 |
| 云函数不存在 | 询问是否按本地目录推测配置写入,可用 --dir 指定目录 |
| 集成不存在 | 报错并提示先用 tcb config init integration 创建模板 |
集成配置中的密码类字段(API 密钥、证书等)云端返回占位符 ******,写入后需手动填真实值。