作者 | Anycodes
众所周知，随着时间的发展，Serverless 命令行工具也逐渐的玩出了更多的花样，就目前来看，常见的形态有两种，一种是通过 Yaml 来进行资源的描述，另外一种是纯粹的命令行操作，而不依赖这些内容。
第一种通过 Yaml 来进行资源描述，其好处不言而喻，目前主流的 Serverless 开发者工具均是类似的模式，例如阿里云的 Funcraft，著名的开源项目 Serverless Framework 等，通过 Yaml，使用者可以通过简单的命令，进行复杂的操作，例如开发者在 Yaml 中描述好服务、函数等配置，描述好代码位置，只需要 deploy 就可以将本地项目部署到线上，非常方便。但是这里有一个非常明显的劣势，在很多时候我们的企业管理者，给每个人分配的权限是固定的，例如运维人员只能更新某些内容，开发人员只能更新某些代码，某些负责可以发布版本等，那么这个时候”一把梭”的行为就显得非常尴尬，想为开发者做更多，但是有些开发者不需要你做更多，那么”高阶能力”和”原子能力”的平衡就显得至关重要的。
第二种模式，虽然是不需要依赖 Yaml，在很多时候使用起来可能会稍微复杂一些，例如我们创建一个函数可能涉及到很多流程：创建服务，创建函数，创建触发器…，相对比上面所说的一条指令而言，确实复杂很多，但是这种无 Yaml 的模式，更适合做原子操作，可以最大程度解决上述问题，同时这种做法也可以在一定程度上进行更多的拓展，例如某些本不需要依赖 Yaml 的行为：查询服务列表，查询函数列表……
所以这两种模式各有优缺点，我们在使用的时候完全可以组合来使用，达到最大的一个生产效能。那么一个新问题来了，以阿里云函数计算为例，如何同时拥有这两种模式的使用方法呢？
其实 Serverless Devs 天然支持 Yaml 描述和非 Yaml 描述的能力，例如阿里云函数计算的 FC 组件就是一个可以依靠 Yaml 描述进行资源操作的组件，而 FC-API 组件则是 API 相关的原子性操作。
本文将会以这样一个案例/场景为例，为读者介绍这两者的使用方法：
1.通过 Serverless Devs 快速创建一个服务/函数/触发器
2.通过无 Yaml 的模式对其中的代码部分进行单独的更新
3.更新之后发布一个版本
4.通过 Git+Github Action 实现一个代码自动化发布和版本自动化发布的能力
快速创建函数
我们只需要通过s init并且选择阿里云函数计算的 Python3 Http 函数即可：
创建完成之后，我们只需要进入到对应的文件夹，并且执行s deploy，即可将项目快速部署到线上。在进入到项目后，我们可以在项目下看到一个s.yaml的文件，这个文件就是资源描述文件：
其完整的描述：
https://github.com/devsapp/fc/blob/main/docs/Others/yaml.md
此时我们可以通过s deploy进行项目的部署：
部署完成，我们可以打开系统分配给我们的域名，我们可以看到内容：
通过无 Yaml 模式更新函数
我们可以编辑index.py，将Hello world!变为Hello world Serverless Devs!
然后我们就要接触一个新的组件 FC-API ：
https://github.com/devsapp/fc-api
我们可以执行帮助文档：s cli fc-api -h：
此时我们需要明确的是，当我们执行s cli的时候，系统就不去读 Yaml，而直接进行相关方法的调用。
如果我们对这个方法还是不清楚，我们可以：s cli fc-api updateFunction -h
此时我们只需要按照规范，填写好地区，服务名，函数名，以及要更新的字段即可：
s cli fc-api updateFunction --region cn-hangzhou --serviceName fc-deploy-service --functionName http-trigger-function--code '{"zipFile": "./"}'
完成之后，我们可以再去看一下之前的页面是否同步更新了：
此处可能有疑问，你的帮助文档写的是：--code string [JSON String] The code of the function. The code must be packaged into a ZIP file.
你是怎么知道传递--code '{"zipFile": "./"}'的？
因为在我们看帮助文档的时候，题已经提醒了我们这是一个 JSON String，同时在帮助文档最上面是有链接地址：
```
Usage
s cli fc-api updateFunction
API Document: https://help.aliyun.com/document_detail/189986.html
Options
--region stringThe region of fc endpoint.
--access stringSpecify the key name.
--props stringThe json string of props.
--serviceName stringThe name of the service.
--functionName stringThe description of the function.
--code string[JSON String]The code of the function.The code must be packaged into a ZIP file.
>此时，我们可以打开 https://help.aliyun.com/document_detail/189986.html：
>此时为了方便，Serverless devs 支持本地路径，会帮助你进行打包等操作。
当然，我们还可以更刺激一些，修改其他内容，如单纯修改一些 timeout:
s cli fc-api updateFunction —region cn-hangzhou —serviceName fc-deploy-service —functionName http-trigger-function —timeout 70
## 通过无 Yaml 模式发布版本
和上面一样，我们可以用`s cli fc-api -h `查看一下版本发布的方法：`s cli fc-api publishVersion -h`
尝试拼接参数：
s cli fc-api publishVersion —region cn-hangzhou —serviceName fc-deploy-service —description “This is a test version”
得到结果：
## CI/CD 组件的使用
当我们想要把上面只更新代码，发布版本的能力集成到 CI/CD，或者某些自动化流程中，如何操作呢？
以 GithubAction 为例，我们可以直接执行`s cli cicd`:
接下来，我们对`./.github/workflow/serverless-devs.yml`进行自定义编辑：
```yaml
name: Serverless Devs Project CI/CD
on:
push:
branches: [ master ]
jobs:
serverless-devs-cd:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- uses: actions/setup-node@v2
with:
node-version: 12
registry-url: https://registry.npmjs.org/
- run: npm install
- run: npm install -g @serverless-devs/s
# 默认密钥配置指令是阿里云密钥配置指令，更多可以参考：
# 如何通过 Github Action使用Serverless Devs 做 CI/CD：http://short.devsapp.cn/cicd/github/action/usage
# Serverless Devs 的官网是通过 Serverless Devs 部署的: http://short.devsapp.cn/cicd/github/action/practice
- run: s config add --AccountID ${{secrets.AccountID}} --AccessKeyID ${{secrets.AccessKeyID}} --AccessKeySecret ${{secrets.AccessKeySecret}} -a default
- run: s cli fc-api updateFunction --region cn-hangzhou --serviceName fc-deploy-service --functionName http-trigger-function --code '{"zipFile":"./"}'
- run: s cli fc-api publishVersion --region cn-hangzhou --serviceName fc-deploy-service
我们只是在最后加了两个人 run，一个是发布代码，一个是发布版本，此时我们可以创建一个 Github 仓库，尝试一下：
创建完成之后，我们可以按照案例提醒，进行密钥的配置：
# 默认密钥配置指令是阿里云密钥配置指令，更多可以参考：
# 如何通过 Github Action 使用 Serverless Devs 做 CI/CD：http://short.devsapp.cn/cicd/github/action/usage
# Serverless Devs 的官网是通过 Serverless Devs 部署的: http://short.devsapp.cn/cicd/github/action/practice
接下来， 我们通过 git init 等一系列指令，完成代码推到仓库：
此时，我们再次修改代码：
修改完成之后，我们将代码 push 到测试仓库，可以看到，我们在 Action 中可以看到一个 workflow 在执行：
稍等片刻，当这个流程完成：
我们打开之前的页面，可以看到，网页内容已经顺利被更新：
总结
本文以阿里云为例，通过在 Github 上使用 Servelress Devs 单纯对代码进行更新，并进行版本发布，该流程是比较常见的，也是比较通用的，希望读者可以发挥想象力，将这个流程应用到自己的项目中。
(文章转载自 Go Serverless）
Serverless Devs 参与的贡献
Serverless Devs 的开源为国内外开发者提供了 Serverless 工具的新选择，让开发者可以以更短的路径体验到多云 Serverless 产品，以更快的速度创建和部署 Serverless 应用，以更简单和更自动化的方法进行项目管理/运维，未来期待更多开发者参与共建。
目前代码已经在 Gitee(码云）和 GitHub 上正式开放：
- Github 地址：https://github.com/serverless-devs
- Gitee 地址：https://gitee.com/organizations/serverless-devs/projects
- Serverless Devs 官网：https://www.serverless-devs.com