:fire::fire::fire: Serverless Devs developer tool ( Serverless Devs 开发者工具 )
code | 含义 |
---|---|
0 | 正常退出 |
100 | Serverless Devs 工具本身错误退出 |
101 | Serverless Devs 工具组件执行时,组件错误引起的退出 |
Serverless Devs 作为 Serverless 领域的开发者工具,其输出的标准化和规范化会在一定程度上对用户体验有比较明显的影响。
关于 Serverless Devs 命令行设计规范,可以参考 cli_design.md
在使用 Serverless Devs 开发者工具时,会遇到一些带有默认值的参数/变量,这一部分将会针对这些参数/变量,进行优先级划分,在每个类别下面的列表中,上面的情况优先级高于下面的情况,例如Yaml 文件优先级规范
为案例,描述为:
-t/--template
参数指定的 Yaml 文件s.yaml
/s.yml
,且s.yaml
的优先级大于s.yml
)则 Serverless Devs 开发者工具在进行资源描述文件使用时,会优先选择通过 -t/--template 参数指定的 Yaml 文件
,其次才会采用默认的 Yaml 文件( s.yaml/s.yml,且 s.yaml 的优先级大于 s.yml )
-t/--template
参数指定的 Yaml 文件s.yaml
/s.yml
,且s.yaml
的优先级大于s.yml
)service
优先部署;例如,某资源描述 Yaml 可以缩写成:
edition: 1.0.0 # 命令行YAML规范版本,遵循语义化版本(Semantic Versioning)规范 name: FullStack # 项目名称 access: xxx-account1 # 秘钥别名 services: nextjs-portal: # 服务名称 component: vue-component # 组件名称 props: # 组件的属性值 src: ./frontend_src url: url assets: component: static props: www: './public' gateway: component: serverless-gateway # 路由组件:HTTP URL和服务之间的映射规则 props: routes: - url: ${assets.output.url}
此时,可先进性依赖关系分析,服务
nextjs-portal
、assets
没有额外依赖,服务gateway
通过魔法变量${assets.output.url}
依赖了assets
服务;此时部署顺序则为:
nextjs-portal
、assets
按照上下顺序部署, 之后gateway
拿到assets
服务的返回结果再进行部署 即:nextjs-portal
->assets
->gateway
-a/--access
参数指定的密钥信息default
密钥信息default_serverless_devs_access
密钥信息具体的流程图为:
Serverless Devs 可以比较容易的通过环境变量进行密钥信息的设定。通过环境变量配置密钥的方法有两种:
ALIBABA_CLOUD_ACCOUNT_ID
、ALIBABA_CLOUD_ACCESS_KEY_ID
、ALIBABA_CLOUD_ACCESS_KEY_SECRET
等相关内容,此时可以通过s config add
命令进行添加:```shell script s config add -a default-aliyun -kl AccountID,AccessKeyID,AccessKeySecret -il ${ALIBABA_CLOUD_ACCOUNT_ID},${ALIBABA_CLOUD_ACCESS_KEY_ID},${ALIBABA_CLOUD_ACCESS_KEY_SECRET}
2. 通过指定环境变量的名字进行配置:例如当前有阿里云密钥对:
- AccountID: temp_accountid
- AccessKeyID: temp_accesskeyid
- AccessKeySecret: temp_accesskeysecret
此时可以在环境变量中可以命名 key 为`*********_serverless_devs_access`,例如`default_serverless_devs_access`,value 为 JSON 字符串,例如:
- Key:`default_serverless_devs_access`
- Value:`{\"AccountID\":\"temp_accountid\",\"AccessKeyID\":\"temp_accesskeyid\",\"AccessKeySecret\":\"temp_accesskeysecret\"}`
此时,可以在配置密钥的时候指定密钥`default_serverless_devs_access`,例如`${env(default_serverless_devs_access)}`
在`s.yaml`配置如下:
edition: 1.0.0 # 命令行YAML规范版本,遵循语义化版本(Semantic Versioning)规范 name: fcDeployApp # 项目名称 access: default_serverless_devs_access # 秘钥别名
services: fc-deploy-test: component: fc-deploy # 组件名称 props: # 组件的属性值 region: cn-shenzhen service: name: fc-deploy-service
## 基于人工智能的错误排查能力
Serverless Devs 提供了基于人工智能的错误排查能力,当您使用 Serverless Devs 的时候遇到了错误,系统将会对错误信息进行脱敏处理,并通过接口进行相关解决方案的获取。例如:
当前 Yaml 的格式存在问题,在项目下执行`s deploy`:
```shell script
$ s deploy
ERROR:
TypeError: Cannot convert undefined or null to object
AI Tips:
You can try to solve the problem through: http://qa.devsapp.cn/7867adf78017601dffd8c3611c90cadf.html
TraceId: a483e74739551640838688289
Environment: @serverless-devs/s: 2.0.96, @serverless-devs/core: 0.1.23, darwin-x64, node-v12.15.0
Documents: https://www.serverless-devs.com
Discussions: https://github.com/Serverless-Devs/Serverless-Devs/discussions
Issues: https://github.com/Serverless-Devs/Serverless-Devs/issues
Please copy traceId: a483e74739551640838688289 and join Dingding group: 33947367 for consultation.
You can run 's clean --cache' to prune Serverless devs.
And run again with the '--debug' option or 's -h' to get more logs.
此时,打开系统提醒的网页,可以看到;
隐私说明:使用该功能时,Serverless Devs 会采集部分客户端的错误信息进行处理,当然这些错误信息都是被脱敏后的错误信息,如果您仍然存在疑虑或者不想使用这个功能,您可以通过命令
s set analysis disable
关闭该功能。