本頁面由 Cloud Translation API 翻譯而成。

管理功能

您可以使用 Firebase CLI 指令，或在函式原始碼中設定執行階段選項，來部署、刪除及修改函式。

部署函式

如要部署函式，請執行以下 Firebase CLI 指令：

firebase deploy --only functions

根據預設，Firebase CLI 會在內部部署所有函式同時確保來源和來源。如果您的專案含有超過 5 個函式，建議您搭配特定函式名稱使用 --only 旗標方便您只部署各個顏色或版本部署特定函式這樣可以加快部署程序，避免部署配額例如：

firebase deploy --only functions:addMessage,functions:makeUppercase

部署大量函式時，您可能會超過以及接收 HTTP 429 或 500 錯誤訊息解題可將函式部署在 10 組以下

如需可用完整清單，請參閱 Firebase CLI 參考資料指令

根據預設，Firebase CLI 會在 functions/ 資料夾中尋找原始程式碼。您也可以視需要在程式碼集或多組檔案中整理函式。

刪除函式

您可以透過下列方式刪除先前部署的函式：

在 Firebase CLI 中明確使用 functions:delete
Google Cloud控制台中明確。
隱含：在部署前從來源中移除函式。

所有刪除作業從實際工作環境移除函式前，會提示您進行確認。

Firebase CLI 中的明確函式刪除作業支援多個引數和函式群組，並可讓您指定在特定區域執行的函式。此外，您也可以覆寫確認提示。

# Delete all functions that match the specified name in all regions.
firebase functions:delete myFunction

# Delete a specified function running in a specific region.
firebase functions:delete myFunction --region us-east-1

# Delete more than one function
firebase functions:delete myFunction myOtherFunction

# Delete a specified functions group.
firebase functions:delete groupA

# Bypass the confirmation prompt.
firebase functions:delete myFunction --force

透過隱含的函式刪除功能，firebase deploy 會剖析來源，並從正式版中移除已從檔案中移除的任何函式。

修改函式的名稱、區域或觸發條件

如果您要針對適用於請按照本節所述步驟處理，以免遺失事件。在您按照這些步驟操作之前，請先確認函式是否冪等，因為在變更期間，函式的新舊版本都會同時執行。

重新命名函式

如要重新命名函式，請在來源中建立新版本的函式並重新命名，然後執行兩個個別的部署指令。第一個指令會部署新命名的函式，第二個指令則會移除先前部署的版本。舉例來說，如果您使用 Node.js 函式名為「webhook」的通知變更為 webhookNew，請按照下列步驟修改程式碼：

// before
const functions = require('firebase-functions/v1');

exports.webhook = functions.https.onRequest((req, res) => {
    res.send("Hello");
});

// after
const functions = require('firebase-functions/v1');

exports.webhookNew = functions.https.onRequest((req, res) => {
    res.send("Hello");
});

接著，請執行下列指令來部署新函式：

# Deploy new function called webhookNew
firebase deploy --only functions:webhookNew

# Wait until deployment is done; now both webhookNew and webhook are running

# Delete webhook
firebase functions:delete webhook

變更函式的區域或區域

如果要變更的指定區域處理正式環境流量的函數，如要避免事件遺失，執行下列步驟：

重新命名函式，並視需要變更其區域。
部署重新命名的函式，以便在兩組區域中暫時執行相同的程式碼。
刪除先前的函式。

舉例來說名為 webhook，目前位於 us-central1 的預設函式區域，想遷移至 asia-northeast1，您必須先修改原始碼，才能將並修改區域。

// before
const functions = require('firebase-functions/v1');

exports.webhook = functions
    .https.onRequest((req, res) => {
            res.send("Hello");
    });

// after
const functions = require('firebase-functions/v1');

exports.webhookAsia = functions
    .region('asia-northeast1')
    .https.onRequest((req, res) => {
            res.send("Hello");
    });

接著執行下列指令來部署：

firebase deploy --only functions:webhookAsia

目前有兩個相同的函式正在執行：webhook 在 us-central1 中執行，webhookAsia 在 asia-northeast1 中執行。

然後刪除 webhook：

firebase functions:delete webhook

現在只有一個函式 - webhookAsia，且在 asia-northeast1 中執行。

變更函式的觸發類型

隨著 Cloud Functions for Firebase 部署作業的進行，您可能會基於各種原因而需要變更函式的觸發事件類型。舉例來說，您可能想要將某種類型的 Firebase Realtime Database 或 Cloud Firestore 事件變更為另一種類型。

您無法只變更原始碼並執行 firebase deploy，就變更函式的事件類型。為避免發生錯誤透過以下程序變更函式的觸發條件類型：

修改原始碼，加入包含所需觸發條件類型的新函式。
部署函式，這會導致暫時同時執行舊函式和新函式。
使用 Firebase CLI 明確從實際環境中刪除舊函式。

例如，如果您有名為 objectChanged 的 Node.js 函式，「onChange」事件類型，如要變更為「onFinalize」，請先重新命名函式，然後編輯函式，使其包含 onFinalize 事件類型。

// before
const functions = require('firebase-functions/v1');

exports.objectChanged = functions.storage.object().onChange((object) => {
    return console.log('File name is: ', object.name);
});

// after
const functions = require('firebase-functions/v1');

exports.objectFinalized = functions.storage.object().onFinalize((object) => {
    return console.log('File name is: ', object.name);
});

接著，請先執行下列指令建立新函式，再刪除舊函式：

# Create new function objectFinalized
firebase deploy --only functions:objectFinalized

# Wait until deployment is done; now both objectChanged and objectFinalized are running

# Delete objectChanged
firebase functions:delete objectChanged

設定執行階段選項

Cloud Functions for Firebase 可讓您選取 Node.js 等執行階段選項執行階段版本和每個函式的逾時時間、記憶體配置和最小/最大函式執行個體。

最佳做法是將這些選項 (Node.js 版本除外) 設在函式程式碼中的設定物件上。這個 RuntimeOptions 是函式執行階段選項的可靠資料來源，透過其他方法 (例如透過 Google Cloud 控制台) 設定的覆寫選項或 gcloud CLI)。

如果您的開發工作流程需要透過以下方式手動設定執行階段選項： Google Cloud 控制台或 gcloud CLI，您「不」想要請將 preserveExternalChanges 選項設為 true。將這個選項設為 true 後，Firebase 會將程式碼中設定的執行階段選項，與目前部署的函式版本設定合併，並以以下優先順序進行：

函式程式碼中已設定選項：覆寫外部變更。
在函式程式碼中將選項設為 RESET_VALUE：使用預設值覆寫外部變更。
選項未在函式程式碼中設定，而是在目前已部署的函式中設定：請使用已部署函式中指定的選項。

不建議使用 preserveExternalChanges: true 選項，因為程式碼將不再是執行階段選項的完整可靠來源函式。如果可以的話，請查看 Google Cloud 控制台或使用 gcloud 查看函式的完整設定。

設定 Node.js 版本

Cloud Functions 適用的 Firebase SDK 可讓您選取 Node.js 執行階段。您可以選擇只在執行階段執行專案中的所有函式環境：

Node.js 20 (預先發布版)
Node.js 18
Node.js 16
Node.js 14

如要設定 Node.js 版本，請按照下列步驟操作：

您可以在 package.json 的 engines 欄位中設定版本該檔案是在初始化期間建立的 functions/ 目錄中。舉例來說 18 版，請在 package.json 中編輯這一行：

  "engines": {"node": "18"}

如果您使用 Yarn 套件管理工具，或是對 engines 欄位有其他特定需求，可以改為在 firebase.json 中為 Cloud Functions 的 Firebase SDK 設定執行階段：

  {
    "functions": {
      "runtime": "nodejs18" // or nodejs14, nodejs16 or nodejs20
    }
  }

CLI 使用 firebase.json 中設定的值，而非任何值或您在 package.json 中單獨設定的範圍。

升級 Node.js 執行階段

如要升級 Node.js 執行階段：

請確認您的專案位於 Blaze 定價方案。
請確認您使用的是 Firebase CLI 11.18.0 以上版本。
變更先前建立的 package.json 檔案內的 engines 值。 functions/ 目錄，舉例來說，如果您從 16 版升級至第 18 版，看起來應該像這樣："engines": {"node": "18"}
您也可以選擇使用 Firebase Local Emulator Suite 來測試變更。
重新部署所有函式。

控管資源調度行為

根據預設，Cloud Functions for Firebase 會調整運作中的執行個體數量依據傳入要求的數量，甚至可能將資源縮減至零執行個體會發生在流量減少的時候不過，如果您的應用程式需要如要限製冷啟動的次數，您可以變更您可以指定容器執行個體數量下限保持暖機狀態，隨時可供處理要求。

同樣地，您可以設定上限，限制回應傳入要求。您可以使用這項設定來控管費用，或限制備用服務 (例如資料庫) 的連線數量。

減少冷啟動的次數

如要設定原始碼中某個函式的執行個體數量下限，請使用 runWith 方法。此方法接受符合 RuntimeOptions 介面，用於定義 minInstances 的值。例如：這個函式會設定至少 5 個執行個體來保持暖機狀態：

exports.getAutocompleteResponse = functions
    .runWith({
      // Keep 5 instances warm for this latency-critical function
      minInstances: 5,
    })
    .https.onCall((data, context) => {
      // Autocomplete a user's search term
    });index.js

設定 minInstances 的值時，請考量以下幾點：

如果 Cloud Functions for Firebase 會將應用程式縮放至 minInstances 設定以上，在每個執行個體超過該門檻時，我們就會啟動冷啟動
冷啟動對流量波動劇烈的應用程式影響最大。如果您的應用程式的流量高峰，而您將 minInstances 值設為夠高。每當流量增加時，冷啟動都會降低縮短延遲時間如果應用程式的流量穩定，冷啟動就不會可能會嚴重影響成效

設定最少的執行個體可能適合實際工作環境，但通常應避免在測試環境中設定。如要在測試專案中縮放至零，但仍要減少正式專案中的冷啟動次數，您可以根據 FIREBASE_CONFIG 環境變數設定 minInstances：

// Get Firebase project id from `FIREBASE_CONFIG` environment variable
const envProjectId = JSON.parse(process.env.FIREBASE_CONFIG).projectId;

exports.renderProfilePage = functions
    .runWith({
      // Keep 5 instances warm for this latency-critical function
      // in production only. Default to 0 for test projects.
      minInstances: envProjectId === "my-production-project" ? 5 : 0,
    })
    .https.onRequest((req, res) => {
      // render some html
    });index.js

限制函式的執行個體數量上限

如要在函式原始碼中設定執行個體數量上限，請使用 runWith 方法。此方法接受符合 RuntimeOptions 介面，其中定義了 maxInstances 的值。例如，這個函式會將上限設為 100 執行個體以避免過多假想舊資料庫：

exports.mirrorOrdersToLegacyDatabase = functions
    .runWith({
      // Legacy database only supports 100 simultaneous connections
      maxInstances: 100,
    })
    .firestore.document("orders/{orderId}")
    .onWrite((change, context) => {
      // Connect to legacy database
    });index.js

如果 HTTP 函式擴充至 maxInstances 限制，新要求會排入佇列 30 秒，如果屆時沒有可用的執行個體，系統會拒絕要求並傳回 429 Too Many Requests 回應代碼。

如要進一步瞭解使用執行個體上限設定的最佳做法，請參閱這些使用 maxInstances 的最佳做法。

設定逾時和記憶體分配

在某些情況下，您的函式可能需要長的逾時值或大量的記憶體配置。您可以在 Google Cloud 控制台或函式原始碼中 (僅限 Firebase)。

如要在函式原始碼中設定記憶體配置和逾時時間，請使用 Firebase SDK for Cloud Functions 2.0.0 中引進的 runWith 參數。這個執行階段選項接受符合 RuntimeOptions 介面，用於定義 timeoutSeconds 和 memory 的值。舉例來說，這個儲存空間函式會使用 1 GB 記憶體，並在 300 秒後逾時：

exports.convertLargeFile = functions
    .runWith({
      // Ensure the function has enough memory and time
      // to process large files
      timeoutSeconds: 300,
      memory: "1GB",
    })
    .storage.object()
    .onFinalize((object) => {
      // Do some complicated things that take a lot of memory and time
    });index.js

timeoutSeconds 的最大值是 540 或 9 分鐘。函式可使用的記憶體量會對應到為函式分配的 CPU，如 memory 有效值清單所示：

128MB - 200 MHz
256MB - 400 MHz
512MB - 800 MHz
1GB - 1.4 GHz
2GB — 2.4 GHz
4GB - 4.8 GHz
8GB - 4.8 GHz

如要在 Google Cloud 控制台中設定記憶體分配和逾時功能，請按照下列步驟操作：

在 Google Google Cloud 控制台中，從左側選單中選取「Cloud Functions」。
在函式清單中按一下函式名稱，即可選取函式。
按一下頂端選單中的「編輯」圖示。
從標示為「Memory allocation」的下拉式選單中，選取記憶體分配情形。
按一下「更多」顯示進階選項，然後在「逾時」文字方塊中輸入秒數。
按一下「Save」(儲存) 以更新函式。