VSCode本地调试

概述

Huawei Cloud FunctionGraph是华为云Serverless产品的VSCode插件。通过该插件，您可以：

• 快速地在本地创建函数
• 运行调试本地函数、部署本地函数至云端
• 拉取云端的函数列表、调用云端函数、上传ZIP包至云端

前提条件

下载 Visual Studio Code（1.63.0版本以上）并安装。

安装插件

1. 打开Visual Studio Code工具，在应用商店中搜索“Huawei Cloud FunctionGraph”并进行安装。
   图1 搜索并安装
   
2. 安装成功后，Huawei Cloud FunctionGraph插件展示在已安装列表中。
   图2 已安装列表展示
   

登录函数插件

1. 单击Huawei Cloud FunctionGraph插件图标，单击“您尚未登录，请先登录”，弹出登录界面，根据页面提示选择登录方式。若选择“华为云 AK/SK登录”，需先获取账号的AK/SK，请参见新增访问密钥。
   图3 使用AK/SK登录
   

2. 您可以选择需要展示的区域Region，查看不同区域的函数信息。

   

3. 您也可以参考下图，进行更多区域的展示和隐藏、以及账号退出操作。
   • Show region in the Explorer：选择需要操作的Region。
   • Hide region from the Explorer：隐藏暂时不关注的Region。
   • Log Out：退出登录。

     

创建函数

1. 在插件面板中选择“Create Function”，或“Ctrl+Shift+p”搜索“Create Function”命令，按照提示依次选择或输入“运行时”、“模板”、“函数名称”、“本地文件夹”。

   

2. 本地函数创建成功后，会自动打开入口文件。
3. 自动生成配置文件，可以通过修改文件配置函数信息，参数如下：

   HcCrmTemplateVersion: v2
   Resources:
       Type: HC::Serverless::Function
       Properties:
           Name: functionName //函数名称
           Handler: handler //函数执行入口
           Runtime: runtime //函数运行时
           CodeType: inline //默认固定
           CodeFileName: index.zip //默认固定
           CodeUrl: ""
           Description: '' //函数运行时
           MemorySize: 128 //函数执行内存
           Timeout: 30 //函数超时时间(s)
           Version: latest //默认固定
           Environment:
               Variables: {} // 环境变量
           InitializerHandler: "" //函数初始化入口
           InitializerTimeout: 0 //函数初始化超时时间
           EnterpriseProjectId: "0" //企业项目
           FuncType: v2
           URN: "" //函数URN，函数下载后生成 

部署函数

• 前提

  确保函数代码路径正确。Nodejs、Python和PHP运行时函数代码在src目录下，其余运行时函数代码在根目录下。

在插件面板中选择“Deploy Function”，或“Ctrl+Shift+p”搜索“Deploy Function”命令，按照提示依次选择“需要部署的函数”、“Region”。

• 部署成功：界面右下角弹出成功提示，切换至部署“Region”查看。
• 部署失败：在“OUTPUT”下查看错误日志并解决。

本地调试

1. Nodejs
   • 前提

     本地环境已安装Nodejs。

   • 默认模式
     单击handler方法的Local Debug，配置事件内容，单击 Invoke，进行调试。

     图4 单击Local Debug
     
     图5 配置事件内容
     
   • VSCode自带调试能力

     在函数文件夹下新建main.js文件，并将下面内容复制到main.js文件，单击左侧的运行和调试图标，选择添加配置，进行配置，选择Nodejs，按“F5”进行调试。

     const handler = require('./index'); // 函数入口文件路径，根据具体情况修改
     const event = { 'hello': 'world' }; // 测试事件内容，根据具体情况修改
     const context = {}; // Context类
     console.log(handler.handler(event, context));

2. Python
   • 前提

     本地环境已安装Python。

   在函数文件夹下新建main.py文件，并将下面内容复制到main.py文件，单击左侧的运行和调试图标，选择添加配置，进行配置，选择Python，按“F5”进行调试。

   import sys
   import index # 函数入口文件路径，根据具体情况修改
   
   # main方法用于调试，event是选择的调试事件
   if __name__ == '__main__':
       event = { 'hello': 'world' } # 测试事件内容，根据具体情况修改
       context = ''
       content = index.handler(event, context)
       print('函数返回：')
       print(content)

3. Java
   • 前提

     已安装Java，VSCode已支持java的运行测试。

   在函数文件夹下的test目录下，打开TriggerTestsTest.java文件，单击左侧的运行和调试图标，选择添加配置，进行配置，选择Java，按“F5”进行调试。

其余功能

• 跳转到界面打开

  选择您需要打开的函数，鼠标右键单击“Open in Portal”，会在浏览器中打开该函数的详情页面。

• 执行云端函数
  1. 选择您需要操作的函数，鼠标右键单击“Invoke Function...”。
  2. 在Invoke Function面板中，选择需要传入的事件，单击“Invoke”，函数的日志以及结果会输出在OUTPUT中。
• 下载云端函数
  • 前提

    用户已添加获取桶对象(obs:object:GetObject)的权限。

  选择您需要操作的函数，鼠标右键单击“Download...”，选择您要下载的路径，函数代码会从云端下载到本地并自动打开入口文件。

• 更新云端函数

  选择您需要操作的函数，鼠标右键单击“Upload Function...”，选择您想要上传的ZIP包。

• 删除云端函数
  1. 选择您需要删除的函数，鼠标右键单击“Delete...”。
  2. 在确认框中选择"Delete"，删除函数。
• 复制URN

  选择您需要复制URN的函数，鼠标右键单击“Copy URN”直接获取。