管理函式

本指南說明如何管理及分離使用 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=nodejs22 \
    --source= . \
    --entry-point=ENTRYPOINT
    --trigger-http

gcloud run 

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

卸離

gcloud functions detach 指令可讓您將 Cloud Functions v2 函式與現有的 API 環境解除連結。卸離函式後，您只能使用 Cloud Run Admin API 管理函式。如果工作負載需要留在 Assured Workloads 的 run.googleapis.com API 邊界內，或是要確保工作負載使用 Cloud Run SKU，建議您這麼做。

準備函式以便卸離

準備卸載函式時，請考量以下事項：

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

卸離函式

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

gcloud functions detach FUNCTION_NAME

將 FUNCTION_NAME 替換為函式名稱。