指定依赖项

通过在 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.lock 或 pnpm-lock.yaml 文件。

安装网络框架

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

如需使用特定 Web 框架（例如 Express.js），请将框架添加到 package.json 文件：

  • 使用 npm：

    npm install 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 @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 服务的支持。