Aliyun Serverless VSCode Extension
是阿里云 Serverless 产品 的 VSCode 插件,该插件是结合了以及 ,为用户提供 VSCode 图形化开发调试函数计算以及操作函数计算资源的工具。
通过该插件,您可以:
- 快速地在本地初始化项目、创建函数
- 运行、调试本地函数(调试功能目前支持 nodejs、python、php)
- 拉取云端的服务函数列表,执行云端函数
- 部署服务函数至云端,并更新相关配置
前置需求
如果您期望使用 Aliyun Serverless VSCode Extension 的所有功能,那么您需要确保系统中有以下组件:
- VSCode:在 中可以下载安装
- 函数计算 Fun 工具以及 Docker:可以在 中根据教程安装配置 Fun 以及 Docker
安装插件
- 打开 VSCode 并进入插件市场。
- 在插件市场中搜索 “Aliyun Serverless”,查看详情并安装。
- 重启 VSCode,左侧边栏中会展示已安装的 Aliyun Serverless VSCode Extension 插件。
快速入门
绑定阿里云账户
打开左侧 Aliyun Serverless VSCode Extension,单击绑定阿里云账户的按钮。
![53e39ce2ca224ebf16234f6afd9c490aa5d.jpg](https://oscimg.oschina.net/oscnet/53e39ce2ca224ebf16234f6afd9c490aa5d.jpg)
![c8f3071fbe9a57eb4474df559409bc5429d.jpg](https://oscimg.oschina.net/oscnet/c8f3071fbe9a57eb4474df559409bc5429d.jpg)
![f97fa477d0b77803b4c1900a0be62b1de10.jpg](https://oscimg.oschina.net/oscnet/f97fa477d0b77803b4c1900a0be62b1de10.jpg)
![62bff582b01418451d78369186749392516.jpg](https://oscimg.oschina.net/oscnet/62bff582b01418451d78369186749392516.jpg)
创建函数
通过 VSCode,打开一个空的目录文件。单击本地资源面板中的创建函数按钮,可以在本地初始化一个函数计算项目。
![baaf3779482aa9dff4b1af801fea4b4093d.jpg](https://oscimg.oschina.net/oscnet/baaf3779482aa9dff4b1af801fea4b4093d.jpg)
Tips:
您也可以直接单击本地资源面板中服务名右侧的创建函数按钮,来为该服务创建函数。按照导航依次输入或选择函数名称、函数运行时、函数类型即可。![aa845b195e329c2e96d4b6586a968e2a322.jpg](https://oscimg.oschina.net/oscnet/aa845b195e329c2e96d4b6586a968e2a322.jpg)
部署服务以及函数
单击本地资源面板中的部署按钮,可以将本地的服务与函数部署到云端。
![3e918a9929bc90761f5620cccd223f0086a.jpg](https://oscimg.oschina.net/oscnet/3e918a9929bc90761f5620cccd223f0086a.jpg)
![ea4ddcd3936385babac9e79593688670b74.jpg](https://oscimg.oschina.net/oscnet/ea4ddcd3936385babac9e79593688670b74.jpg)
其余功能介绍
本地调用函数
在本地资源面板中,单击函数名称右侧的执行按钮,可以在本地调用该函数。
![af87daec86556f3fc1fc3b6c3a1758c6473.jpg](https://oscimg.oschina.net/oscnet/af87daec86556f3fc1fc3b6c3a1758c6473.jpg)
![3c5c0d905f58823031b3bb3704044aff96a.jpg](https://oscimg.oschina.net/oscnet/3c5c0d905f58823031b3bb3704044aff96a.jpg)
插件会为您在函数入口文件同目录下创建 event.dat 文件,您可以通过修改该文件设置每次调用函数时触发的事件信息。
本地调试函数
在本地资源面板中,单击函数名称右侧的调试按钮,可以在本地调试该函数。
![109eb1ed8abb16a6ae27cca2707d296e8ee.jpg](https://oscimg.oschina.net/oscnet/109eb1ed8abb16a6ae27cca2707d296e8ee.jpg)
![0dbb64f547ef09cff2885286520ad638485.jpg](https://oscimg.oschina.net/oscnet/0dbb64f547ef09cff2885286520ad638485.jpg)
注意:
- 若您想要调试 python 2.7 或 python 3 runtime 的函数,需要事先在插件安装 Python 插件。
- 若您想调试 php runtime 的函数,需要事先在插件安装 PHP Debug 插件。
执行云端函数
单击云端资源面板中函数右侧的执行按钮,可以执行云端函数。
![ecfec493bc27920eeeb6b10e9b143ac00a7.jpg](https://oscimg.oschina.net/oscnet/ecfec493bc27920eeeb6b10e9b143ac00a7.jpg)
![b633ff9dd03e734a25f909dc5f41b1db670.jpg](https://oscimg.oschina.net/oscnet/b633ff9dd03e734a25f909dc5f41b1db670.jpg)
![6fd06d7a400e57de94815b79c963cd5b720.jpg](https://oscimg.oschina.net/oscnet/6fd06d7a400e57de94815b79c963cd5b720.jpg)
跳转到模版文件定义
通过 的模板文件来描述 serverless 应用。通过 Aliyun Serverless VSCode Extension 创建函数时,会使用默认值自动填充模版文件。若您想修改本地服务或函数的配置,可以通过点击本地资源面板中的服务或函数名,跳转到模版文件中的定义。
模版文件填充提示
您可以在模版文件中通过输入 Aliyun 或 FC 触发模版文件的填充提示。
![填充提示](https://github.com/alibaba/serverless-vscode/blob/master/media/snapshot/template-suggestion.gif?raw=true)