커스텀 커넥터 및 연결 만들기

이 페이지에서는 웹 서비스의 OpenAPI 사양을 만든 후 커스텀 커넥터와 이 커넥터의 연결을 만드는 방법을 설명합니다.

맞춤 커넥터를 만들기 전에 웹 서비스의 OpenAPI 사양을 만들어야 합니다.

웹 서비스의 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의 연결에서 이를 사용하여 웹 서비스를 검증해야 합니다.

시작하기 전에

이 가상 머신에 Private Service Connect (PSC)를 설정한 후 엔드포인트 연결을 만듭니다.

커스텀 커넥터 만들기

  1. 콘솔에서 Integration Connectors > 커스텀 커넥터 페이지로 이동한 후 Google Cloud 프로젝트를 선택하거나 만듭니다.

    커스텀 커넥터 페이지로 이동

  2. 새로 만들기를 클릭하여 커스텀 커넥터 만들기 페이지를 엽니다.
  3. 커넥터 세부정보 섹션에서 커넥터 이름, 표시 이름과 같은 필수 입력란을 지정합니다.또한 설명 입력란에 커넥터의 사용 사례를 입력합니다.
  4. 백엔드 액세스용 커넥터 대상 구성: 이 옵션을 사용 설정합니다. 그러면 페이지의 추가 구성 섹션이 표시됩니다.
  5. 서비스 계정: 필요한 역할이 있는 서비스 계정을 선택합니다.
  6. 로고: 이미지를 커넥터 로고로 사용하려면 Cloud Storage 버킷에 이미지를 업로드합니다.
  7. 커넥터 사양 섹션에서 Open API 사양의 공개 URL을 입력하거나 사양 파일을 Cloud Storage 버킷에 업로드합니다.
  8. 커넥터 대상 섹션에 엔드포인트 연결의 IP 주소와 서비스가 실행 중인 포트를 추가합니다.
  9. 커넥터 인증 섹션에서 인증 안함을 선택합니다. 마켓플레이스 커넥터에는 인증 유형이 지원되지 않습니다.
  10. 백엔드 변수 섹션에서 연결을 만드는 동안 입력으로 사용할 변수를 추가합니다. 이 변수는 연결 생성 페이지에 표시되며 서비스에 대한 모든 API 호출 시 전송됩니다. 서드 파티 백엔드 사용자 인증 정보와 같이 API로 변경되지 않는 값은 이 섹션에 추가해야 합니다.
  11. 커스텀 커넥터를 만듭니다. 로고를 지정하고 맞춤 커넥터의 사용 사례를 설명했는지 확인합니다.

연결 만들기

커스텀 커넥터를 만든 후 이 커넥터의 연결을 만듭니다.

  1. Cloud 콘솔에서 Integration Connectors > 연결 페이지로 이동한 다음 Google Cloud 프로젝트를 선택하거나 만듭니다.

    연결 페이지로 이동

  2. 새로 만들기를 클릭하여 연결 만들기 페이지를 엽니다.
  3. 만든 맞춤 커넥터를 선택합니다.
  4. 정의한 연결 필드의 값을 추가합니다.
  5. 연결을 만듭니다.

서비스 유효성 검사

서비스를 검증하려면 새 통합을 만듭니다.

  1. Google Cloud 콘솔에서 Application Integration 페이지로 이동한 다음 통합을 만듭니다.
  2. API 트리거와 커넥터 태스크를 추가합니다.
  3. 이전 단계에서 만든 연결을 사용하도록 커넥터 태스크를 구성합니다. 필요한 경우 데이터 매퍼를 추가합니다.
  4. 스키마에 따라 커넥터의 connectorInputPayload를 설정합니다.
  5. 통합을 실행하여 연결이 작동하는지 확인합니다.

통합이 성공적으로 실행되고 예상 응답을 반환하면 웹 서비스가 유효합니다.

다음 단계