指定依附元件

如要指定 Node.js 應用程式的依附元件，請在 package.json 檔案中進行宣告。

舉例來說，如果您要將 Lodash 指定為依附元件，package.json 檔案可能會像這樣：

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

您可以使用任何跟 Linux 相容的 Node.js 套件搭配 App Engine 彈性環境，包括需原生 (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 指令。

請注意，您必須確保 yarn.lock 或 pnpm-lock.yaml 檔案未在 app.yaml 檔案的 skip_files 區段中指定。

安裝網路架構

您需要使用網路架構，才能啟用應用程式以處理網路要求。您可以使用任何 Node.js 網路架構，其中包含：

• Express.js
• Hapi.js
• Loopback.js
• Koa.js
• Kraken.js
• Restify.js
• Sails.js

如要使用特定網路架構 (例如 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服務的慣用工具，例如 Firestore 在 Datastore 模式下 (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 服務的支援。