更新时间:2024-03-05 GMT+08:00

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,请参见新增访问密钥
  1. 您可以选择需要展示的区域Region,查看不同区域的函数信息。

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

创建函数

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

  1. 本地函数创建成功后,会自动打开入口文件。
  2. 自动生成配置文件,可以通过修改文件配置函数信息,参数如下:
    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,进行调试。
      图3 单击Local Debug
      图4 配置事件内容
    • 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”直接获取。