종속 항목 지정

package.json 파일에서 Node.js 앱의 종속 항목을 선언하여 지정합니다.

예를 들어 Lodash를 종속 항목으로 지정하려는 경우 package.json 파일이 다음과 같이 표시됩니다.

{
  "dependencies": {
    "lodash": "^4.0.1"
  }
}

네이티브(C) 확장을 필요로 하는 패키지를 포함하여 모든 Linux 호환 Node.js 패키지를 App Engine 가변형 환경과 함께 사용할 수 있습니다.

배포 중에 Node.js 런타임은 package.json 파일에 선언된 모든 dependencies자동으로 설치합니다. 기본적으로 npm install 명령어가 사용되지만 Yarn 및 Pnpm 패키지 관리자도 지원됩니다.

  • Yarn: yarn.lock 파일이 있으면 대신 yarn install --production 명령어가 사용됩니다.

  • Pnpm: Node.js 런타임 버전 18 및 버전 20(미리보기)에서만 지원됩니다. pnpm-lock.yaml 파일이 있으면 대신 pnpm install 명령어가 사용됩니다.

yarn.lock 또는 pnpm-lock.yaml 파일이 app.yaml 파일의 skip_files 섹션에 지정되지 않았는지 확인해야 합니다.

웹 프레임워크 설치

앱에서 웹 요청을 처리할 수 있도록 하려면 웹 프레임워크를 사용해야 합니다. 다음을 비롯하여 모든 Node.js 웹 프레임워크를 사용할 수 있습니다.

Express.js와 같은 특정 웹 프레임워크를 사용하려면 package.json 파일에 프레임워크를 추가합니다.

  • npm 사용:

    npm install --save express
  • yarn 사용:

    yarn add express
  • pnpm 사용:

    pnpm add express

예를 들어 결과로 반환되는 package.json 파일은 다음과 같습니다.

{
  "dependencies": {
    "lodash": "^4.0.1",
    "express": "^4.16.2"
  }
}

Cloud 클라이언트 라이브러리 설치

Node.js용 Cloud 클라이언트 라이브러리는 Node.js 개발자가 Datastore 모드의 Firestore(Datastore)Cloud Storage 등의 Google Cloud 서비스와 통합하기 위해 일반적으로 사용하는 방법입니다.

Cloud Storage용 Node.js 클라이언트 라이브러리를 설치하려면 다음 안내를 따르세요.

  1. 패키지 관리자를 사용하여 Cloud Client 라이브러리를 로컬로 설치합니다.

    • npm을 사용하려면 다음을 실행합니다.

      npm install --save @google-cloud/storage
    • yarn을 사용하려면 다음을 실행합니다.

      yarn add @google-cloud/storage
    • pnpm을 사용하려면 다음을 실행합니다.

      pnpm add @google-cloud/storage
  2. 인증을 설정합니다. 자동 인증 처리를 위해 Node.js용 Cloud 클라이언트 라이브러리를 구성할 수 있습니다.

  3. Cloud Storage용 Node.js 클라이언트 라이브러리 참조에 따라 앱에서 Cloud Storage 서비스 지원을 구현합니다.