@serverless-devs/s 2.0.92 → 2.0.93-beta.4

package/docs/zh/cli_design.md

@@ -0,0 +1,100 @@
+# 命令行设计规范
+
+Serverless Devs 作为 Serverless 领域的开发者工具，其输出的标准化和规范化会在一定程度上对用户体验有比较明显的影响。
+
+本文档将会通过一些文字和案例，对Serverless Devs的命令行工具输出，进行规范化升级。
+
+## 规范详情
+
+输出格式的规范目标是：
+
+- 更清晰
+- 更简约
+- 不影响功能实用
+
+基于以上三个原则，我们可以通过正常输出的形式、异常输出的形式等分别进行举例说明
+
+### 基本输出
+
+基本输出的形式，整体上包括两个部分：
+
+1. 项目执行阶段
+
+项目执行阶段主要包括一个基本格式:
+
+```
+⌛ Steps for process
+====================
+```
+
+采用重写机制，不断的更新输出内容，每个项目执行完成可以输出相对应的结果，示例：
+
+```
+⌛ Steps for process
+====================
+✔ Pre-action completed (10s)
+```
+
+2. 结果输出阶段
+
+项目执行阶段主要包括一个基本格式:
+
+```
+🚀 Result for process
+====================
+```
+
+具体的项目输出采用`Yaml`的格式进行输出，输出时，项目名称要加下划线，如果没有输出则直接结束项目，示例：
+
+```
+🚀 Result for process
+====================
+✔ MyProject deployed (11s)
+fc-deploy-test:
+  region: cn-hangzhou
+  service:
+    name: fc-deploy-service
+    memorySize: 128
+```
+
+#### 单项目输出示例
+
+![render1629447409205](https://user-images.githubusercontent.com/21079031/130204631-174a5af5-5550-4e7f-bc3b-d6d23681ce61.gif)
+
+
+#### 多项目输出示例
+
+![render1629448703505](https://user-images.githubusercontent.com/21079031/130206222-8674550e-2ecf-4e19-9dac-d81a8ab11b02.gif)
+
+
+### 调试模式
+
+当用户使用`--debug`进入到调试模式，则会打印非常详细的信息在控制台，但是这些信息将会以灰色形式打印出来，以保持整体的层次感：
+
+![render1629448900851](https://user-images.githubusercontent.com/21079031/130206327-b25c444f-d336-4dc3-8dfe-39a5329e4b13.gif)
+
+
+
+### 错误输出
+
+当执行出现错误时，Serverless Devs要做到感知并输出相对应的内容：
+
+```
+⌛ Steps for process
+====================
+✔ MyProject pre-action completed (10s)
+✖ MyProject failed to deploy:
+
+Error Message: 
+t[r] is not a function
+
+Env:   darwin, node v15.14.0
+Docs:  https://github.com/serverless-devs/docs
+Bugs:  https://github.com/Serverless-Devs/Serverless-Devs/issues
+Logs:  ~/demo/demo/demo/s.log
+```
+
+动态效果为：
+
+![render1629447327225](https://user-images.githubusercontent.com/21079031/130204744-be670d4b-0c1a-4128-aafe-3e8871b3ef58.gif)
+

package/docs/zh/command/clean.md

@@ -0,0 +1,63 @@
+# Clean 命令
+
+`clean`命令是清理 Serverless Devs 的缓存相关功能，可以通过该命令清理环境、不用的依赖包以及相关的缓存内容。
+
+- [命令解析](#命令解析)
+    - [参数解析](#参数解析)
+    - [操作案例](#操作案例)
+    
+## 命令解析
+
+当我们执行`s clean -h`之后，可以进行相关帮助信息的查看：
+
+```shell script
+$ s clean -h
+Usage: s cli [options]
+
+Clean up the cache related functions of serverless devs. You can clean up the environment, unused dependent packages and related cache contents through this command.
+    
+    Example:
+        $ s clean --component fc-api
+        $ s clean --all
+
+    Tips:
+        Get all installed component: s component
+
+📖 Document: https://github.com/Serverless-Devs/Serverless-Devs/tree/master/docs/zh/command/clean.md
+
+Options:
+  --all                         Clean up the environment
+  --cache [dirName]             Delete the <dirName> file in the cache
+  --component [componentName]   Remove component (like: fc, fc@0.0.1)
+  -h, --help                    Display help for command
+```
+
+### 参数解析
+
+| 参数全称 | 参数缩写 | 是否必填 | 参数含义 |
+|-----|-----|-----|-----|
+| all |  | 选填 | 清理环境 |
+| cache |  | 选填 | 删除缓存里的的<dirName>文件 |
+| component |  | 选填 | 删除指定的组件，可以是组件名，也可以是[组件名@版本号] |
+
+### 操作案例
+
+如果想要清理掉某个组件，可以通过`--component`参数与具体的组件名进行清理，例如：
+
+```shell script
+$ s clean --component fc-api
+Component [fc-api] has been cleaned up successfully.
+```
+
+如果想要清理整体环境，可以直接通过`--all`参数进行，例如：
+
+```shell script
+$ s clean --all       
+The environment of Serverless Devs has been cleaned up successfully.
+```
+
+## 注意事项
+
+在进行指定组件的清理时，系统会按照指定的逻辑进行组件的清理：
+1. 系统先会确定当前设置的 Registry 缓存中，存在的符合条件的组件，并进行清理；
+2. 系统将会对系统的最终 Registry 缓存中（Github Registry），存在的符合条件的组件，并进行清理；

package/docs/zh/command/cli.md

@@ -0,0 +1,92 @@
+# Cli 命令
+
+`cli`命令是去Yaml化的命令行模式，即可以通过命令行直接使用 Serverless Devs 的组件，而不需要依赖Yaml文件。
+
+- [命令解析](#命令解析)
+- [常见模式](#常见模式)
+    - [通用组件的支持](#通用组件的支持)
+    - [特定组件的支持](#特定组件的支持)
+
+> Yaml 模式与 Cli 模式的区别和试用场景，可以参考文档[Yaml 模式 Cli 模式对比](./../yaml_and_cli.md)
+
+## 命令解析
+
+当我们执行`s cli -h`之后，可以进行相关帮助信息的查看：
+
+```shell script
+$ s cli -h
+Usage: s cli [component] [method] [options]
+
+Directly use serverless devs to use components, develop and manage applications without yaml configuration.
+    
+    Example:
+        $ s cli fc-api listServices
+        $ s cli fc-api listFunctions --service-name my-service
+        $ s cli fc-api deploy -p "{/"function/": /"function-name/"}"
+    
+📖 Document: https://github.com/Serverless-Devs/Serverless-Devs/tree/master/docs/zh/command/cli.md
+
+Options:
+  -a, --access [aliasName]  Specify the access alias name
+  -p, --props [jsonString]  The json string of props
+  -h, --help                Display help for command
+```
+
+使用方法主要是：
+
+```shell script
+s cli [组件名称，例如fc，fc-api等] [组件的方法] -p/--props [该方法对应的Yaml属性（JSON字符串）] -a/--access [指定密钥信息] [其他设定]
+```
+
+
+## 常见模式
+
+### 通用组件的支持
+
+在`cli`模式下，可以通过`-p, --props [jsonString]`参数对组件进行通用的支持。
+
+例如，某Serverless Devs应用可以通过以下`s.yaml`描述：
+
+```yaml
+edition: 1.0.0
+access: "myaccess"
+
+services:
+  website-starter:
+    component: devsapp/website
+    props:
+      bucket: testbucket
+      src:
+        codeUri: ./
+        publishDir: ./build
+        index: index.html
+      region: cn-hangzhou
+      hosts:
+        - host: auto
+```
+
+并且，可以通过`s website-starter deploy`，将`website-starter`部分进行部署。
+
+此时，如果通过`cli`模式进行部署，可以不需要依赖上述Yaml，但是需要在命令行中，写上完整的参数信息：
+
+```shell script
+s cli devsapp/website deploy -p "{\"bucket\":\"testbucket\",\"src\":{\"codeUri\":\"./\",\"publishDir\":\"./build\",\"index\":\"index.html\"},\"region\":\"cn-hangzhou\",\"hosts\":[{\"host\":\"auto\"}]}" -a myaccess
+```
+
+### 特定组件的支持
+
+在 Serverless Devs 目前已经存在的组件中，已经有一些比较优秀且针对 Cli 模式设计的组件，例如`fc-api`组件，就是一款命令行模式优先的组件，通过该组件，可以快速的使用阿里云函数计算的一些接口，进行操作，例如：
+
+- 查看阿里云函数计算的某个地区下某个服务下的函数列表：
+    ```shell script
+    s cli fc-api listFunctions --service-name my-service --region cn-beijing -a myaccess
+    ```
+- 通过纯命令行形式，对函数进行代码更新：
+    ```shell script
+    s cli fc-api updateFunction --region cn-hangzhou --serviceName fc-deploy-service --functionName http-trigger-function --code '{"zipFile":"./"}'
+    ```
+
+除此之外，很多组件可以即对 Yaml 模式有比较好的支持，也会在某些情况下对 纯命令行模式，进行额外优化设计，例如 `fc` 组件的线上线下资源同步操作：
+```shell script
+s cli fc sync --region cn-shanghai --service-name myService --type config
+```

package/docs/zh/command/component.md

@@ -0,0 +1,76 @@
+# Component 命令
+
+`component`命令是获取已经安装的组件详情信息。
+
+- [命令解析](#命令解析)
+    - [参数解析](#参数解析)
+    - [操作案例](#操作案例)
+- [注意事项](#注意事项)
+
+## 命令解析
+
+当我们执行`s component -h`之后，可以进行相关帮助信息的查看：
+
+```shell script
+$ s component -h
+Usage: s component [options]
+
+Get details of installed components.
+    
+    Example:
+        $ s component
+        $ s component --component fc-api
+
+📖 Document: https://github.com/Serverless-Devs/Serverless-Devs/tree/master/docs/zh/command/component.md
+
+Options:
+  --component [componentName]     Gets the specified component information (like: fc, fc@0.0.1)
+  -h, --help                      Display help for command
+```
+
+### 参数解析
+
+| 参数全称 | 参数缩写 | 是否必填 | 参数含义 |
+|-----|-----|-----|-----|
+| name |  | 选填 | 获取指定的组件信息，可以是组件名，也可以是[组件名@版本号] |
+
+### 操作案例
+
+如果想要获取某个组件，可以通过`--component`参数与具体的组件名进行清理，例如：
+
+```shell script
+$ s component --component fc-api
+Component: fc
+Reigstry: serverless registry [http://registry.devsapp.cn/simple] 
+Version: 0.1.27  
+Size: 100 MB
+Description: 阿里云函数计算基础组件
+Path: ~/.s/components/fc
+Hompage: https://github.com/devsapp/fc
+
+🙋 Delete the component, please use the command [s clean --component fc@0.1.27]
+```
+
+如果想要获取所有已经安装的组件信息，可以直接执行`s component`获取，例如：
+
+```shell script
+$ s component 
+
+🔎 serverless registry [http://registry.devsapp.cn/simple] 
+Component     Description           Size        Version 
+fc            阿里云函数计算基础组件    100 MB       0.1.27
+devsapp/fc    阿里云函数计算基础组件    100 MB       0.1.27
+devsapp/fc    阿里云函数计算基础组件    100 MB       0.1.27
+fc-api        函数计算api操作组件      100 MB       0.0.44
+
+🔎  github registry [https://api.github.com/repos]
+Component     Description           Size        Version 
+fc            阿里云函数计算基础组件    100 MB       0.1.27
+devsapp/fc    阿里云函数计算基础组件    100 MB       0.1.27
+
+```
+
+
+## 注意事项
+
+在查询组件时，系统只会显示当前 Registry 与默认的 Github Reigstry 信息。如果需要查看其他 Reigstry 的信息，需要先通过`s set registry`进行 Reigstry 的切换

package/docs/zh/command/config.md

@@ -0,0 +1,278 @@
+# Config 命令
+
+`config`命令是密钥信息相关的命令，包括密钥的配置、密钥的查看以及密钥的修改、删除等。
+
+- [命令解析](#命令解析)
+- [config add 命令](#config-add-命令)
+    - [参数解析](#参数解析)
+    - [操作案例](#操作案例)
+- [config get 命令](#config-get-命令)
+    - [参数解析](#参数解析-1)
+    - [操作案例](#操作案例-1)
+- [config delete 命令](#config-delete-命令)
+    - [参数解析](#参数解析-2)
+    - [操作案例](#操作案例-2)
+- [注意事项](#注意事项)
+    - [通过环境变量配置密钥信息](#通过环境变量配置密钥信息)
+    
+## 命令解析
+
+当执行`s config -h`之后，可以进行相关帮助信息的查看：
+
+```shell script
+Usage: s config [commands] [options]
+
+Configure venders account, including Alibaba Cloud, Baidu Cloud, Huawei Cloud, Tencent Cloud, etc.
+
+📖 Document: https://github.com/Serverless-Devs/Serverless-Devs/tree/master/docs/zh/command/config.md
+
+Options:
+  -h, --help  Display help for command
+
+Commands:
+  add         ➕ Add an account
+  get         ✔️ Get accounts
+  delete      ✖️ Delete an account
+```
+
+在该命令中，包括了三个子命令：
+- [add：添加密钥配置](#config-add-命令)
+- [get：查看密钥配置](#config-get-命令)
+- [delete：删除密钥配置](#config-delete-命令)
+
+
+## config add 命令
+
+通过`config add`命令，可以进行密钥的配置，使用者可以通过不同厂商的默认密钥模板进行密钥配置，也可以通过`Custom`选项进行自定义密钥配置。
+
+通过`-h/--help`可以查看到配置帮助：
+
+```shell script
+Usage: s config add [commands] [name]
+
+You can add an account
+
+    Example:
+        $ s config add
+        $ s config add --AccessKey ****** --SecretKey ******
+        $ s config add --AccessKeyID ****** --AccessKeySecret ****** --AccountID ****** --SecurityToken ******
+        $ s config add --keyList key1,key2,key3 --valueList value1,value2,value3
+
+    Configuration parameters template for vendors:
+        alibaba: AccountID, AccessKeyID, AccessKeySecret
+        aws: AccessKeyID, SecretAccessKey
+        baidu: AccessKeyID, SecretAccessKey
+        huawei: AccessKey, SecretKey
+        google: PrivateKeyData
+        tencent: AccountID, SecretID, SecretKey
+
+🧭 How to get the key: https://github.com/Serverless-Devs/docs/tree/master/zh/others/provider-config
+
+Options:
+  --AccountID [AccountID]              AccountID of key information
+  --AccessKeyID [AccessKeyID]          AccessKeyID of key information
+  --AccessKeySecret [AccessKeySecret]  AccessKeySecret of key information
+  --SecurityToken [SecurityToken]      SecurityToken of key information
+  --SecretAccessKey [SecretAccessKey]  SecretAccessKey of key information
+  --AccessKey [AccessKey]              AccessKey of key information
+  --SecretKey [SecretKey]              SecretKey of key information
+  --SecretID [SecretID]                SecretID of key information
+  --PrivateKeyData [PrivateKeyData]    PrivateKeyData of key information
+  -kl , --keyList [keyList]            Keys of key information, like: -kl key1,key2,key3
+  -il , --infoList [infoList]          Values of key information, like: -il info1,info2,info3
+  -a, --access [aliasName]             Key pair alias, if the alias is not set, use default instead
+  -f                                   Mandatory overwrite key information
+  -h, --help                           Display help for command
+```
+
+
+### 参数解析
+
+| 参数全称 | 参数缩写 | 是否必填 | 参数含义 |
+|-----|-----|-----|-----|
+| AccountID | - | 选填 | 部分云厂商配置密钥所需要的默认字段 |
+| AccessKeyID | - | 选填 | 部分云厂商配置密钥所需要的默认字段 |
+| AccessKeySecret | - | 选填 | 部分云厂商配置密钥所需要的默认字段 |
+| SecurityToken | - | 选填 | 部分云厂商配置密钥所需要的默认字段 |
+| SecretAccessKey | - | 选填 | 部分云厂商配置密钥所需要的默认字段 |
+| AccessKey | - | 选填 | 部分云厂商配置密钥所需要的默认字段 |
+| SecretKey | - | 选填 | 部分云厂商配置密钥所需要的默认字段 |
+| SecretID | - | 选填 | 部分云厂商配置密钥所需要的默认字段 |
+| PrivateKeyData | - | 选填 | 部分云厂商配置密钥所需要的默认字段 |
+| keyList | kl | 选填 | 在默认字段无法满足配置诉求时，可以通过`keyList`与`infoList`进行批量自定义配置 |
+| infoList | il | 选填 | 在默认字段无法满足配置诉求时，可以通过``keyList`与`infoList`进行批量自定义配置 |
+| access | a | 选填 | 密钥的别名 |
+| f | - | 选填 | 强制修改/覆盖已经配置的密钥信息 |
+
+### 操作案例
+
+可以通过`config add`直接进行密钥的添加：
+
+```shell script
+$ s config add 
+
+? Please select a provider: (Use arrow keys)
+❯ Alibaba Cloud (alibaba) 
+  AWS (aws) 
+  Azure (azure) 
+  Baidu Cloud (baidu) 
+  Google Cloud (google) 
+  Huawei Cloud (huawei) 
+  Tencent Cloud (tencent) 
+  Custom (others) 
+```
+
+当使用者选择某个选项之后，系统会进行交互式引导：
+
+```shell script
+s config add 
+
+? Please select a provider: Alibaba Cloud (alibaba)
+? AccountID **********
+? AccessKeyID **********
+? AccessKeySecret **********
+? Please create alias for key pair. If not, please enter to skip default
+```
+
+也可以通过命令式直接进行密钥的添加：
+```shell script
+$ s config add --AccessKeyID ****** --AccessKeySecret ****** --AccountID ******
+```
+
+或者添加自定义内容：
+```shell script
+$ s config add --AccessKeyID ****** -kl key1,key2,key3 -il info1,info2,info3
+```
+
+- 常见云厂商密钥配置内容
+
+```
+alibaba:    AccountID, AccessKeyID, AccessKeySecret,
+aws:        AccessKeyID, SecretAccessKey,
+baidu:      AccessKeyID, SecretAccessKey,
+huawei:     AccessKeyID, SecretAccessKey,
+azure:      KeyVaultName, TenantID, ClientID, ClientSecret,
+tencent:    AccountID, SecretID, SecretKey,
+google:     PrivateKeyData
+```
+
+> - 通过环境变量获取密钥方法： 这一部分可能会根据不同的文档有不同的可能性，所以需要参考对应的文档进行环境变量对应的`Key-Value`确定。
+> - 常见云厂商密钥获取地址：
+>     - [阿里云](./../default_provider_config/alibabacloud.md)
+>     - [百度云](./../default_provider_config/baiducloud.md)
+>     - [AWS](./../default_provider_config/aws.md)
+>     - [Azure](./../default_provider_config/azure.md)
+>     - [Google Cloud](./../default_provider_config/gcp.md)
+>     - [华为云](./../default_provider_config/huaweicloud.md)
+>     - [腾讯云](./../default_provider_config/tencentcloud.md)
+
+
+## config get 命令
+
+通过`config get`命令，您可以获得配置过的账号信息。
+
+通过`-h/--help`可以查看到配置帮助：
+
+```shell script
+$ s config get -h
+
+Usage: s config get [options] [name]
+
+You can get accounts.
+ 
+     Example:
+        $ s config get
+        $ s config get -a demo
+ 
+
+Options:
+  -a, --access [aliasName]  Key pair alia, if the alias is not set, use default instead
+  -h, --help                Display help for command
+```
+
+### 参数解析
+
+| 参数全称 | 参数缩写 | 是否必填 | 参数含义 |
+|-----|-----|-----|-----|
+| access | a | 选填 | 密钥的别名 |
+
+### 操作案例
+
+如果想要获取某个已经配置的密钥详情，可以通过`config get`进行获取，例如，想要获取别名为`test`的密钥信息，就可以执行：
+
+```shell script
+$ s config get -a test
+test:
+  AccountID: 146**********468
+  AccessKeyID: LTA******************f5Q
+  AccessKeySecret: qDN************************Xp7
+```
+
+如果想获得全部的一配置的密钥信息，可以直接通过`config get`不加参数的形式获取：
+
+```shell script
+$ s config get
+default:
+  AccountID: 158**********465
+  AccessKeyID: LTA******************ZCW
+  AccessKeySecret: mDL************************odO
+test:
+  AccountID: 146**********468
+  AccessKeyID: LTA******************f5Q
+  AccessKeySecret: qDN************************Xp7
+release:
+  AccountID: 176**********635
+  AccessKeyID: LTA******************Yy3
+  AccessKeySecret: LhT************************VB5
+```
+
+## config delete 命令
+
+通过`config delete`命令，您可以删除配置过的账号信息。
+
+通过`-h/--help`可以查看到配置帮助：
+
+```shell script
+$ s config delete -h
+
+Usage: s config delete [options] [name]
+
+You can delete an account.
+
+     Example:
+        $ s config delete -a demo
+
+
+Options:
+  -a, --access [aliasName]  Key pair alias, if the alias is not set, use default instead
+  -h,--help                 Display help for command
+```
+
+### 参数解析
+
+| 参数全称 | 参数缩写 | 是否必填 | 参数含义 |
+|-----|-----|-----|-----|
+| access | a | 必填 | 密钥的别名 |
+
+### 操作案例
+
+如果想要删除某个已经配置的密钥，可以通过`config delete`进行删除，例如，想要删除别名为`test`的密钥信息，就可以执行：
+
+```shell script
+$ s config delete -a test
+Key [test] has been successfully removed
+```
+
+## 注意事项
+
+### 通过环境变量配置密钥信息
+
+在某些时候，密钥是不方便直接进行配置到 Serverless Devs 工具中，此时可以考虑将密钥信息放在环境变量中。
+
+例如，此时需要配置的密钥名为`s_secrets`，就可以在环境变量中，增加：
+
+```text
+s_secrets="{\"Key1\":\"Value1\",\"Key2\":\"Value2\"}"
+```
+
+此时就可以在使用是通过`${env(s_secrets)}`进行指定的环境变量密钥使用。

package/docs/zh/command/custom.md

@@ -0,0 +1,73 @@
+# 自定义命令使用指南
+
+- [应用级操作](#应用级操作)
+- [服务级操作](#服务级操作)
+- [注意事项](#注意事项)
+
+所谓的自定义命令指的是由组件决定的命令。由于 Serverless Devs 开发者工具，本身并不具备任何业务相关的能力（值得包括不限于函数的部署、应用的构建、项目的测试等），所以，这些能力都将会由组件提供，通过 Serverless Devs 开发者工具进行透出。
+
+例如，某应用的资源/行为描述文件如下：
+
+```yaml
+edition: 1.0.0        #  命令行YAML规范版本，遵循语义化版本（Semantic Versioning）规范
+name: FullStack       #  项目名称
+access: xxx-account1
+
+services:
+  backend: #  服务名称
+    component: django-component  # 组件名称
+    props: #  组件的属性值
+      src: ./backend_src
+      url: url
+  user—frontend: #  服务名称
+    component: vue-component  # 组件名称
+    props: #  组件的属性值
+      src: ./frontend_src_user
+      url: url
+  admin-frontend: #  服务名称
+    component: vue-component  # 组件名称
+    props: #  组件的属性值
+      src: ./frontend_src_admin
+      url: url
+```
+
+通过该 Yaml 文件可以看出以下信息：
+1. 该应用的名字是`FullStack`，将会使用密钥`xxx-account1`;
+2. 该应用拥有三个服务：
+    - `backend`服务：使用了`django-component`组件
+    - `user—frontend`服务：使用了`vue-component`组件
+    - `admin-frontend`服务：使用了`vue-component`组件
+    
+如果此时`django-component`组件和`vue-component`组件支持的自定义命令为：
+
+| | `django-component` | `vue-component` |
+| --- | --- | --- |
+| `deploy` | 支持 | 支持 |
+| `remove` | 支持 | 支持  |
+| `test` | 支持 | 不支持 |
+
+则可以通过自定义命令实现[应用级操作](#应用级操作)和[服务级操作](#服务级操作)。
+
+## 应用级操作
+
+在当前项目下，可以执行`s [自定义命令]`实现应用纬度的操作。
+
+- 执行`s deploy`或者`s remove`时，由于`backend`、`user—frontend`、`admin-frontend`三个服务对应的组件，均支持`deploy`和`remove`方法，所以此时系统会按照[Serverless User Model所定义的服务顺序](../../../spec/zh/0.0.1/serverless_user_model/3.user_model.md#服务顺序)，进行三个服务分别对应的组件的`deploy`或`remove`操作；**此时，系统的`exit code`为0；**
+- 执行`s test`时，由于`user—frontend`、`admin-frontend`两个服务对应的组件并不支持`test`方法，所以此时系统会执行`backend`对应组件（`django-component`）的`test`操作；**此时，系统会对`user—frontend`、`admin-frontend`两个服务进行警告，但是并不会报错，最终的`exit code`为0；**
+- 如果在执行相关的命令时，`backend`、`user—frontend`、`admin-frontend`三个服务任何一个服务在执行过程中出现了错误，系统则会报错，并终止下一步的操作，**此时，系统的`exit code`为101；**
+
+> 关于Serverless Devs开发者工具，涉及到的 Exit Code，可以参考[开发者工具设计文档](../tool.md)
+
+## 服务级操作
+
+在当前项目下，可以执行`s [服务名] [自定义命令]`实现服务级操作。
+
+- 执行`s backend deploy`等，可以针对服务`backend`进行`deploy`相关的操作，**如果顺利完成与其操作，系统的`exit code`为0；否则，出现错误，系统的`exit code`为101**；
+- 执行`s admin-frontend test`是，由于服务`admin-frontend`对应的`test`方法是不存在的，**此时系统将会认为是未找到组件方法，系统的`exit code`为100**；
+
+## 注意事项
+
+在上面[应用级操作](#应用级操作)和[服务级操作](#服务级操作)中，我们不难发现，同样是某些组件不包括对应方法，但是在[应用级操作](#应用级操作)和[服务级操作](#服务级操作)中的表现形式却不同，这里的设计思路主要是为了保证[应用级操作](#应用级操作)的流畅性。所以其规律通常如下：
+
+1. [应用级操作](#应用级操作)更多是一种批量操作，会按照[Serverless User Model所定义的服务顺序](../../../spec/zh/0.0.1/serverless_user_model/3.user_model.md#服务顺序)对应用下的所有服务进行分别操作；所以，此时如果出现某个服务对应的组件不包括当前方法，会以"批量操作"作为理由，跳过该服务，进行警告后继续执行，**此时，系统的`exit code`为0；**
+2. [服务级操作](#服务级操作)更多是一种针对某个应用下的某个服务的特定操作，此时如果找不到对应的方法，则意味着本次操作没有意义，将会惊醒错误报告，**此时，系统的`exit code`为100；**