Cloud Run functions 簡介

本指南會簡要介紹其他 Google Cloud 服務 在 Cloud Run 函式部署程序中扮演的角色。

事前準備

請先參閱「Cloud Run 部署選項和資源模型」指南，熟悉 Cloud Run 函式和原始碼部署概念。

架構總覽

將函式的原始碼部署至 Cloud Run 函式時，該原始碼會儲存在 Cloud Storage bucket 中。接著，Cloud Build 會自動將程式碼建構為容器映像檔，並將該映像檔推送至 Artifact Registry 映像檔登錄檔。Cloud Run 函式會在需要執行容器來執行函式時存取這個映像檔。

在下圖中，Cloud Run functions 方塊代表使用 Cloud Run Admin API 或 Cloud Functions API 部署在 Cloud Run 中的函式。一般來說，較新的函式會使用 Cloud Run Admin API 部署，較舊的函式則使用 Cloud Functions API 部署。

從 Google Cloud 控制台呼叫 Cloud Run Admin API。
圖 1. 使用者準備函式原始碼，並將其部署至 Cloud Run。

視部署函式時使用的 API 而定，會發生下列情況：

  • 如果您使用 Cloud Run Admin API 部署函式，會發生下列情況：

    1. 您的原始碼會上傳至沒有保留期限的 Cloud Storage bucket。

      1. 如果您使用預設加密，系統會自動產生值區名稱，並命名為 run-sources-PROJECT_ID-REGION。
      2. 如果使用客戶自行管理的加密金鑰 (CMEK) 保護資料，系統不會自動產生 bucket 名稱，您必須提供 bucket 名稱。

    2. 原始碼會提交至 Cloud Build，由 Google Cloud 的建構套件和 Functions Framework 建立容器映像檔。請注意，Cloud Build 服務帳戶會建構容器映像檔。Cloud Run 預設會使用 Cloud Build 提供的e2-standard-2 機器類型。

    3. 系統會自動建立名為 REGION-docker.pkg.dev/PROJECT_ID/cloud-run-source-deploy 的 bucket，並透過該 bucket 將容器映像檔上傳至 Artifact Registry。

    4. 映像檔會以服務的形式部署至 Cloud Run。

    5. 您可以使用 Eventarc、Pub/Sub 或其他 HTTP 觸發條件觸發或叫用函式。

  • 如果您使用 Cloud Functions API (第 2 版) 部署函式，會發生下列情況：

    1. 您的原始碼會上傳至沒有保留期限的 Cloud Storage bucket。

      系統會自動產生值區名稱，格式如下：

      1. 如果您使用預設加密，這個值區會命名為 gcf-v2-sources-PROJECT_NUMBER-REGION。
      2. 如果您使用 CMEK 保護資料，值區名稱為 gcf-sources-PROJECT_NUMBER-REGION-CMEK_KEY_HASH。

    2. 原始碼會提交至 Cloud Build，由 Google Cloud 的建構套件和 Functions Framework 建立容器映像檔。請注意，Cloud Build 服務帳戶會建構容器映像檔。Cloud Run 預設會使用 Cloud Build 提供的e2-standard-2 機器類型。

    3. 系統會自動建立名為 REGION-docker.pkg.dev/PROJECT_ID/gcf-artifacts 的 bucket，並透過該 bucket 將容器映像檔上傳至 Artifact Registry。

    4. 映像檔會以服務的形式部署至 Cloud Run。

    5. 您可以使用 Eventarc、Pub/Sub 或其他 HTTP 觸發條件觸發或叫用函式。

後續步驟