管理函式

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

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

gcloud 函式

  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 v2 函式從現有 API 環境中卸載。函式卸載後,您只能使用 Cloud Run Admin API 管理函式。如果工作負載需要留在 run.googleapis.com API 邊界內以使用 Assured Workloads,或是為了確保工作負載使用 Cloud Run SKU,您可能需要執行這項操作。

做好卸載函式的準備

準備卸載函式時,請注意下列事項:

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

卸載函式

您可以使用下列指令卸載函式:

gcloud functions detach FUNCTION_NAME

以您的函式名稱取代 FUNCTION_NAME