指定依赖项

通过在 package.json 文件中添加声明,您可以为 Node.js 应用指定依赖项。

例如,如果要将 Lodash 指定为依赖项,则 package.json 文件可能如下所示:

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

您可以在 App Engine 柔性环境中使用任何与 Linux 兼容的 Node.js 包,包括需要原生 (C) 扩展程序的包。

在部署期间,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 命令。

请注意,您必须确保 app.yaml 文件的 skip_files 部分中未指定 yarn.lockpnpm-lock.yaml 文件。

安装网络框架

要让应用能够处理 Web 请求,您需要使用 Web 框架。您可以使用任何 Node.js Web 框架,包括:

如需使用特定 Web 框架(例如 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 客户端库:

    • 要使用 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 服务的支持。