Baidu Serverless VSCode Extension 是百度云 Serverless 产品 CFC 的 VSCode 插件，该插件结合了 CFC 本地命令行工具 BSAM CLI，可以帮您快速创建、管理本地的 CFC 函数，同时借助 Docker 轻松实现函数在本地的执行和 Debug。

功能概览

• 本地函数快速创建
• 本地函数的编译与依赖安装
• 本地函数执行
• Nodejs、Python、Java 函数本地 Debug
• 本地函数部署到云端
• 自定义测试事件的创建
• 多地域云端函数列表、下载
• 云端函数调用

安装与设置

1. 创建您的百度云账号，并在个人信息的安全认证中创建一个 Access Key。
2. 执行 pip3 install -i https://pypi.tuna.tsinghua.edu.cn/simple bce-sam-cli 以安装 BSAM CLI。插件在启动时也会检测 BSAM CLI 是否已安装，您可根据插件的提示来操作安装。关于 BSAM CLI 更多信息，您可参考 BSAM CLI使用示例。
3. 安装 Docker。您可访问 Docker 官网，根据您的操作系统下载不同的安装包进行安装。
4. 安装 VSCode。您可访问 VSCode 官网下载对应的安装包。
5. 在插件市场，搜索 "Baidu Serverless" 并安装。

本地函数功能

函数创建

导航路径：VS Code->Baidu Serverless 插件面板->本地函数

在 【本地函数】 栏点击 【···】，选择 【创建函数】，再根据弹窗提示完成函数创建。函数默认存储在当前打开工作空间的根目录，新函数默认使用模板代码，创建完成后可继续修改代码与配置。

以 Node.js 函数为例，创建后的目录结构如下：

1.
2├── README.md
3├── src                         <-- 源文件文件夹，存放函数源码和依赖库
4│   ├── index.js                <-- Node.js 函数源码
5│   ├── package.json            <-- Node.js 依赖管理文件
6│   └── tests                   <-- 单元测试
7│       └── unit
8│           └── test_handler.js
9└── template.yaml               <-- BSAM 模型文件，存储函数配置信息

依赖安装与编译

导航路径：VS Code->Baidu Serverless 插件面板->本地函数

函数执行前可能需要下载依赖包和执行编译。CFC 函数的执行环境是 Linux，您在本地下载的依赖和编译结果可能与 CFC 执行环境不兼容。为了避免这一情况，本插件集成了依赖安装与编译功能，您无需手动为函数安装依赖或执行编译。

在 【本地函数】 栏中找到目标函数，右键选择 【安装依赖与编译】。插件会根据函数运行时自动执行对应处理流程。

• Node.js 函数会读取 package.json 安装依赖。
• Python 函数会读取 requirements.txt 安装依赖，安装完成后依赖会放置到 src/site-packages 目录。
• Java 等编译型语言会执行编译流程；其中 Java 会读取 pom.xml，通过 Maven 下载依赖并生成编译产物。

完成后，可继续执行本地运行、Debug 或部署等后续操作。

自定义测试事件

导航路径：VS Code->Baidu Serverless 插件面板->本地函数

若您想用自定义测试事件来执行函数，可在 【本地函数】 栏中定位目标函数，右键选择 【创建测试事件】，再根据弹窗提示在本地创建测试事件文件。创建完成后，您可按业务需要自行修改该文件，并在执行函数时选择该事件文件作为测试入参。

函数执行与 Debug

导航路径 1：VS Code->Baidu Serverless 插件面板->本地函数

导航路径 2：VS Code->函数代码编辑器->handler 函数

为了保证函数能够执行与 Debug，请先确认 Docker 已安装并启动。执行函数时，可直接点击目标函数所在行的执行图标；也可在函数代码编辑器中使用 handler 函数对应的 【Local Invoke】 入口执行函数。

Debug 函数时，请先在函数文件中添加断点，再通过上述两种入口启动调试。插件当前支持 Node.js、Python 和 Java 函数的 Debug 功能。

函数部署

导航路径 1：VS Code->Baidu Serverless 插件面板->云端函数

导航路径 2：VS Code->Baidu Serverless 插件面板->本地函数

若尚未绑定云端账号，请先在 【云端函数】 栏点击 【···】，选择 【绑定新账户】，根据提示输入您的 AK、SK 和自定义别名完成账号绑定；如果已绑定多个账号或地域，可先使用 【切换账户】 和 【切换地域】 确认目标云端环境。

完成云端账号准备后，在 【本地函数】 栏中对目标函数点击右键，选择 【上传函数】，即可将该本地函数部署到 CFC 云端。上传完成后，可在目标地域的云端函数列表中查看结果。

云端函数功能

云端账号

导航路径：VS Code->Baidu Serverless 插件面板->云端函数

在 【云端函数】 栏点击 【···】，选择 【绑定新账户】。在弹出的账户绑定窗口中填写当前账号的 AK、SK 及自定义别名。

云端函数执行与下载

导航路径：VS Code->Baidu Serverless 插件面板->云端函数

在 【云端函数】 栏定位目标函数后，点击对应行的执行图标即可发起调用。执行后，您可根据返回内容确认函数是否成功运行。

用户配置项

导航路径：VS Code->Settings->Extensions->BCE Serverless Configuration

在 VS Code 中打开设置，进入 Settings->Extensions->BCE Serverless Configuration，即可查看插件配置项；如需修改，直接在对应配置项中输入或勾选后生效。