Google Cloud Functions 확장 프로그램

Node.js 함수 호출

다음 예에서는 Google Cloud Functions 확장 프로그램을 호출하는 Extension콜아웃 정책을 보여줍니다. 이 확장 프로그램은 Cloud Functions API를 사용 설정할 때 포함된 기본 'hello world' 함수를 호출합니다.

다음 Node.js 자바스크립트는 GCP 계정의 Cloud Functions에 배포됩니다. 요청에 메시지 속성이 포함되어 있으면 코드에서 해당 속성을 반환합니다. 그렇지 않으면 응답으로 'Hello World!'를 반환합니다.

/**
 * Responds to any HTTP request.
 *
 * @param {!express:Request} req HTTP request context.
 * @param {!express:Response} res HTTP response context.
 */
exports.helloWorld = (req, res) => {
  let message = req.query.message || req.body.message || 'Hello World!';
  res.status(200).send(message);
};

이 예시에는 Cloud Functions에서 코드를 호출하고 승인하는 데 필요한 사용자 인증 정보로 구성된 Google Cloud Functions 확장 프로그램이 포함되어 있습니다.

위의 함수 코드는 Cloud Functions에 단순히 helloWorld로 저장됩니다. 다음 Extension콜아웃 정책 구성 코드에서는 함수가 배포된 Cloud Functions 환경의 세부사항과 일치하는 리전 및 프로젝트 ID 값과 함께 이 이름을 사용합니다.

<Action>invoke</Action>
<Input><![CDATA[
  {
    "region" : "us-central1",
    "projectId" : "my-project",
    "functionName" : "hello-world",
    "method" : "POST",
    "payload" : { "message" : "Hello yourself!" }
  }
]]></Input>
<Output parsed="false">function.response</Output>

다음 AssignMessage 정책은 디버깅 목적으로 응답 값을 캡처합니다.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Get-Function-Response">
    <DisplayName>Get Function Response</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <Set>
        <Payload contentType="application/json">{function.response}</Payload>
    </Set>
</AssignMessage>

위 요청에 대한 응답은 다음과 같습니다.

Hello yourself!

parsed의 기본값은 true입니다. 이 예시에서는 정책의 <Output> 태그에서 parsed="false"를 설정하여 정책이 JSON 응답을 파싱하지 못하게 합니다. Cloud Functions 확장 프로그램을 사용할 때는 대부분 parsed="false"를 설정합니다. 자세한 내용은 <Output> 요소를 참고하세요.

Cloud 함수에서 JSON 응답을 반환하고 parsed="true"를 설정하면 확장 프로그램의 응답은 객체 참조가 됩니다. 참조에서 응답을 추출하려면 {objectName}.{jsonKey} 문법을 사용합니다. 예를 들면 다음과 같습니다.

function.response.message

문법

<Action>invoke</Action>
<Input><![CDATA[
  {
    "region" : "deployment-region",
    "projectId" : "project-id",
    "functionName" : "function-name",
    "method" : "http-method",
    "payload" : { json-payload }
  }
]]></Input>
<Output>function.response</Output>

예

<Action>invoke</Action>
<Input><![CDATA[
  {
    "region" : "us-central1",
    "projectId" : "my-project",
    "functionName" : "hello-world",
    "method" : "POST",
    "payload" : { "message" : "Hello yourself!" }
  }
]]></Input>
<Output>function.response</Output>