⚡️ Serverless 功能改进日志 ⚡️

[ole3021]

为了不断改进 Serverless Framework 的产品功能和使用体验，我们会每周都发布新的功能和改进，并在这里列出对对用户使用体验提升重大的功能和改变列出，方便用户查看了解 Serverless Framework 产品的改进。

关于Serverless Framework 产品的其他想法和建议也欢迎大家提交到社区。

祝大家使用 Serverless Framework 愉快 🍺。

[ole3021]

Serverless Components v3.9.0

发布日期: 2021年4月21日

⚡️ 全局授权信息

为了避免每次登陆都需要扫码进行授权，同时扫码授权生成的Token有效期只有2小时，用户需要反复授权。 在 Serverless Compoents v3.9.0 版本中 提供了 serverless credentials 命令来管理全局授权信息。

在组件应用目录中 执行 sls --help 或 执行 sls --help-components 可以查看全局授权信息使用方法和帮助。

serverless credentials      管理全局用户授权信息
   set                         存储用户授权信息
     --secretId / -i              (必填)腾讯云CAM账号secretId
     --secretKey / -k             (必填)腾讯云CAM账号secretKey
     --profile / -n {name}        身份名称. 默认为 "default"
     --overwrite / -o             覆写已有身份名称授权信息
   remove                      删除用户授权信息
     --profile / -n {name}        身份名称. 默认为 "default"
   list                        查看用户授权信息

要使用 serverless credential 功能

1. 到 腾讯云 - 访问管理 - 用户创建一个新的用户，在访问方式中开启 编程访问 (启用SecretId和SecretKey，支持腾讯云API、SDK和其他开发工具访问)， 并分配所需要的访问权限。创建成功后获得该CAM用户的 SecretId 和 SecretKey信息。

2. 使用 sls credentials set --i ******** -k ******** 来配置全局授权信息。 (如未制定身份名称，默认存储为default, 通过不同身份名称可以存储多个身份授权信息)

3. 使用 sls credentials list 查看全部已有授权信息的身份名称。

4. 在组件应用命令中执行相关命令都会默认使用[default]的授权信息，不会再弹出代码登陆窗口。

---

• 使用 sls credentials set --i ******** -k ******** -o 来覆覆写授权信息。
• 使用 sls credentials set --i ******** -k ******** -n myProfile 来创建另外一个名外 myProfile的 授权信息。
• 使用 sls deploy --profile myProfile 来指定使用myProfile 的授权信息。
• 使用 sls deploy --login 来忽略全局授权信息，并进行扫码登陆获取临时授权。
• 使用 sls credentials remove -n myProfile 来删除本地名外 myProfile的授权信息。

可以储存 TENCENT_CREDENTIALS_PROFILE={name} 在项目 .env 文件中, 来固定要使用的授权信息。
请确保项目目录(以及上两层目录)中没有环境变量 TENCENT_SECRET_KEY 和 TENCENT_SECRET_ID， 否则会任务该项目需要使用临时密钥进行授权。
删除用户授权信息只会移除本地的授权密钥信息，不会删除腾讯云的CAM用户信息。

[ole3021]

Serverless Components V3.10.0

发布日期: 2021年5月19日

⚡️组件日志功能

为了方便查看组件的云端日志，以及实时日志，Serverless Components v3.10.0 版本中 提供了 serverless logs 命令来查看日志。

在组件应用目录中 执行 sls --help 或 执行 sls --help-components 可以查看日志的使用方法和帮助。

serverless logs             查看应用日志
   --startTime                 指定开始时间，如：3h, 20210520T080910, 默认10m
   --tail / -t                      启动监听模式
   --intervial / -i             监听模式的刷新时间 默认：2000ms
   --stage / -s                指定环境名称，默认使用配置环境
   --region / -r               指定地区名称，默认使用配置地区

查看指定时间日志

使用 serverless logs --startime xxxx 来查看指定开始时间的日志，支持传入的时间参数有 3h (3小时之前) , 3d (3天之前)， 10m (10分钟之前)， 20210520T080910 （2021年5月20日08点09分10秒，当前系统时区时间）。

监听最新日志

使用 serverless logs --tail --intervial 5000 来自动获取并显示最新的日志。获取日志间隔为5秒钟。

因为API限制每次获取最新的日志仅会获取最新的10条日志，请合理配置刷新时间。

⚡️调用函数 (仅限函数组建 SCF Component 使用)

为了方便测试云端函数并方便在线调试，Serverless Components v3.10.0 版本中 提供了 serverless invoke 命令来调用函数。

在组件应用目录中 执行 sls --help 或 执行 sls --help-components 可以查看日志的使用方法和帮助。

serverless invoke           调用函数
   --data / -d                 指定传入函数的事件 (event) 参数数据，需要使用序列化的 JSON 格式
   --path / -p                 指定传入函数的事件 (event) 参数的 JSON 文件路径
   --stage / -s                指定环境名称，默认使用配置环境
   --region / -r               指定地区名称，默认使用配置地区

---

• 使用 sls invoke --data "{\"foo\":\"bar\"}" 来传入调用默认函数的Event参数数据。
• 使用 sls invoke --path ../test/eventSample.json 来传入调用默认函数的Event参数数据所在的JSON文件。
• 使用 sls invoke --stage prod 来调用 prod 环境的默认函数。

⚡️本地调用函数 (仅限函数组建 SCF Component 使用)

为了方便本地测试云端函数并方便本地调试，Serverless Components v3.10.0 版本中 提供了 serverless invoke local 命令来调用函数。

在组件应用目录中 执行 sls --help 或 执行 sls --help-components 可以查看日志的使用方法和帮助。

serverless invoke local     本地调用函数
   --function / -f             调用的函数名称，默认使用配置的函数
   --data / -d                 指定传入函数的事件 (event) 参数数据，需要使用序列化的 JSON 格式
   --path / -p                 指定传入函数的事件 (event) 参数的 JSON 文件路径
   --context                   指定传入函数的上下文(context)参数数据，需要使用序列化的 JSON 格式
   --contextPath / -x          指定传入函数的上下文 (context) 参数的 JSON 文件路径
   --env / -e                  指定环境变量信息 如: --env VAR=val
   --config / -c               指定使用的配置文件

---

• 使用 sls invoke local --data "{\"foo\":\"bar\"}" --context "{\"baz\":\"qux\"}" 来传入调用默认函数的 Event 和 Context 参数数据。
• 使用 sls invoke local --path ../test/eventSample.json -- contextPath ../test/contextSample.json 来传入调用默认函数的 Event 和 Context 参数数据所在的JSON文件。