@serverless-devs/s 2.0.95-beta.2 → 2.0.96

package/docs/readme.md

@@ -51,7 +51,7 @@ $ npm install @serverless-devs/s -g
 
 > 如果您想为 Serverless Devs 贡献 Package（包括组件和应用），您可以参考 [Package开发文档](zh/package_dev.md)  
 
-> Serverless Devs 天然支持 Yaml 模式与 Cli 模式，关于两者的区别和试用场景，可以参考文档[ Yaml 模式 Cli 模式对比](./../yaml_and_cli.md)
+> Serverless Devs 天然支持 Yaml 模式与 Cli 模式，关于两者的区别和试用场景，可以参考文档[ **Yaml 模式 Cli 模式对比**](./zh/yaml_and_cli.md)；关于[**Exit Code 定义**](./zh/tool.md#exit-code-定义)、[**Yaml 文件优先级规范**](./zh/tool.md#yaml-文件优先级规范)、[**密钥使用顺序与规范**](./zh/tool.md#密钥使用顺序与规范)、[**通过环境变量设置密钥**](./zh/tool.md#通过环境变量设置密钥)更多关于项目设计的一些细节可以参考[**开发者工具设计文档**](./zh/tool.md) 
 
 # 相关资源
 
@@ -67,6 +67,12 @@ $ npm install @serverless-devs/s -g
 
 > 🚀 除此之外 Serverless Devs 项目还拥有很多优秀的组件和应用，可以参考[Awesome](./zh/awesome.md)
 
+# 项目期望
+
+- Serverless Devs 希望可以为 Serverless 开发者们提供一款可以无厂商锁定的，可以在 Serverless 应用全生命周期发挥作用的 Serverless 开发者工具；
+- Serverless Registry 希望可以为 Serverless 生态提供一套完整的包管理规范，与 Python 中的 pypi， Nodejs 中的 npm 等类似，将以此来开放和分享 Serverless Package，建设 Serverless 生态；
+- Serverless Developer Meetup 希望可以打造最符合 Serverless 开发者的社区活动，通过这个活动，我们希望更多人可以一起和我们交流、学习 Serverless 相关的产品；
+
 # 项目贡献
 
 我们非常希望您可以和我们一起贡献这个项目。贡献内容包括不限于代码的维护、应用/组件的贡献、文档的完善等，更多详情可以参考[ 🏆 贡献指南](../CONTRIBUTING.md)。
@@ -91,4 +97,4 @@ Serverless Devs 遵循 [MIT License](../LICENSE) 开源许可。
 
 -----------
 
-> Serverless Devs 开发者工具遵循 [Serverless Devs Model](../spec/readme.md)，更多模型/规范信息可以参考 [Serverless Registry Model](../spec/zh/0.0.1/serverless_registry_model/readme.md)，[Serverless User Model](../spec/zh/0.0.1/serverless_user_model/readme.md) 以及 [Serverless Package Model](../spec/zh/0.0.1/serverless_pacakge_model/readme.md)；另外，关于项目设计的一些细节可以参考[开发者工具设计文档](./zh/tool.md)
+> Serverless Devs 开发者工具遵循 [Serverless Devs Model](../spec/readme.md)，更多模型/规范信息可以参考 [Serverless Registry Model](../spec/zh/0.0.1/serverless_registry_model/readme.md)，[Serverless User Model](../spec/zh/0.0.1/serverless_user_model/readme.md) 以及 [Serverless Package Model](../spec/zh/0.0.1/serverless_pacakge_model/readme.md)；

package/docs/zh/awesome.md

@@ -1,296 +1,20 @@
-# Package Awesome
+# Awesome
 
-- [应用集合](#应用集合)
-- [组件集合](#组件集合)
+## 组件集合
 
+- [阿里云函数计算（FC）](https://github.com/devsapp/fc)
+- [阿里云Serverless应用引擎（FC）](https://github.com/devsapp/sae)
+- [AWS Lambda](https://github.com/devscomp/lambda)
+- [百度智能云函数计算（CFC）](https://github.com/xinwuyun/cfc)
+- [华为云函数工作流（FG）](https://github.com/xinwuyun/fg)
+- [腾讯云云函数（SCF）](https://github.com/devscomp/scf)
 
-# 应用集合
+## 应用集合
 
-## Web Framework应用案例
+- [阿里云相关应用合集](https://github.com/devsapp/awesome)
+- [AWS Lambda](https://github.com/devscomp/start-lambda)
+- [百度智能云函数计算（CFC）](https://github.com/xinwuyun/start-cfc)
+- [华为云函数工作流（FG）](https://github.com/xinwuyun/start-fg)
+- [腾讯云云函数（SCF）](https://github.com/devscomp/start-scf)
 
-<table>
-<tr>
-<th>No.</th>
-<th>:fire:Nodejs</th>
-<th>Python</th>
-<th>PHP</th>
-<th>Go</th>
-<th>Java</th>
-<th>Others</th>
-</tr>
-<tr>
-<td align="center">1</td>
-<td align="center">:fire:<a href="https://github.com/devsapp/start-express">Express</a></td>
-<td align="center">:fire::fire:<a href="https://github.com/devsapp/start-flask">Flask</a></td>
-<td align="center"><a href="https://github.com/devsapp/start-thinkphp">Think PHP</a></td>
-<td align="center">BeeGo</td>
-<td align="center">Tomcat/Jetty</td>
-<td align="center">Gatsby</td>
-</tr>
-<tr>
-<td align="center">2</td>
-<td align="center"><a href="https://github.com/devsapp/start-egg">Egg</a></td>
-<td align="center"><a href="https://github.com/devsapp/start-tornado">Tornado</a></td>
-<td align="center"><a href="https://github.com/devsapp/start-laravel">laravel</a></td>
-<td align="center">Gin</td>
-    <td align="center"><a href="https://github.com/devsapp/start-springboot">Spring Boot</a></td><td>Hugo</td>
-</tr>
-<tr>
-<td align="center">3</td>
-<td align="center"><a href="https://github.com/devsapp/start-next">Nextjs</a></td>
-<td align="center"><a href="https://github.com/devsapp/start-bottle">Bottle</a></td>
-    <td align="center"><a href="https://github.com/devsapp/start-discuz">Discuz</a></td><td></td><td align="center">Quarkus</td>
-<td align="center"></td>
-</tr>
-<tr>
-<td align="center">4</td>
-<td align="center"><a href="https://github.com/devsapp/start-nuxt">Nuxtjs(Container)</a><br><a href="https://github.com/devsapp/custom-nuxt">Nuxtjs(Custom)</a></td>
-<td align="center"><a href="https://github.com/devsapp/start-webpy">Web.py</a></td>
-<td align="center"> :fire::fire::fire: <a href="https://github.com/devsapp/start-wordpress" >WordPress</a></td><td></td><td></td>
-<td align="center"></td>
-</tr>
-<tr>
-<td align="center">5</td>
-<td align="center"> :fire::fire::fire: <a href="https://github.com/devsapp/start-hexo" >Hexo</a></td>
-<td align="center"><a href="https://github.com/devsapp/start-django" >Django</a></td>
-<td align="center"> :fire::fire::fire: <a href="https://github.com/devsapp/start-zblog" >Zblog</a></td><td></td><td></td>
-<td align="center"></td>
-</tr>
-<tr>
-<td align="center">6</td>
-<td align="center"><a href="https://github.com/devsapp/start-koa">Koa(Container)</a><br><a href="https://github.com/devsapp/nodejs-koa">Koa(Node.js Runtime)</a></td>
-    <td align="center">FastAPI</td>
-<td align="center"><a href="https://github.com/devsapp/start-ecshop" >Ecshop</a></td><td></td><td></td><td></td>
-</tr>
-<tr>
-<td align="center">7</td>
-<td align="center"><a href="https://github.com/devsapp/start-hapi" >Hapi</a></td>
-<td align="center">Web2py</td>
-<td align="center"><a href="https://github.com/devsapp/start-metinfo" >Metinfo</a></td>
-    <td></td><td></td><td></td>
-</tr>
-<tr>
-<td align="center">8</td>
-    <td align="center"><a href="https://github.com/devsapp/start-expresscart">Expresscart</a></td>
-<td align="center"><a href="https://github.com/devsapp/start-pyramid" >Pyramid</a></td>
-<td align="center"><a href="https://github.com/devsapp/start-whatsns" >Whatsns</a></td><td></td><td></td><td></td>
-</tr>
-<tr>
-<td align="center">9</td>
- <td align="center"></td>
-<td align="center"></td>
-<td align="center"><a href="https://github.com/devsapp/start-typecho" >Typecho</a></td><td></td><td></td><td></td>
-</tr>
-</table>
-
-## 静态网站应用案例
-
-静态网站案例：https://github.com/devsapp/website-example
-- 普通静态资源应用: `s init devsapp/website-example:website-base`
-- react应用 `s init devsapp/website-example:website-react`
-- vue应用 `s init devsapp/website-example:website-vue`
-- hexo应用 `s init devsapp/website-example:website-hexo`
-- docusaurus应用 `s init devsapp/website-example:website-docusaurus`
-- vuepress应用 `s init devsapp/website-example:website-vuepress`
-
-## 开源框架应用案例
-- Midway FaaS：https://github.com/devsapp/midway-hook-example
-    - react模板: `s init devsapp/midway-hook-example:midway-hook-react`
-    - vue模板 `s init devsapp/midway-hook-example:midway-hook-vue`
-- Malagu：https://github.com/devsapp/start-s-malagu
-
-## 场景合集
-
-### Blog集合
-- Zblog:  https://github.com/devsapp/start-zblog    `s init devsapp/start-zblog`
-- Wordpress:  https://github.com/devsapp/start-wordpress    `s init devsapp/start-wordpress`
-- Hexo:  https://github.com/devsapp/start-hexo    `s init devsapp/start-hexo`
-- Vuepress:  https://github.com/devsapp/website-example    `s init devsapp/website-example:website-vuepress`
-- Django Blog: https://github.com/devsapp/django-blog    `s init devsapp/django-zblog` 
-- Typecho: https://github.com/devsapp/start-typecho    `s init devsapp/start-typecho` 
-
-### 企业官网
-- Metinfo: https://github.com/devsapp/start-metinfo   `s init devsapp/start-metinfo`
-
-### 社区问答
-- Whatsns: https://github.com/devsapp/start-whatsns   `s init devsapp/start-whatsns`
-- Discuz: https://github.com/devsapp/start-discuz   `s init devsapp/start-discuz`
-
-### 电子商务
-- Echsop： https://github.com/devsapp/start-ecshop    `s init devsapp/start-ecshop`
-- Expresscart： https://github.com/devsapp/start-expresscart    `s init devsapp/start-expresscart`
-
-### 其他
-- 该项目模板是一个基于 puppeteer 的截图 Web 应用: 
-    - https://github.com/devsapp/puppeteer-app    `s init devsapp/puppeteer-app`
-    - https://github.com/devsapp/start-puppeteer    `s init devsapp/start-puppeteer`
-- 一款基于人工智能的目标检测应用: https://github.com/devsapp/image-prediction-app    `s init devsapp/image-prediction-app`
-- 一款基于Node.JS的网页TodoList应用: https://github.com/devsapp/todolist-app    `s init devsapp/todolist-app`
-- 基于函数计算 FC + FFmpeg 实现 Serverless 架构的弹性高可用的高度自定义音视频处理主题: https://github.com/devsapp/ffmpeg-app    `s init devsapp/ffmpeg-app`
-- 对直播视频流截图的应用: https://github.com/devsapp/start-rtmp-snapshot   `s init start-rtmp-snapshot`
-- 一个对浏览器全景录制: https://github.com/devsapp/start-headless-ffmpeg   `s init start-headless-ffmpeg`
-- 一个word转pdf的应用: https://github.com/devsapp/start-word2pdf   `s init start-word2pdf`
-- 一个pdf转图片的应用: https://github.com/devsapp/start-pdf2img   `s init start-pdf2img`
-- 在Serverless架构玩转pyTorch: https://github.com/devsapp/start-pytorch   `s init start-pytorch`
-- 在Serverless架构玩转Tensorflow: https://github.com/devsapp/start-tensorflow   `s init start-tensorflow`
-- Serverless架构的OCR工具: https://github.com/devsapp/start-ocr   `s init start-ocr`
-
-
-## 静态网站应用案例
-
-静态网站案例：https://github.com/devsapp/website-example
-- 普通静态资源应用: `s init devsapp/website-example:website-base`
-- react应用 `s init devsapp/website-example:website-react`
-- vue应用 `s init devsapp/website-example:website-vue`
-- hexo应用 `s init devsapp/website-example:website-hexo`
-- docusaurus应用 `s init devsapp/website-example:website-docusaurus`
-- vuepress应用 `s init devsapp/website-example:website-vuepress`
-
-## Alinode
-可观测性：
-    - Insight： https://github.com/devsapp/alinode-faas-insight    
-    - Runtime Http:  https://github.com/devsapp/alinode-runtime-http    
-    - FaaS Logs:  https://github.com/devsapp/alinode-faas-sls-log    
-    - Runtime Deploy:  https://github.com/devsapp/alinode-runtime-deploy
-
-## 开源框架应用案例
-- Midway FaaS：https://github.com/devsapp/midway-hook-example
-    - react模板: `s init devsapp/midway-hook-example:midway-hook-react`
-    - vue模板 `s init devsapp/midway-hook-example:midway-hook-vue`
-- Malagu：https://github.com/devsapp/start-s-malagu
-
-## 场景合集
-
-### Blog集合
-- Zblog:  https://github.com/devsapp/start-zblog    `s init devsapp/start-zblog`
-- Wordpress:  https://github.com/devsapp/start-wordpress    `s init devsapp/start-wordpress`
-- Hexo:  https://github.com/devsapp/start-hexo    `s init devsapp/start-hexo`
-- Vuepress:  https://github.com/devsapp/website-example    `s init devsapp/website-example:website-vuepress`
-- Django Blog: https://github.com/devsapp/django-blog    `s init devsapp/django-zblog` 
-- Typecho:  https://github.com/devsapp/start-typecho    `s init devsapp/start-typecho`
-
-### 企业官网
-- Metinfo: https://github.com/devsapp/start-metinfo   `s init devsapp/start-metinfo`
-
-### 社区问答
-- Whatsns: https://github.com/devsapp/start-whatsns   `s init devsapp/start-whatsns`
-- Discuz: https://github.com/devsapp/start-discuz   `s init devsapp/start-discuz`
-
-### 电子商务
-- Echsop： https://github.com/devsapp/start-ecshop    `s init devsapp/start-ecshop`
-- Expresscart： https://github.com/devsapp/start-expresscart    `s init devsapp/start-expresscart`
-
-### 其他
-- 该项目模板是一个基于 puppeteer 的截图 Web 应用: 
-    - https://github.com/devsapp/puppeteer-app    `s init devsapp/puppeteer-app`
-    - https://github.com/devsapp/start-puppeteer    `s init devsapp/start-puppeteer`
-- 一款基于人工智能的目标检测应用: https://github.com/devsapp/image-prediction-app    `s init devsapp/image-prediction-app`
-- 一款基于Node.JS的网页TodoList应用: https://github.com/devsapp/todolist-app    `s init devsapp/todolist-app`
-- 基于函数计算 FC + FFmpeg 实现 Serverless 架构的弹性高可用的高度自定义音视频处理主题: https://github.com/devsapp/ffmpeg-app    `s init devsapp/ffmpeg-app`
-- 对直播视频流截图的应用: https://github.com/devsapp/start-rtmp-snapshot   `s init start-rtmp-snapshot`
-- 一个对浏览器全景录制: https://github.com/devsapp/start-headless-ffmpeg   `s init start-headless-ffmpeg`
-- 一个word转pdf的应用: https://github.com/devsapp/start-word2pdf   `s init start-word2pdf`
-- 一个pdf转图片的应用: https://github.com/devsapp/start-pdf2img   `s init start-pdf2img`
-- 在Serverless架构玩转pyTorch: https://github.com/devsapp/start-pytorch   `s init start-pytorch`
-- 在Serverless架构玩转Tensorflow: https://github.com/devsapp/start-tensorflow   `s init start-tensorflow`
-- Serverless架构的OCR工具: https://github.com/devsapp/start-ocr   `s init start-ocr`
-
-
-# 组件集合
-
-## 基础组件
-
-- 阿里云
-    - 函数计算（FC）：
-        - Yaml描述：https://github.com/devsapp/fc
-        - 命令行交互：https://github.com/devsapp/fc-api （可以在无Yaml模式下直接进行使用）
-    - Serverless工作流（FNF）：https://github.com/devsapp/fnf
-- 腾讯云
-    - 云函数（SCF）：https://github.com/devscomp/scf
-- AWS
-    - Lambda：https://github.com/devscomp/lambda
-- 百度云
-    - 函数计算（CFC）：https://github.com/xinwuyun/cfc
-- 华为云
-    - 函数工作流（FG）：https://github.com/xinwuyun/fg
-
-
-
-
-## 上层组件
-
-<table>
-<tr>
-<th>No.</th>
-<th>:fire:Nodejs</th>
-<th>Python</th>
-<th>PHP</th>
-<th>Go</th>
-<th>Java</th>
-<th>Others</th>
-</tr>
-<tr>
-<td align="center">1</td>
-<td align="center">:fire:<a href="https://github.com/devsapp/express">Express</a></td>
-<td align="center">:fire::fire:<a href="https://github.com/devsapp/flask">Flask</a></td>
-<td align="center"><a href="https://github.com/devsapp/thinkphp">Think PHP</a></td>
-<td align="center">BeeGo</td>
-<td align="center">Tomcat/Jetty</td>
-<td align="center">Gatsby</td>
-</tr>
-<tr>
-<td align="center">2</td>
-<td align="center"><a href="https://github.com/devsapp/egg">Egg</a></td>
-<td align="center"><a href="https://github.com/devsapp/tornado">Tornado</a></td>
-<td align="center"><a href="https://github.com/devsapp/laravel">laravel</a></td>
-<td align="center">Gin</td>
-<td align="center">Spring Boot</td>
-<td align="center">Hugo</td>
-</tr>
-<tr>
-<td align="center">3</td>
-<td align="center"><a href="https://github.com/devsapp/next">Nextjs</a></td>
-<td align="center"><a href="https://github.com/devsapp/bottle">Bottle</a></td>
-<td align="center"><a href="https://github.com/devsapp/discuz">Discuz</a></td><td></td><td align="center">Quarkus</td>
-<td align="center">:fire::fire:<a href="https://github.com/devsapp/midway-hook">Midway FaaS</a></td>
-</tr>
-<tr>
-<td align="center">4</td>
-<td align="center"><a href="https://github.com/devsapp/nuxt">Nuxtjs</a></td>
-<td align="center"><a href="https://github.com/devsapp/webpy">Web.py</a></td>
-<td align="center"> :fire::fire::fire: <a href="https://github.com/devsapp/wordpress" >WordPress</a></td><td></td><td></td>
-<td align="center">:fire:<a href="https://github.com/devsapp/s-malagu">Malagu</a></td>
-</tr>
-<tr>
-<td align="center">5</td>
-<td align="center"> :fire::fire::fire: <a href="https://github.com/devsapp/hexo" >Hexo</a></td>
-<td align="center"><a href="https://github.com/devsapp/django" >Django</a></td>
-<td align="center"> :fire::fire::fire: <a href="https://github.com/devsapp/zblog" >Zblog</a></td><td></td><td></td>
-<td align="center">:fire::fire::fire:<a href="https://github.com/devsapp/website">Website</a></td>
-</tr>
-<tr>
-<td align="center">6</td>
-<td align="center"><a href="https://github.com/devsapp/koa" >Koa</a></td>
-<td align="center">FastAPI</td>
-<td align="center"><a href="https://github.com/devsapp/ecshop" >Ecshop</a></td><td></td><td></td><td></td>
-</tr>
-<tr>
-<td align="center">7</td>
-<td align="center"><a href="https://github.com/devsapp/hapi" >Hapi</a></td>
-<td align="center">Web2py</td>
-<td align="center"><a href="https://github.com/devsapp/metinfo" >Metinfo</a></td>
-    <td></td><td></td><td></td>
-</tr>
-<tr>
-<td align="center">8</td>
-<td align="center"></td>
-<td align="center"><a href="https://github.com/devsapp/pyramid" >Pyramid</a></td>
-<td align="center"><a href="https://github.com/devsapp/whatsns" >Whatsns</a></td><td></td><td></td><td></td>
-</tr>
-<tr>
-<td align="center">9</td>
-<td align="center"></td>
-<td align="center"></td>
-<td align="center"><a href="https://github.com/devsapp/typecho" >Typecho</a></td><td></td><td></td><td></td>
-</tr>
-</table>
+> 如果您有相关的案例，欢迎您提PR到本文件。

package/docs/zh/cicd.md

@@ -3,6 +3,7 @@
 - [与 Github Action 的集成](#与-github-action-的集成)
 - [与 Gitee Go 的集成](#与-gitee-go-的集成)
 - [与 Jenkins 的集成](#与-jenkins-的集成)
+- [与云效的集成](#与云效的集成)
 - [注意事项](#注意事项)
 
 ## 与 Github Action 的集成
@@ -188,6 +189,36 @@ jenkins-alicloud-access-key-secret : 阿里云 accessKeySecret
 > 关于密钥配置的部分注意内容，可以参考文末的[注意事项](#注意事项)
 
 
+## 与云效的集成
+
+在云效中，可以直接选择Serverless Devs开发者工具，并在自定义命令中，输入以下内容即可：
+
+```
+# input your command here
+npm install -g @serverless-devs/s
+s config add --AccountID ${ACCOUNTID} --AccessKeyID ${ACCESSKEYID} --AccessKeySecret ${ACCESSKEYSECRET} -a default
+s deploy
+```
+
+这里主要包括三个部分：
+   
+- `npm install -g @serverless-devs/s`:    
+    通过NPM安装最新版本的 Serverless Devs 开发者工具（虽然云效中已经拥有了相关版本的Serverless Devs，但是实际上，这个版本可能比较老旧，所以可以通过该命令安装最新版本）；
+- `s config add --AccountID ${ACCOUNTID} --AccessKeyID ${ACCESSKEYID} --AccessKeySecret ${ACCESSKEYSECRET} -a default`    
+    通过`config`命令进行密钥等信息的配置；
+- `s deploy`   
+    执行某些命令，例如通过`deploy`进行项目的部署，或者`build`等命令进行构建等；
+
+效果如下：
+
+![image](https://user-images.githubusercontent.com/21079031/144697943-2ce9ea56-7af8-4c3b-945b-6897e6d744b5.png)
+
+由于在命令中，引用了三个重要的环境变量：`ACCOUNTID`, `ACCESSKEYID`, `ACCESSKEYSECRET`，所以还需要在环境变量中，增加类似的内容：
+
+![image](https://user-images.githubusercontent.com/21079031/144699074-3dad63d7-835f-4eb8-bd95-662de683dbbc.png)
+
+
+
 ## 注意事项
 
 - 在配置密钥的时候，使用了`s config add`命令，此时在最后有一个参数是`-a default`，代表的是给该密钥一个叫`default`的别名，这个别名要和项目所设定的使用密钥保持一致，例如在`s.yaml`中的`access`字段；

package/docs/zh/command/component.md

@@ -60,7 +60,6 @@ $ s component
 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]

package/docs/zh/command/config.md

@@ -13,7 +13,8 @@
     - [参数解析](#参数解析-2)
     - [操作案例](#操作案例-2)
 - [注意事项](#注意事项)
-    - [通过环境变量配置密钥信息](#通过环境变量配置密钥信息)
+    - [通过环境变量设置密钥](#通过环境变量设置密钥)
+    - [关于配置密钥的使用顺序](#关于配置密钥的使用顺序)
     
 ## 命令解析
 
@@ -166,7 +167,6 @@ google:     PrivateKeyData
 >     - [华为云](./../default_provider_config/huaweicloud.md)
 >     - [腾讯云](./../default_provider_config/tencentcloud.md)
 
-
 ## config get 命令
 
 通过`config get`命令，您可以获得配置过的账号信息。
@@ -265,14 +265,10 @@ Key [test] has been successfully removed
 
 ## 注意事项
 
-### 通过环境变量配置密钥信息
-
-在某些时候，密钥是不方便直接进行配置到 Serverless Devs 工具中，此时可以考虑将密钥信息放在环境变量中。
+### 通过环境变量设置密钥
 
-例如，此时需要配置的密钥名为`s_secrets`，就可以在环境变量中，增加：
+详情可以参考：[开发者工具设计文档](../tool.md) 中的 [通过环境变量设置密钥](../tool.md#通过环境变量设置密钥)
 
-```text
-s_secrets="{\"Key1\":\"Value1\",\"Key2\":\"Value2\"}"
-```
+### 关于配置密钥的使用顺序
 
-此时就可以在使用是通过`${env(s_secrets)}`进行指定的环境变量密钥使用。
+详情可以参考：[开发者工具设计文档](../tool.md) 中的 [通过环境变量设置密钥](../tool.md#密钥使用顺序与规范)

package/docs/zh/command/init.md

@@ -67,30 +67,31 @@ $ s init
 
 ```shell script
 ? Please select an Serverless-Devs Application (Use arrow keys or type to search)
-❯ fc-runtime-starter - 快速部署一个 FC 函数 
-  fc-custom-container-stater - 快速部署一个 custom-container 应用 
-  web-framework-stater - 快速部署一个 Web 框架 
-  static-website-stater - 快速部署一个静态网站 
-  serverless-best-practice - 快速体验 Serverless 最佳实践 
+❯ Quick start [Deploy a Hello World function to FaaS] 
+  Container example [Deploy function to FaaS with custom-container] 
+  Web Framework [Deploy a web framework to FaaS] 
+  Static website [Deploy a static website] 
+  Best practice [Experience serverless project] 
 ```
 
 此时可以继续选择某分类下的具体应用进行初始化，例如选择`fc-runtime-starter`之后，可以看到该分类下的具体模板应用：
 
 ```shell script
-? Please select an templete (Use arrow keys or type to search)
-❯ fc-http-nodejs - 快速部署一个 nodejs12 http函数 
-  fc-http-python - 快速部署一个 python3 http函数 
-  fc-http-php - 快速部署一个 php http函数 
-  fc-http-java - 快速部署一个 java8 http函数 
-  fc-event-nodejs - 快速部署一个 nodejs12 event函数 
-  fc-event-python - 快速部署一个 python3 event函数 
-  fc-event-php - 快速部署一个 php event函数 
+? Which template do you like? (Use arrow keys or type to search)
+❯ [HTTP] Node.js 12 
+  [HTTP] Python3 
+  [HTTP] Java8 
+  [HTTP] PHP7 
+  [HTTP] C++ (custom) 
+  [Event] Node.js 12 
+  [Event] Python3 
+(Move up and down to reveal more choices)
 ```
 
 选择`fc-http-nodejs`即可完成创建：
 
 ```shell script
-jiangyu@ServerlessSecurity demo % s init                                         
+$ s init                                         
 
 🚀 Serverless Awesome: https://github.com/Serverless-Devs/package-awesome
 

package/docs/zh/command/set.md

@@ -5,8 +5,8 @@
 - [命令解析](#命令解析)
 - [set registry 命令](#set-registry-命令)
 - [set locale 命令](#set-locale-命令)
-- [[FEATURE] set analysis 命令](#feature-set-analysis-命令)
-- [[FEATURE] set workspace 命令](#feature-set-workspace-命令)
+- [set analysis 命令](#feature-set-analysis-命令)
+- [set workspace 命令](#feature-set-workspace-命令)
 
 ## 命令解析
 
@@ -118,7 +118,7 @@ Options:
 
 > 🙊 注：系统默认的 locale 是：`zh`
 
-## [FEATURE] set analysis 命令
+## set analysis 命令
 
 通过该命令，可以对 Serverless Devs 开发者工具的数据分析能力进行配置。  
 
@@ -155,7 +155,7 @@ Options:
 
 > 🙊 注：系统默认的 analysis 是：`enable`
 
-## [FEATURE] set workspace 命令
+## set workspace 命令
 
 通过该命令，可以对 Serverless Devs 开发者工具的默认路径进行配置。 
 

package/docs/zh/readme.md

@@ -68,7 +68,9 @@ Serverless Devs 的模型设计原则，是希望可以通过更加简单、科
 - 2021年6月，Serverless Devs 下载次数突破 10000
 - 2021年7月，Serverless Developer Meetup 在杭州召开，阿里云函数计算团队在会上正式发布端云联调、桌面客户端等功能
 - 2021年8月，Serverless Devs 下载次数突破 20000
-- 2021年10月，在***2021 OpenInfra Days China***会议上，Serverless Devs 带来了《Serverless Devs：Serverless全生命周期的工具链建设》的主题演讲
+- 2021年10月，在 2021 OpenInfra Days China 会议上，Serverless Devs 带来了《Serverless Devs：Serverless全生命周期的工具链建设》的主题演讲
+- 2021年12月，Serverless Developer Meetup 在深圳召开，并尝试性的对外展示了Serverless Devs Model
+
 
 ## 未来展望
 
@@ -77,7 +79,7 @@ Serverless Devs 将会在未来支持：
 - 将会开发和上线 Serverless Devs IDE Plugin；
 - 将会持续推动 Serverless 生态尤其是 Serverless 工具链生态的前进；
 
-关于我们的 Roadmap，可以参考 [Github Projects](#https://github.com/Serverless-Devs/Serverless-Devs/projects) 。
+关于我们的 Roadmap，可以参考 [Github Projects](https://github.com/Serverless-Devs/Serverless-Devs/projects) 。
 
 ## 交流社群
 

package/docs/zh/tool.md

@@ -6,6 +6,8 @@
     - [Yaml 文件优先级规范](#yaml-文件优先级规范)
     - [应用内服务部署顺序](#应用内服务部署顺序)
     - [密钥使用顺序与规范](#密钥使用顺序与规范)
+- [通过环境变量设置密钥](#通过环境变量设置密钥)
+- []
 
 ## Exit Code 定义
 
@@ -71,10 +73,29 @@ Serverless Devs 作为 Serverless 领域的开发者工具，其输出的标准
 ### 密钥使用顺序与规范
 
 - 通过`-a/--access`参数指定的密钥信息
-- 默认使用`default`密钥信息
-- 不实用密钥信息 / 进入密钥信息配置引导
+- 使用已经配置的`default`密钥信息
+- 使用通过环境变量配置的``default_serverless_devs_access`密钥信息
+- 不使用密钥信息 / 进入密钥信息配置引导
 
 具体的流程图为：
 
 ![图片alt](https://serverless-article-picture.oss-cn-hangzhou.aliyuncs.com/1635841483040_20211102082444588067.png)
 
+## 通过环境变量设置密钥
+
+Serverless Devs可以比较容易的通过环境变量进行密钥信息的设定。通过环境变量配置密钥的方法有两种：
+
+1. 通过命令引入环境变量中的密钥：例如在环境变量中有`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)}`
+    
+## 

package/docs/zh/yaml.md

@@ -16,7 +16,11 @@
 - 拓展名可以是`.yaml`或`.yml`
 - 格式必须符合[Yaml规范](https://yaml.org/spec/1.2.2/)
 
-在默认情况下，Serverless Devs 开发者工具会默认该描述文件的名称为`s.yaml`或`s.yml`，且`s.yaml`的优先级大于`s.yml`，即在一个Serverless应用下，同时出现`s.yaml`与`s.yml`时，系统会优先识别和使用`s.yaml`。当然，开发者也可以通过`-t, --template  [templatePath]`进行指定，例如，在某应用下，资源/行为描述文件名为`test.yml`，则可以在执行相关命令时，增加参数`-t test.yml`或者`--template test.yml`
+> 👉 对于需要通过描述文件进行环境隔离的项目，建议将文件命名为 `s-${ENV}.yaml` 或 `s-${ENV}.yml` 格式。 例如：`s-prod.yaml`。
+
+在默认情况下，Serverless Devs 开发者工具会默认该描述文件的名称为`s.yaml`或`s.yml`，且`s.yaml`的优先级大于`s.yml`， 即在一个 Serverless 应用下，同时出现`s.yaml`与`s.yml`时，系统会优先识别和使用`s.yaml`。
+
+当然，开发者也可以通过`-t, --template  [templatePath]`进行指定，例如，在某应用在生产环境下的描述文件名为`s-prod.yml`，则可以在执行相关命令时，增加参数`-t s-prod.yml`或者`--template s-prod.yml`。
 
 ## 描述文件格式/规范