使用VSCode插件管理函数资源-阿里云帮助中心

本文介绍了如何通过VSCode插件创建、部署、调试函数资源。

背景信息

Aliyun Serverless VSCode Extension是函数计算提供的VSCode插件。通过该插件，您可以完成以下操作：

在本地快速地初始化项目和创建函数。
运行、调试本地函数。调试功能支持Node.js、Python和PHP编程语言。
拉取云端的服务和函数至VSCode中。
部署资源至云端，并更新相关参数配置。

前提条件

您已完成以下操作：

开通服务
下载安装Visual Studio Code
安装Docker
编译代码、安装依赖和在本地运行调试函数等操作都是在Docker镜像中进行的。
安装Aliyun Serverless VSCode Extension插件

操作步骤

绑定阿里云账号。
1. 打开VSCode，在左侧导航栏，单击图标，单击Bind New Account绑定阿里云账号。
  在插件左侧面板的REMOTE RESOURCES区域下方，可以看到Bind New Account选项。
2. 依次输入阿里云账号（主账号）、AccessKey ID、AccessKey Secret和自定义的账号别名（即本地账号名称）。
  VSCode顶部弹出命令面板，按1/4至4/4的步骤依次提示输入Account ID、AccessKey ID、AccessKey Secret和Account Alias，每次输入后按Enter确认。
  绑定完成后，您可以看到成功绑定的阿里云账号在云端的服务和函数。其中服务列表显示在左侧面板的REMOTE RESOURCES区域中。
  您也可以在云端资源面板切换地域查看不同地域的服务和函数。单击REMOTE RESOURCES面板右上角的...按钮，在弹出菜单中选择Switch Region即可切换地域。
创建函数。
1. 通过VSCode插件，打开一个空文件夹。
2. 在LOCAL RESOURCES区域，单击加号图标，在本地初始化一个函数计算项目。
  LOCAL RESOURCES面板标题栏右侧依次排列+（新建）、部署、刷新和...四个图标按钮，单击+图标即可开始创建。
3. 按照导航依次输入或选择服务名称、函数运行环境和函数类型。
  配置完成后，插件会自动创建函数并在本地资源面板中展示新建的本地服务与函数。左侧LOCAL RESOURCES面板显示template.yml配置文件和新建的服务及函数节点，右侧自动打开函数入口文件index.js。
您也可以直接单击LOCAL RESOURCES中服务名右侧的加号图标，为该服务创建函数。按照导航依次输入或选择函数名称、函数运行时、函数类型即可。
本地调试函数。
重要
- 调试Python 2.7或Python 3函数，需要安装Python插件。
- 调试PHP 7.2函数，需要安装PHP Debug插件。
1. 在本地资源面板中，单击函数名称右侧的调试图标或handler文件中的Local Debug，调试该函数。
  调试图标为虫形按钮，位于函数名称右侧。代码编辑区函数入口处同时显示Local Run、Local Debug和Invoke Panel三个操作链接。
2. 在代码文件中插入断点，启动调试后可查看调试信息。
  调试启动后，VSCode进入DEBUG模式，左侧VARIABLES面板显示当前函数的上下文变量（如context对象中的requestId、credentials、function等信息），代码中断点所在行以黄色高亮显示，顶部出现调试工具栏。
插件会为您在函数入口文件同目录下创建event.dat文件，您可以通过修改该文件设置每次调试函数时触发的事件信息。
可选：本地调用函数。
在LOCAL RESOURCES区域中，单击函数名称右侧的执行图标或handler文件中的Local Run，调用该函数。执行图标为三角形播放按钮，位于函数名称右侧。函数日志和结果会输出到终端。
```
FC Invoke Start RequestId: xxx
load code for handler:index.handler
2019-07-18T12:25:50.146Z xxx [verbose] [String: '{"key": "value"}']
FC Invoke End RequestId: xxx
hello world

RequestId: xxx    Billed Duration: 115 ms    Memory Size: 1998 MB    Max Memory Used: 58 MB
```
插件会为您在函数入口文件同目录下创建event.dat文件，您可以通过修改该文件设置每次调用函数时触发的事件信息。event.dat文件默认内容为JSON格式，例如{"key": "value", "name": "Function Compute"}。
部署服务与函数。
1. 单击本地资源面板中的部署图标，将本地的服务与函数部署到云端。
  部署图标呈云朵上传形状，位于LOCAL RESOURCES面板标题栏的+图标右侧。
2. 部署完成后，单击云端资源面板中的刷新图标，查询部署到云端的服务与函数。
  部署成功后，TERMINAL中显示function testFunc01 deploy success和service demo01 deploy success。刷新REMOTE RESOURCES面板后，可以看到已部署的服务demo01及其函数testFunc01。
执行云端函数。
单击云端资源面板中函数右侧的执行图标，执行云端函数。执行图标为三角形播放按钮，位于函数名称右侧。
函数日志和结果会输出在TERMINAL中。
```
FC Invoke Start RequestId: xxx
load code for handler:index.handler
2019-07-18T12:25:50.146Z xxx [verbose] [String: '{"key": "value"}']
FC Invoke End RequestId: xxx
hello world

RequestId: xxx    Billed Duration: 115 ms    Memory Size: 1998 MB    Max Memory Used: 58 MB
```
插件会为您在项目根目录下创建event.dat文件，您可以通过修改event.dat文件设置每次调用云端函数时触发的事件信息。
云端测试。
您可以在函数计算控制台查看是否部署成功。
1. 登录函数计算控制台。
2. 在左侧导航栏，单击服务及函数。
3. 在顶部菜单栏，选择地域。
4. 在服务列表页面，单击目标服务。
5. 在函数管理页面，单击目标函数名称。
6. 在函数详情页面的函数代码页签，单击测试函数，即可在函数计算控制台执行函数。
查看日志。
每次执行完毕，可以在当前页面查看本次执行日志。如果需要查看历史执行日志，可以单击调用日志页签，查看历史执行日志时需为函数配置日志仓库。详细信息，请参见配置日志。