对接函数工作流调用无服务器服务

通过配置FunctionGraph连接器，实现AstroZero与华为函数工作流（FunctionGraph）对接，对接后可调用在函数工作流控制台开发的服务。

背景信息

函数工作流（FunctionGraph）是华为云提供的一款无服务器（Serverless）计算服务，无服务器计算是一种托管服务，服务提供商会实时为您分配充足的资源，而不需要预留专用的服务器或容量，函数以弹性、免运维、高可靠的方式运行。此外，按函数实际执行资源计费，不执行不产生费用。更多关于函数工作流的介绍，请参见函数工作流官方网站。

场景描述

通过AstroZero的服务编排，调用在函数工作流控制台上创建的函数。

前提条件

参考快速创建第一个FunctionGraph函数中操作，创建一个函数“hello”，函数代码如下：

exports.handler = async (event, context) => {
    const result = {
        "greetings": event.name + ", hello"
    }
    return result;
}

创建FunctionGraph服务连接器

参考创建连接器入口中操作，进入创建连接器页面。
在左侧列表中，选择“HTTP > FunctionGraph服务”，单击“+”。

图1 创建FunctionGraph服务连接器
设置基本信息，单击“下一步”。
- 标签：连接器的标签名，用于在页面展示。
- 名称：连接器在系统中的唯一标识，创建后不可修改。
- 图标：连接器的图标。
- 描述：连接器的相关描述信息。
配置对接信息，单击“保存”。
- 账号所在地区：函数工作流服务所在的区域，可以跨区域，即函数工作流和AstroZero可不在同一个区域。
- 鉴权方式：访问函数工作流的鉴权方式。
  - 委托授权：通过创建委托，可以将函数工作流资源共享给AstroZero。选择该方式后，保存连接器设置时，在弹出的提示框单击“是”，即可访问函数工作流，不需要输入访问密钥对（AK/SK）。
  - AK/SK：通过IAM用户的访问密钥对（AK/SK）来进行鉴权。
- 访问密钥ID：配置为访问密钥对中“Access Key Id”对应的值。请参考获取AK/SK中操作，获取AK（Access Key ID）、SK（Secret Access Key），即访问密钥对。
- 访问密钥：配置为访问密钥对中“Secret Access Key”对应的值。请参考获取AK/SK中操作，获取AK（Access Key ID）、SK（Secret Access Key），即访问密钥对。
配置动作，即要调用的函数。
1. 在“动作列表”页签，单击“新建”。
2. 在“基本信息”中，选择要调用的函数，如前提条件中创建的“hello”，设置动作的标签和名称，单击“下一步”。
3. 配置消息头入参，该示例场景不需要配置消息头入参，单击“下一步”，删除第一行参数。
  若此接口没有消息头输入参数，则不需要配置参数，请删除第一行参数。若有消息头输入参数，且有多个，请单击“+ 新增”。
  - 标签：消息头输入参数的标签名，用于在页面展示。
  - 名称：消息头输入参数在系统中的唯一标识，创建后不可修改。
  - 数据类型：消息头输入参数的数据类型。
    - 数字：数字类型。
    - 字符串：字符串类型。
    - 布尔值：布尔类型，取值为“true”和“false”。
  - 默认值：参数的默认取值。
  - 描述：消息头输入参数的描述信息。
  - 默认：参数是否有默认值。
  - 必填：参数是否必填。
  - 操作：单击或，可对Header输入参数，进行添加或删除操作。
4. 配置输入参数。
  如图2所示，该示例场景需要设置字符串类型的入参“name”。若此接口没有输入参数，则不需要配置参数，删除第一行参数。若有输入参数，且有多个，请单击“+ 新增”，并定义输入参数的基本信息。
  
  页面上方“消息体格式”参数使用说明：当方法为“PUT”或“POST”时，该参数才会显示。当第三方入参为数组类型或者非JSON类型时，需要将“输入消息体方式”设置为“值”形式。
  
  例如，若设置“消息体格式”为“键-值”，假设定义了输入参数A、B、C，调用时消息体中传递了参数 {A: 1,B:2, C:3} ，此时被调用方收到的参数信息是 {A: 1,B:2, C:3}。若设置“输入消息体方式”为“值”，此时默认使用$in输入参数定义，调用时消息体中传递了参数{$in: [1,2,3] }，此时被调用方收到的参数信息为[1,2,3]。
  
  图2 输入参数配置页面
  - 标签：输入参数的标签名，用于在页面显示。
  - 名称：输入参数在系统中的唯一标识，创建后不可修改。
  - 参数位置：输入参数的位置。
  - 数据类型：输入参数的数据类型。
  - 命名空间：输入参数所属的命名空间。
  - 结构体类型：输入参数的结构体类型。
  - 对象：当“结构体类型”为对象时，需要设置具体的对象。
  - 默认值：参数默认取值。
  - 描述：参数是否有默认值。
  - 必填：输入参数是否必填。勾选后，表示是必填字段。
  - 集合：输入参数是否是数组型。勾选后，表示是数组型。
  - 操作：单击或，可添加或删除输入参数。
5. 配置输出参数，如图3所示，该示例场景需要设置字符串类型的出参“greetings”。
  若此接口没有输出参数，则不需要配置参数，请删除第一行参数。若有输出参数，且有多个参数，请单击“+ 新增”，并定义输出参数的基本信息。
  
  页面上方“消息体格式”参数使用说明：设置“输出消息体方式”为“值”后，系统会引入一个通用的出参变量“$out”，将body的内容存到“$out”中，作为出参。
  
  例如，若设置“消息体格式”为“键-值”，假设定义了输出参数A、B、C，调用后返回消息体中传递了参数 {A: 1,B:2, C:3} ，此时调用方收到的参数信息是 {A: 1,B:2, C:3}。若设置“输出消息体方式”为“值”，此时默认使用$out输出参数定义，调用业务接口返回消息体中传递了参数[1,2,3]，此时调用方收到的参数信息为{$out:[1,2,3]}。
  
  图3 输出参数配置页面
  - 标签：输出参数的标签名，用于在页面展示。
  - 名称：输出参数在系统中的唯一标识，创建后不可修改。
  - 参数位置：设置参数的位置。
  - 数据类型：输出参数的数据类型。
  - 命名空间：输出参数所属的命名空间。
  - 结构体类型：设置结构体类型。
  - 对象：当“结构体类型”为对象时，需要设置具体的对象。
  - 描述：输出参数的描述信息。
  - 集合：输出参数是否是数组型。勾选后，表示是数组型。
  - 操作：单击或，可添加或删除输出参数。
6. 设置完成后，单击“保存”。
7. 单击该动作所在行的，进行启用。
（可选）测试该函数。
1. 单击已创建的动作名称，进入动作详情页。
2. 单击“测试”，设置如下输入参数，单击“测试”。
```
{
"name":"Lily"
}
```
  返回图4中消息，说明函数执行成功。
  
  图4 返回消息

在服务编排中调用连接器

在服务编排中，通过连接器图元调用在函数工作流控制台上，创建的函数。

参考如何开发服务编排中操作，创建一个服务编排。

图5 创建一个服务编排
为服务编排设置入参和出参变量。
1. 在服务编排设计页面右侧，选择。
2. 在全局上下文页面，单击“变量”后的加号。
3. 新建入参变量“name”、出参变量“greetings”，变量类型为“文本”，如图6所示。
  图6 新建变量
4. 单击，设置服务编排入参和出参。
  图7 设置出入参
在服务编排设计页面左侧，选择“连接器 > FunctionGraph”中，拖拽创建FunctionGraph服务连接器中创建的连接器至画布中，并连接图元。

图8 连接图元
设置动作参数。

图9 设置动作参数
- 动作：调用5配置的具体动作。
- 输入参数：设置接口的输入参数。在“目标”中选择参数，在“源”中拖入全局上下文中的对应变量。
- 输出参数：设置接口的输出参数。在“源”中选择参数，在“目标”中拖入全局上下文中的对应变量。
单击页面上方的，保存服务编排。
保存成功后，单击，运行服务编排。

设置输入参数，单击“运行”。

{
    "name": "Lily"
}

若输出如下结果，表示成功调用函数。

{
  "interviewId": "002N000000pjDj5T7Djk",
  "outputs": {
    "greetings": "Lily, hello"
  }
}

在脚本中调用连接器

在脚本中，调用已创建的连接器，实现调用在函数工作流控制台上创建的函数。

参考开发一个简单脚本实例中操作，创建一个脚本。

图10 新建一个空白脚本

在脚本编辑器中，输入如下脚本代码。

import { Decimal } from "decimal";
import { Error } from "error";
import * as connector from "connector";

export class Input {
    @action.param({ type: "String", required: true, description: "name" })
    name: string;
}

export class Output {
    @action.param({ type: "String", required: true })
    greetings: String;
}

export class Functiongraph {

    @action.method({ input: "Input", output: "Output", description: "do a operation" })
    run(input: Input): Output {
        let output = new Output();
        let client = connector.newClient("functiongraph", "LT927__test");
        let result = client.invoke("LT927__hello", input);
        console.log(result);
        output.greetings = result.greetings;
        return output;
    }
}

其中，“LT927__test”为连接器的名称，“LT927__hello”为动作名称。

单击脚本编辑器页面上方的，保存脚本。
保存成功后，单击编辑器页面上方的，执行脚本。
在页面底部“输入参数”页签，设置输入请求参数，单击测试窗口右上角的。
```
{
    "name": "Lily"
}
```
若输出如下结果，表示成功调用函数。
```
{
    "greetings": "Lily, hello"
}
```