Node.js 런타임

Cloud Run 함수는 부가기능 패키지가 포함된 운영체제 버전, 언어 지원, 함수를 지원하고 호출하는 Node.js 함수 프레임워크 라이브러리로 구성된 환경에서 실행됩니다. 이 환경은 언어 버전으로 식별되며, 런타임 ID라고 합니다.

함수 준비

Google Cloud 콘솔에서 직접 함수를 준비하거나 로컬 머신에 작성하여 업로드할 수 있습니다. Node.js 개발을 위해 로컬 머신을 준비하려면 Node.js 개발 환경 설정을 참고하세요.

지원되는 Node.js 런타임 및 기본 이미지

런타임 런타임 ID 스택 런타임 기본 이미지
Node.js 22 nodejs22
  • google-22(기본값)
  • google-22-full
    		•
  • google-22/nodejs22
  • google-22-full/nodejs22
    		•
    Node.js 20 nodejs20
  • google-22(기본값)
  • google-22-full
    		•
  • google-22/nodejs20
  • google-22-full/nodejs20
    		•
    Node.js 18 nodejs18
  • google-22(기본값)
  • google-22-full
    		•
  • google-22/nodejs18
  • google-22-full/nodejs18
    		•
    Node.js 16 nodejs16 google-18-full google-18-full/nodejs16
    Node.js 14 nodejs14 google-18-full google-18-full/nodejs14
    Node.js 12 nodejs12 google-18-full google-18-full/nodejs12
    Node.js 10 nodejs10 google-18-full google-18-full/nodejs10
    Node.js 8 nodejs8 사용 중단됨 사용 중단됨
    Node.js 6 nodejs6 사용 중단됨 사용 중단됨

    런타임 선택

    배포 중에 함수에 지원되는 Node.js 런타임 중 하나를 선택할 수 있습니다.

    Google Cloud 콘솔 또는 gcloud CLI를 사용하여 런타임 버전을 선택할 수 있습니다. 선택한 도구 사용에 관한 안내를 보려면 해당 탭을 클릭하세요.

    gcloud

    함수를 배포할 때 --base-image 플래그를 사용하여 함수의 Node.js 기본 이미지를 지정합니다. 예를 들면 다음과 같습니다.

    gcloud run deploy FUNCTION \
    --source . \
    --function FUNCTION_ENTRYPOINT \
    --base-image nodejs22

    다음과 같이 바꿉니다.

    • FUNCTION을 배포하려는 함수의 이름으로 바꿉니다. 이 매개변수를 완전히 생략할 수 있지만 생략하면 이름을 입력하라는 메시지가 표시됩니다.

    • FUNCTION_ENTRYPOINT를 소스 코드에 있는 함수의 진입점으로 바꿉니다. 이는 함수가 실행될 때 Cloud Run이 실행하는 코드입니다. 이 플래그의 값은 소스 코드에 있는 함수 이름 또는 정규화된 클래스 이름이어야 합니다.

    gcloud CLI를 사용하여 함수를 배포하는 방법에 관한 자세한 내용은 Cloud Run에서 함수 배포를 참고하세요.

    콘솔

    Google Cloud 콘솔에서 Cloud Run 함수를 만들거나 업데이트할 때 런타임 버전을 선택할 수 있습니다. 함수 배포에 관한 자세한 안내는 Cloud Run에서 함수 배포를 참고하세요.

    함수를 만들 때 Google Cloud 콘솔에서 런타임을 선택하려면 다음 단계를 따르세요.

    1. Google Cloud 콘솔에서 Cloud Run 페이지로 이동합니다.

      Cloud Run으로 이동

    2. 함수 작성을 클릭합니다.

    3. 런타임 목록에서 Node.js 런타임 버전을 선택합니다.

    4. 만들기를 클릭하고 Cloud Run이 자리표시자 버전을 사용해서 서비스를 만들 때까지 기다립니다.

    5. 콘솔이 함수의 소스 코드를 볼 수 있는 소스로 리디렉션됩니다. 저장 및 재배포를 클릭합니다.

    함수가 배포된 후 런타임 버전을 업데이트하는 방법에 관한 자세한 내용은 새 소스 코드 다시 배포를 참고하세요.

    소스 코드 구조

    Cloud Run Functions에서 함수 정의를 찾으려면 소스 코드가 특정 구조를 따라야 합니다. 자세한 내용은 Cloud Run 함수 작성을 참고하세요.

    종속 항목 지정

    함수에 대한 종속 항목을 지정하는 방법은 package.json 파일에 나열하는 것입니다. 자세한 내용은 Node.js에서 종속 항목 지정을 참고하세요.

    NPM 빌드 스크립트

    기본적으로 build 스크립트가 package.json에서 감지되면 Node.js 런타임이 npm run build를 실행합니다. 애플리케이션을 시작하기 전에 빌드 단계를 추가로 제어해야 하면 gcp-build 스크립트를 package.json 파일에 추가하여 커스텀 빌드 단계를 제공하면 됩니다.

    다음 중 하나를 실행하여 빌드가 npm run build 스크립트를 실행하지 않도록 할 수 있습니다.

    • 값이 비어 있는 gcp-build 스크립트를 package.json 파일에 추가합니다. "gcp-build":""

    • 빌드 환경 변수 GOOGLE_NODE_RUN_SCRIPTS를 빈 문자열로 설정하여 모든 스크립트가 실행되지 않도록 합니다.

    비동기 함수 완성

    콜백 또는 Promise 객체가 포함된 비동기 작업을 수행할 때는 함수가 이러한 작업의 실행을 완료했음을 런타임에 명시적으로 알려야 합니다. 다음 샘플과 같이 여러 방법으로 이 작업을 수행할 수 있습니다. 핵심은 코드가 비동기 작업 또는 Promise가 완료될 때까지 기다린 후에 반환되어야 한다는 것입니다. 그렇지 않으면 함수의 비동기 구성요소가 완료되기 전에 종료될 수 있습니다.

    이벤트 기반 함수

    암시적 반환

      exports.implicitlyReturning = async (event, context) => {
    return await asyncFunctionThatReturnsAPromise();
  };

    명시적 반환

      exports.explicitlyReturning = function (event, context) {
    return asyncFunctionThatReturnsAPromise();
  };

    HTTP 함수

    // OK: await-ing a Promise before sending an HTTP response
await Promise.resolve();

// WRONG: HTTP functions should send an
// HTTP response instead of returning.
return Promise.resolve();

// HTTP functions should signal termination by returning an HTTP response.
// This should not be done until all background tasks are complete.
res.send(200);
res.end();

// WRONG: this may not execute since an
// HTTP response has already been sent.
return Promise.resolve();

    미들웨어를 사용하여 HTTP 요청 처리

    Node.js HTTP 함수는 ExpressJS와 호환되는 request 및 response 객체를 제공하여 HTTP 요청을 간단히 사용할 수 있도록 합니다. Cloud Run 함수는 자동으로 요청 본문을 읽으므로, 사용자는 미디어 유형과 관계없이 항상 요청 본문을 받습니다. 즉, 코드가 실행될 때 HTTP 요청을 완전히 읽은 것으로 간주합니다. 이러한 점에 주의하여 ExpressJS 앱의 중첩을 사용해야 합니다. 특히 요청 본문이 읽히지 않을 것으로 예상하는 미들웨어는 제대로 동작하지 않을 수 있습니다.

    ES 모듈 사용

    ECMAScript 모듈(ES 모듈 또는 ESM)은 자바스크립트 모듈 로드를 위한 Node 버전 14이상에서 플래그 지정되지 않은 TC39 표준 기능입니다. CommonJS와 달리 ESM은 모듈 로드를 위해 비동기 API를 제공합니다. 또한 require 문 대신 Cloud Run 함수 내에서 사용될 수 있는 import 및 export 문으로 인기 있는 문법 개선 사항을 제공합니다.

    Cloud Run 함수 내에서 ESM을 사용하려면 package.json 내에서 "type": "module"을 선언해야 합니다.

    {
  ...
  "type": "module",
  ...
}

    그런 다음 import 및 export문을 사용할 수 있습니다.

    ES 모듈 사용에 대해 자세히 알아보세요.