@cloudbase/cli
Advanced tools
Cloudbase 命令行工具。
npm install -g @cloudbase/cli
使用 tcb init 创建项目，创建项目时 CLI 工具会成一个 Node 函数模板，供使用参考。
# 此命令会创建一个目录，并写入配置
tcb init
TCB 项目是和 TCB 环境资源关联的实体，TCB 项目聚合了云函数、数据库、文件存储等服务，您可以在 TCB 项目中编写函数，存储文件，并通过 cloudbase cli 快速的操作您的云函数、文件存储、数据库等资源。
TCB 项目文件结构：
.
├── _gitignore
├── functions // 云函数目录
│ └── app
│ └── index.js
└── tcbrc.json // tcb 项目配置文件
为了规范使用，所有 Node 和 PHP 函数都统一存放在 functions 目录下，并以函数名作为文件夹名称，如 functions/tcb/index.js。对于 Java 函数时，则需要将 jar 文件名修改为函数名称，放在 functions 目录下即可，如 functions/tcb.jar。
例如，创建一个 Node.js 函数 app，下面是 functions/app/index.js 的内容
'use strict'
exports.main = (event, context, callback) => {
console.log('Hello World')
console.log(event)
console.log(context)
callback(null, event)
}
项目配置存储在 tcbrc.json 文件中，默认生成的函数配置为 Node 语言相关的配置，其他语言如 PHP，Java 等需要修改对应的 handler(运行入口) 和 runtime(运行时)，参考下面的 tcbrc.json 文件说明部分
{
"envId": "xxx",
"functions": [
{
"name": "app",
"config": {
"timeout": 5,
"envVariables": {
"key": "value"
},
"vpc": {
"subnetId": "subnet-xxx",
"vpcId": "vpc-xxx"
},
"runtime": "Nodejs8.9"
},
"triggers": [
{
"name": "myTrigger",
"type": "timer",
"config": "0 0 2 1 * * *"
}
],
"params": {},
"handler": "index.main"
}
]
}
tcbrc.json 文件是 Cloudbase CLI 使用的配置文件，主要是为了简化 Cloudbase CLI 使用，方便 TCB 项目开发，当使用 CLI 命令参数缺失时，Cloudbase CLI 会尝试从 tcbrc.json 解析相关参数， 方便使用者以更简单的命令操作云开发资源。
{
// 关联环境 ID
"envId": "dev-97eb6c",
// 函数配置
"functions": [
{
// functions 文件夹下函数文件夹的名称，即函数名
"name": "app",
// 函数配置
"config": {
// 超时时间，单位：秒 S
"timeout": 5,
// 环境变量
"envVariables": {
"key": "value"
},
// 私有网络配置，如果不使用私有网络，可不配置
"vpc": {
// vpc id
"vpcId": "vpc-xxx",
// 子网 id
"subnetId": "subnet-xxx"
},
// 运行时，目前可选运行包含：Nodejs8.9, Php7, Java8
// 此参数可以省略，默认为 Nodejs8.9
"runtime": "Nodejs8.9"
},
// 函数触发器，说明见文档: https://cloud.tencent.com/document/product/876/32314
"triggers": [
{
// name: 触发器的名字
"name": "myTrigger",
// type: 触发器类型，目前仅支持 timer （即定时触发器）
"type": "timer",
// config: 触发器配置，在定时触发器下，config 格式为 cron 表达式
"config": "0 0 2 1 * * *"
}
],
// 函数处理入口，Node 和 PHP 项目可以省略，默认值为 index.main
// 因 Java 的 handler 配置较为特殊，所以当运行时为 Java 时，handler 不能省略
// 如：package.Class::mainHandler
"handler": "index.main",
// functions:invoke 本地触发云函数时的调用参数
"params": {},
}
]
}
最后，在项目根目录下（tcbrc.json 所在目录）运行 tcb functions:deploy 命令，即可部署 app 函数到云端
tcb functions:deploy app
使用 tcb -h 查看所有可用命令
tcb -h
Usage: tcb [options] [command]
Options:
-V, --version output the version number
-h, --help output usage information
Commands:
init [options] 创建并初始化一个新的项目
login [options] 登录腾讯云账号
logout 登出腾讯云账号
env:list 列出云开发所有环境
env:create <alias> 创建新的云环境
env:domain:list [envId] 列出环境的安全域名列表
env:domain:create <domain> [envId] 添加环境安全域名，多个以斜杠 / 分隔
env:domain:delete [envId] 删除环境的安全域名
env:login:list [envId] 列出环境登录配置
env:login:config [envId] 配置环境登录方式
functions:deploy [options] [functionName] [envId] 创建云函数
functions:code:update <functionName> [envId] 创建云函数
functions:list [options] [envId] 展示云函数列表
functions:delete [functionName] [envId] 删除云函数
functions:detail [functionName] [envId] 获取云函数信息
functions:log [options] <functionName> [envId] 打印云函数日志
functions:config:update [functionName] [envId] 更新云函数配置
functions:trigger:create [functionName] [envId] 创建云函数触发器
functions:trigger:delete [functionName] [triggerName] [envId] 删除云函数触发器
functions:invoke [functionName] [params] [envId] 触发云函数
functions:copy [options] <functionName> <newFunctionName> [envId] [targentEnvId] 创建云函数
server:deploy [name] 部署 node 服务
server:log [options] <name> 查看日志
server:reload <name> 重启 node 服务
server:stop <name> 停止应用
server:show 查看状态
Cloudbase CLI 支持作为单独的 Node 模块使用
const Client = require('@cloudbase/cli')
// 如果已使用 tcb login 登录过，可以不传入 secretId、secretKey 值
const client = new Client(secretId, secretKey)
// 列出云开发所有环境
client
.env
.list()
.then(function(data) {
console.log(data)
})
.catch(function(err) {
})
编程式 API 接口详情：API 接口
tcb login 登录腾讯云账号
# 通过控制台授权登录
tcb login
# 使用云 API 密钥登录
tcb login --key
tcb logout 注销登录
tcb new 创建一个包含配置文件 tcbrc.json 的云开发项目
tcb env:list 列出所有的云开发环境
┌─────────────┬─────────────┬─────────┬─────────────────────┐
│ EnvId │ PackageName │ Source │ CreateTime │
├─────────────┼─────────────┼─────────┼─────────────────────┤
│ base-xxxx │ 基础版 │ miniapp │ 2019-04-09 13:06:09 │
├─────────────┼─────────────┼─────────┼─────────────────────┤
│ dev-xxxxxx │ 基础版 │ qcloud │ 2019-06-20 13:24:51 │
└─────────────┴─────────────┴─────────┴─────────────────────┘
完整命令：tcb env:create <alias>
env:create 命令创建一个新的云开发环境，需要制定环境的别名 alias。
完整命令 tcb env:domain:list [envId]
env:domain:list 命令列出环境配置所有的安全域名。
完整命令：tcb env:domain:create <domain> [envId]
env:domain:create 命令用于添加域名到指定的环境，当需要添加多个域名时，需要以 / 分隔，如 abc.com/def.com。
完整命令：tcb env:domain:delete [envId]
env:domain:delete 命令用于删除环境配置的安全域名，输入此命令回车运行后，CLI 会拉取环境的所有域名，用户可与 CLI 进行交互，选择需要删除的域名。
完整命令： env:login:list [envId]
env:login:list 命令用于列出环境配置的登录方式列表，可以查看环境配置的登录方式，以及相关的状态。
env:login:config 命令用于配置环境的登录方式，如绑定微信公众平台等。
完整命令：tcb functions:list [options] [envId]
functions:list [options] [envId] 以表格的形式展示指定环境的函数信息，functions:list 命令的参数包含一些可选的选项 options 和可选的环境 Id envId。
可以通过命令行指定环境变量 envId
tcb functions:list dev-xxxx
在包含 tcbrc.json 配置文件的项目根目录下时，CLI 工具会自动读取配置文件中的 envId 信息，可以在命令中略去 envId
tcb functions:list
functions:list 可选的选项有
-l, --limit <limit> 返回数据长度，默认值为 20
-o, --offset <offset> 数据偏移量，默认值为 0
如：返回前 10 条函数信息
tcb functions:list -l 10
完整命令：tcb functions:deploy [options] [functionName] [envId]
注意
functions:deploy命令必须在包含tcbrc.json配置文件的项目根目录下执行。
functions:deploy 会根据 tcbrc.json 配置文件部署云函数，functions:deploy 命令的参数包含一些可选的选项 options 和可选的函数名称 functionName 以及环境 Id envId。
functions:deploy 命令会完成以下几项工作：
同 functions:list 类似，环境 Id 可以列出在命令中，也可以缺省，CLI 会从 tcbrc.json 文件中读取。（下文不做再次说明）
使用 functions:deploy 时，functionName 选项是可以省略的，当 functionName 省略时，CLI 会部署配置文件中的全部函数
tcb functions:deploy
当 functionName 存在时，CLI 只会部署指定的函数。
tcb functions:deploy dev
functions:deploy 可选的选项有
--force 如果存在同名函数，上传后覆盖同名函数
当已经存在同名函数时，可以通过 --force 选项指定 CLI 覆盖已存在的函数
tcb functions:deploy --force
tcb functions:deploy dev --force
完整命令：tcb functions:code:update <functionName> [envId]
functions:code:update 命令用于更新的函数的代码以及函数的执行入口，除此之外 functions:code:update 命令不会修改函数的其他配置。
functions:code:update 命令和 functions:deploy 命令的主要区别是 functions:code:update 命令只会更新函数的代码以及执行入口，不会修改函数的其他配置，而 functions:deploy 命令则会修改函数的代码以及所有配置。
完整命令：tcb functions:invoke [functionName] [params] [envId]
functions:invoke 命令会触发云函数运行。当 functionName 存在时，CLI 只会触发指定的云函数，否则，CLI 会触发 tcbrc.json 文件中配置的所有函数。
完整命令：tcb functions:detail [functionName] [envId]
functions:detail 命令主要用来获取函数的信息。
如：functions:detail app env-9kixk
函数 [app] 信息：
状态：Active
函数代码：
代码大小：635
描述：
环境变量(key=value)：key=value
函数名称：app
函数版本：$LATEST
执行方法：index.main
内存配置(MB)：256
修改时间：2019-07-31 21:05:11
环境 Id：dev-97eb6c
运行环境：Nodejs8.9
超时时间(S)：5
网络配置：vpc-xxx(私有网络 | 100.0.0.0/16) / subnet-xxx(子网)]
触发器：
myTrigger：{"cron": "0 0 2 1 * * *"}
myTrigger2：{"cron": "0 0 3 1 * * *"}
同样，当不指定 functionName 和 envId 时，CLI 会尝试检索 .tcbrc 文件获取 envId，并展示配置文件中的所有函数的信息。
完整命令：tcb functions:delete [functionName] [envId]
functions:delete 命令用于删除云函数。
同样，当不指定 functionName 和 envId 时，CLI 会尝试检索 .tcbrc 文件获取 envId，并删除配置文件中存在的所有函数。
完整命令 tcb functions:log [options] <functionName> [envId]
functions:log 命令会打印出指定函数的日志信息，使用此命令时必须指定函数的名称。
可选的选项包含：
-i, --reqId <reqId> 函数请求 Id
-o, --offset <offset> 数据的偏移量，Offset + Limit不能大于10000
-l, --limit <limit> 返回数据的长度，Offset + Limit不能大于10000
--order <order> 以升序还是降序的方式对日志进行排序，可选值 desc 和 asc
--orderBy <orderBy> 根据某个字段排序日志,支持以下字段：function_name,duration, mem_usage, start_time
--startTime <startTime> 查询的具体日期，例如：2019-05-16 20:00:00，只能与endtime 相差一天之内
--endTime <endTime> 查询的具体日期，例如：2019-05-16 20:59:59，只能与startTime 相差一天之内
-e, --error 只返回错误类型的日志
-s, --success 只返回正确类型的日志
如：tcb functions:log test-scf -l 2 打印 test-scf 函数的最新 2 条日志信息
请求时间：2019-07-26 17:04:43
函数名称：test-scf
计费时间(ms)：100
运行时间(ms)：0.44
调用次数：1
占用内存：NaN MB
请求 Id：68649b0f-af84-11e9-a803-525400e8849e
调用状态：成功
返回结果：{"key":"test","userInfo":{"appId":"wx9c4c30a432a38ebc","openId":"on01a6UeSuBLGTQpc_PAjS_RK_4o"}}
日志：....
同样，在包含 tcbrc.json 配置文件的项目根目录执行命令时，envId 是可以略去的。
完整命令：tcb functions:config:update [functionName] [envId]
functions:update:config 命令会根据 tcbrc.json 文件中的云函数配置信息更新线上云函数的配置。目前支持的配置包含超时时间 timeout 和环境变量 envVariables。
同样，当没有指定函数名 functionName 时，CLI 会更新 tcbrc.json 文件包含的所有函数的配置信息。
完整命令：tcb functions:trigger:create [functionName] [envId]
functions:trigger:create 命令会根据 tcbrc.json 文件中的函数配置创建函数触发器，关于函数触发器说明见文档 https://cloud.tencent.com/document/product/876/32314。
一个函数可以包含多个触发器，一个触发器包含了以下 3 个主要信息：name, type, config
{
// name: 触发器的名字，规则见下方说明
name: 'myTrigger',
// type: 触发器类型，目前仅支持 timer （即定时触发器）
type: 'timer',
// config: 触发器配置，在定时触发器下，config 格式为 cron 表达式
config: '0 0 2 1 * * *'
}
同样，当没有指定函数名 functionName 时，CLI 会创建 tcbrc.json 文件包含的所有函数的所有触发器，当制定了函数名 functionName 时，CLI 会创建指定函数的所有触发器。
完整命令：tcb functions:trigger:delete [functionName] [triggerName] [envId]
functions:trigger:delete 命令用于删除函数的触发器。
同样，当没有指定函数名 functionName 时，CLI 会删除 tcbrc.json 文件包含的所有函数的所有触发器。当只指定了函数名 functionName 时，CLI 会删除指定函数的所有触发器，当同时指定了 triggerName 时，CLI 只会删除指定的触发器。
# 删除 tcbrc.json 文件中所有函数的所有触发器
tcb functions:trigger:delete
# 删除函数 app 的所有触发器
tcb functions:trigger:delete app
# 删除函数 app 的触发器 myTrigger
tcb functions:trigger:delete app myTrigger
完整命令：functions:copy [options] <functionName> <newFunctionName> [envId] [targentEnvId]
functions:copy 命令用于复制一个函数。使用 functions:copy 命令时需要指定原函数名称，复制后新的函数名称。当前环境 Id 和目标环境环境 Id 是可选的，如果没有指定目标环境 Id，函数会被复制到当前环境中。
functions:copy 命令包含了一个可选的选项：
--force 如果目标环境下已有同名函数，则覆盖
FAQs
CLI for Tencent CloudBase (standalone bundle)
The npm package @cloudbase/cli receives a total of 5,493 weekly downloads. As such, @cloudbase/cli popularity was classified as popular.
We found that @cloudbase/cli demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 14 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
Compromised npm package art-template delivered a Coruna-like iOS Safari exploit framework through a watering-hole attack.
Company News
As AI accelerates how code is written and shipped, Socket is scaling to protect the software supply chain from the growing wave of attacks targeting open source dependencies.
Company News
Socket is scaling to defend open source against supply chain attacks as AI accelerates software development.