管理函式
本指南說明如何管理及卸載使用 gcloud functions 指令建立的函式。如要瞭解如何管理使用 gcloud run 指令建立的函式,請參閱「管理 Cloud Run 服務」。
使用 Cloud Functions v2 API (例如使用 gcloud functions、REST API 或 Terraform) 建立的函式,可透過 Cloud Run Admin API 和 Cloud Functions v2 API 管理。舉例來說,您可以使用 gcloud functions 或 gcloud 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.comAPI 管理觸發條件。請務必詳閱 Eventarc 或 Pub/Sub 的觸發條件管理指南。 - Cloud Run 不支援停用失敗時重試功能。
- 在卸載作業期間,Cloud Run 函式會修改連結至函式的觸發條件 (這些函式已設定為失敗時不重試),以確保基礎 Pub/Sub 主題最多會嘗試傳送五次。卸載作業完成後,無效信件佇列主題會儲存未傳送的訊息,您可以對無效信件佇列建立新訂閱以擷取這些訊息。如要為 DLQ 主題使用客戶管理的加密金鑰 (CMEK),可以在卸載後更新主題的 CMEK。
- 成功卸載函式後,系統會建立新的 Cloud Run 修訂版本。從該修訂版本開始,系統會使用 Cloud Run SKU 為函式計費。
卸載函式
您可以使用下列指令卸載函式:
gcloud functions detach FUNCTION_NAME
以您的函式名稱取代 FUNCTION_NAME。