创建自定义连接器和连接

本页面介绍了如何为 Web 服务创建 OpenAPI 规范，然后为该连接器创建自定义连接器和连接。

在创建自定义连接器之前，您必须先为 Web 服务创建 OpenAPI 规范。

为 Web 服务创建 OpenAPI 规范

自定义连接器支持 OpenAPI 3.0。您也可以手动创建规范。如需了解 OpenAPI 规范，请参阅 OpenAPI 规范。

您还可以使用 Gin Swagger 中间件自动生成 OpenAPI 2.0 规范。如需了解相关信息，请参阅 Gin Swagger。您必须使用 Swagger Converter 将 OpenAPI 2.0 规范转换为 OpenAPI v3.0 规范。

OpenAPI 规范示例。

{
  "openapi": "3.0.0",
  "info": {
    "title": "Go HTTPbin Proxy Service",
    "description": "A simple Go service that proxies requests to httpbin.org, adding custom headers.",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "http://localhost:8080"
    }
  ],
  "paths": {
    "/getData": {
      "get": {
        "summary": "Fetch data from httpbin.org/get",
        "description": "Sends a GET request to httpbin.org/get, including any custom headers.",
        "responses": {
          "200": {
            "description": "Successful response from httpbin.org",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/postData/{id}": {
      "post": {
        "summary": "Post data to httpbin.org/post",
        "description": "Sends a POST request to httpbin.org/post with data, including any custom headers.",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"   

                  },
                  "address": {
                    "type": "string"
                  },
                  "gender": {
                    "type": "string"   
                  }
                },
                "required": [
                  "name",
                  "address",
                  "gender"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response from httpbin.org",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request - Invalid request body"
          }
        }
      }
    }
  }
}

创建自定义连接器并验证服务

您必须创建自定义连接器，然后在 Application Integration 的连接中使用该连接器来验证 Web 服务。

准备工作

为此虚拟机设置 Private Service Connect (PSC)，然后创建端点连接。

创建自定义连接器

在控制台中，前往应用集成 > 自定义连接器页面，然后选择或创建 Google Cloud 项目。
前往“自定义连接器”页面
点击新建，打开创建自定义连接器页面。
在连接器详细信息部分中，指定必需的字段，例如连接器名称和显示名称。此外，在说明字段中输入连接器的使用情形。
配置连接器目标，以实现后端访问：启用此选项。这会显示页面中的其他配置部分。
服务账号：选择具有所需角色的服务账号。
徽标：将图片上传到 Cloud Storage 存储桶，以用作连接器徽标。
注意： 请确保您的 Cloud Storage 存储桶已停用禁止公开访问。
在 Connector Specification（连接器规范）部分中，输入您的 Open API 规范的公开网址，或将规范文件上传到 Cloud Storage 存储桶。
在 Connector Destination 部分中，添加端点连接的 IP 地址以及服务运行的端口。
在连接器身份验证部分中，选择无身份验证。Marketplace 连接器不支持身份验证类型。
在后端变量部分中，添加您希望在创建连接时作为输入的变量。这些变量会显示在连接创建页面中，并且会在每次向服务发出的 API 调用中发送。不会随 API 变化的值（例如第三方后端凭据）必须在此部分中添加。
创建自定义连接器。确保您已指定徽标并描述了自定义连接器的使用情形。

创建连接

创建自定义连接器后，请为该连接器创建连接。

点击新建，打开创建连接页面。
选择您创建的自定义连接器。
为已定义的连接字段添加值。
创建连接。

验证服务

如需验证服务，请创建新的集成。

在 Google Cloud控制台中，前往 Application Integration 页面，然后创建集成。
添加 API 触发器和连接器任务。
配置连接器任务以使用在上一步中创建的连接。根据需要添加数据映射器。
根据架构为连接器设置 connectorInputPayload。
运行集成，验证连接是否正常。

如果集成成功运行并返回预期响应，则表示 Web 服务已通过验证。

后续步骤

了解如何为 Web 服务创建启动脚本。