管理函式

本指南說明如何管理及分離使用 gcloud functions 指令建立的函式。如要瞭解如何管理使用 gcloud run 指令建立的函式，請參閱「管理 Cloud Run 服務」。

使用 Cloud Functions 第 2 代 API (例如使用 gcloud functions、REST API 或 Terraform) 建立的函式，可透過 Cloud Run Admin API 和 Cloud Functions 第 2 代 API 管理。舉例來說，您可以使用 gcloud functions 或 gcloud run 指令更新現有函式：

gcloud functions 

  gcloud functions deploy FUNCTION_NAME \
    --runtime=nodejs24 \
    --source= . \
    --entry-point=ENTRYPOINT
    --trigger-http

gcloud run 

gcloud run deploy FUNCTION_NAME \
  --source= . \
  --function=ENTRYPOINT
  --base-image=google-22-full/nodejs24

卸離

gcloud functions detach 指令可讓您將 Cloud Functions 第 2 代函式從現有 API 環境中分離。函式分離後，您只能使用 Cloud Run Admin API 管理函式。如果工作負載需要留在 run.googleapis.com API 邊界內，才能使用 Assured Workloads，或是為了確保工作負載使用 Cloud Run SKU，您可能需要執行這項操作。

準備卸離函式

準備卸離函式時，請注意下列事項：

  • 分開作業無法復原。
  • 無法對 Cloud Run functions (第 1 代) 執行分離作業。
  • 熟悉如何使用 Google Cloud 控制台、Google Cloud CLI 和 Terraform，在 Cloud Run 中部署函式。
  • HTTP 函式會保留其指派的網址。
  • 系統會保留附加至事件導向函式的觸發條件。
  • 您無法直接透過 run.googleapis.com API 管理觸發條件。 請務必詳閱 Eventarc 或 Pub/Sub 的觸發條件管理指南。
  • Cloud Run 不支援停用「失敗時重試」功能。
    • 在分離作業期間，Cloud Run 函式會修改附加至函式的觸發條件 (這些函式已設定為失敗時不重試)，確保基礎 Pub/Sub 主題最多會嘗試傳送五次。卸離作業完成後，無效信件佇列主題會儲存未傳送的訊息，您可以建立無效信件佇列的新訂閱項目來擷取這些訊息。如要為 DLQ 主題使用客戶管理的加密金鑰，可以在分離後更新主題的 CMEK。
  • 成功分離函式後，系統會建立新的 Cloud Run 修訂版本。從該修訂版本開始，系統會使用 Cloud Run SKU 計費。

取消連結函式

您可以使用下列指令分離函式：

gcloud functions detach FUNCTION_NAME

將 FUNCTION_NAME 換成您的函式名稱。