종속 항목 지정

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 개발자가 Google Cloud 서비스(예: Datastore 모드의 Firestore(Datastore)Cloud Storage)와 통합하기 위해 일반적으로 사용하는 방법입니다.

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 서비스 지원을 구현합니다.