部署 Cloud Run 函式

主控台

1. 前往 Google Cloud 控制台的「Cloud Run」頁面：

   前往 Cloud Run

2. 按一下「編寫函式」。

3. 在「Service name」欄位中，輸入描述函式的名稱。服務名稱開頭須為英文字母，且最多只能包含 49 個字元 (包括英文字母、數字或連字號)。服務名稱結尾不得使用連字號，且每個區域和專案的名稱不得重複。服務名稱一經設定即無法變更，而且會公開顯示。

4. 在「Region」清單中，使用預設值，或選取要部署函式的區域。

5. 在「Runtime」清單中，使用預設值或選取執行階段版本。

6. 您也可以在「觸發條件」部分中按一下「新增觸發條件」，然後選取所需選項。Eventarc 觸發條件窗格隨即開啟，您可以修改觸發條件的下列詳細資料：

   1. 在「Trigger name」欄位中輸入觸發條件名稱，或使用預設名稱。

   2. 從清單中選取「觸發條件類型」，指定下列其中一種觸發條件類型：

      • Google 來源：指定 Pub/Sub、Cloud Storage、Firestore 和其他 Google 事件供應器的觸發事件。

      • 自訂：透過應用程式程式碼產生及取用事件。按照 Eventarc 觸發條件窗格中的提示建立管道。管道是用來將自訂事件從供應端傳送至用戶端的資源。自訂事件會發布至管道，而 Eventarc 觸發條件會訂閱這些事件。

      • 第三方：整合提供 Eventarc 來源的非 Google 供應商。詳情請參閱「Eventarc 中的第三方事件」。

   3. 從清單中選取事件供應器，即可選取提供觸發函式的事件類型產品。如要查看事件提供者清單，請參閱「事件提供者和目的地」。

   4. 從清單中選取「事件類型」。觸發條件設定會因支援的事件類型而異。詳情請參閱「事件類型」。

   5. 在「Region」欄位中，選取 Eventarc 觸發事件的位置。一般來說，Eventarc 觸發條件的位置應與您要監控事件的 Google Cloud 資源位置一致。在大多數情況下，您也應在相同的地區部署函式。如要進一步瞭解 Eventarc 觸發條件的所在位置，請參閱「瞭解 Eventarc 位置」。

   6. 在「服務帳戶」欄位中，選取服務帳戶。Eventarc 觸發事件會連結至服務帳戶，以便在叫用函式時做為身分使用。Eventarc 觸發事件的服務帳戶必須具備叫用函式的權限。根據預設，Cloud Run 會使用 Compute Engine 預設服務帳戶。

   7. 您可以視需要指定要傳送傳入要求的服務網址路徑。這是目的地服務中的相對路徑，應將觸發事件傳送至此路徑。例如：/、/route、route 和 route/subroute。

   8. 填妥必填欄位後，按一下「儲存觸發條件」。

7. 在「Authentication」下方，設定下列項目：

   • 如果您要建立公開的 HTTP 函式 (例如 webhook)，請選取「Allow unauthenticated invocations」。如果選取這個選項，系統會將「IAM 叫用者」角色指派給特殊 ID allUser。您可以在建立服務之後使用 IAM 編輯這項設定。如果您沒有權限 (Cloud Run 管理員角色) 選取這項功能，系統會部署服務並要求驗證。

   • 如果您要建立事件觸發函式，請選取「需要驗證」。

8. 您可以視需要為函式更新下列其他設定：

   1. 視需要設定帳單。

   2. 在「服務資源調度」下方，如果您使用預設的 Cloud Run 自動調度資源，可以視需要指定執行個體數量下限。如果您使用手動調整資源配置，請指定服務的執行個體數量。

   3. 視需要設定入站控管。

   4. 展開「容器、磁碟區、網路與安全性」專區，在適當的分頁中設定其他選用設定：

      • 並行
      • 容器設定
      • CPU 限制
      • 記憶體限制
      • 要求逾時
      • 密鑰
      • 環境變數
      • 執行環境
      • HTTP/2
      • 服務帳戶
      • Cloud SQL 連線
      • 虛擬私有雲連線

9. 按一下「Create」(建立)，然後等待 Cloud Run 使用預留位置修訂版本建立服務。

10. 主控台會將您重新導向至「來源」分頁，您可以在該分頁中查看函式的原始碼。按一下「儲存並重新部署」。

11. 在「Source」分頁中，您可以選擇按一下「Show Payload」，查看傳入事件的酬載範例。

12. 部署完成後，按一下「Test」按鈕，測試所建立的函式。

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. 將 gcloud 元件更新至最新版本：

   gcloud components update

3. 在包含範例程式碼的目錄中執行下列指令：

   gcloud run deploy FUNCTION \
          --source . \
          --function FUNCTION_ENTRYPOINT \
          --base-image BASE_IMAGE \
          --region REGION
   

   取代：

   • FUNCTION 替換為您要部署的函式名稱。您可以將這個參數完全省略，這樣系統會提示您輸入名稱。

   • FUNCTION_ENTRYPOINT 與原始碼中函式的進入點。這是 Cloud Run 在函式執行時執行的程式碼。這個標記的值必須是來源程式碼中存在的函式名稱或完全限定的類別名稱。

   • BASE_IMAGE 搭配函式的基礎映像檔環境，例如 nodejs22、python313、go123、java21、dotnet8、ruby34 或 php84。如要進一步瞭解基準映像檔和各個映像檔所包含的套件，請參閱「執行階段基準映像檔」。

   • REGION 與您要部署函式的 Google Cloud 區域。例如：europe-west1。

   選用：

   • 如果您要建立公開的 HTTP 函式 (例如 webhook)，請指定 --allow-unauthenticated 標記。這個標記會將 Cloud Run IAM 叫用者角色指派給特殊 ID allUser。您可以在建立服務之後使用 IAM 編輯這項設定。如果您要建立事件觸發函式或經過驗證的服務，可以省略這個標記。

您可以選擇在部署函式後，將 Eventarc 觸發事件新增至函式。如要新增觸發條件，請執行下列指令：

  gcloud eventarc triggers create EVENTARC_TRIGGER_NAME \
      --location=EVENTARC_TRIGGER_LOCATION \
      --destination-run-service=FUNCTION \
      --destination-run-region=REGION \
      --event-filters="type=EVENTARC_FILTER_TYPE" \
      --event-filters="EVENTARC_EVENT_FILTER" \
      --service-account=EVENTARC_TRIGGER_SERVICE_ACCOUNT

取代：

• EVENTARC_TRIGGER_NAME 替換為 Eventarc 觸發事件的名稱。

• EVENTARC_TRIGGER_LOCATION 與 Eventarc 觸發條件的所在位置。一般來說，Eventarc 觸發條件的位置應與您要監控事件的 Google Cloud 資源位置一致。在大多數情況下，您也應在相同的地區部署函式。如要進一步瞭解 Eventarc 觸發條件的所在位置，請參閱「瞭解 Eventarc 位置」。

• FUNCTION 替換為您已部署函式的名稱。

• REGION 與函式的 Cloud Run 區域。

• EVENTARC_FILTER_TYPE 與觸發條件監控的事件篩選器。符合所有 --event-filters 篩選條件的事件會觸發對函式的呼叫。每個觸發條件都必須有支援的事件類型，格式為 --event-filters="type=EVENTARC_FILTER_TYPE"。此事件類型建立後即無法變更。如要變更 EVENT_FILTER_TYPE，請建立新的觸發條件並刪除舊的觸發條件。您也可以在 ATTRIBUTE=VALUE 表單中使用支援的篩選器重複 --event-filters 標記，以便新增更多篩選器。

• EVENTARC_TRIGGER_SERVICE_ACCOUNT 與服務帳戶。Eventarc 觸發事件會連結至服務帳戶，以便在叫用函式時做為身分使用。Eventarc 觸發事件的服務帳戶必須具備叫用函式的權限。根據預設，Cloud Run 會使用預設的運算服務帳戶。

Terraform

如要使用 Terraform 管理函式，您必須將函式程式碼建構為容器映像檔，然後在 Terraform 設定中使用 Google Cloud Platform 供應器的 google_cloud_run_v2_service 資源，定義 Cloud Run 服務。

1. 請按照從頭開始建構函式的操作說明，建立與自動安全性更新相容的容器映像檔。複製下一個步驟中使用的 IMAGE_URL 變數容器映像檔完整路徑。

2. 建立新的 main.tf 檔案，並加入下列內容：

   provider "google" {
     project = "PROJECT-ID"
   }
   
   resource "google_cloud_run_v2_service" "default" {
     name     = "SERVICE"
     location = "REGION"
     client   = "terraform"
     template {
       containers {
         name = "SERVICE"
         image = "IMAGE_URL" # Container image built from your function in the previous step.
         base_image_uri = "BASE_IMAGE"
       }
     }
     build_config{
       function_target = "FUNCTION_TARGET"
       image_uri = "IMAGE_URL"
       base_image = "BASE_IMAGE"
       enable_automatic_updates = true
     }
   }
   resource "google_cloud_run_v2_service_iam_member" "noauth" {
     location = google_cloud_run_v2_service.default.location
     name     = google_cloud_run_v2_service.default.name
     role     = "roles/run.invoker"
     member   = "allUsers"
   }
   

   取代：

   • PROJECT-ID 與 Google Cloud 專案 ID。
   • 將 REGION 替換為 Google Cloud 區域。
   • SERVICE 改為 Cloud Run 服務名稱。服務名稱長度不得超過 49 個字元，且每個區域和專案的名稱不得重複。
   • IMAGE_URL，參照僅包含已建構函式的容器映像檔
   • BASE_IMAGE 搭配函式的基礎映像檔環境，例如 nodejs22、python313、go123、java21、dotnet8、ruby34 或 php84。如要進一步瞭解基準映像檔和各個映像檔所包含的套件，請參閱「執行階段基準映像檔」。
   • FUNCTION_TARGET 與您要用來做為進入點的函式名稱。

   這項設定可允許公開存取 (等同於 --allow-unauthenticated)。如要將服務設為私人，請移除 google_cloud_run_v2_service_iam_member 節。

3. 初始化 Terraform：

   terraform init

4. 套用 Terraform 設定：

   terraform apply

   輸入 yes 確認要套用所述動作。

gcloud

gcloud run deploy FUNCTION \
  --source . \
  --function FUNCTION_ENTRYPOINT \
  --base-image BASE_IMAGE \
  --region REGION \
  --image IMAGE_URL

更改下列內容：

• FUNCTION 替換為您要部署的函式名稱。您可以將這個參數完全省略，這樣系統會提示您輸入名稱。

• FUNCTION_ENTRYPOINT 與原始碼中函式的進入點。這是 Cloud Run 在函式執行時執行的程式碼。這個標記的值必須是來源程式碼中存在的函式名稱或完全限定的類別名稱。

• BASE_IMAGE 搭配函式的基礎映像檔環境，例如 nodejs22、python313、go123、java21、dotnet8、ruby34 或 php84。如要進一步瞭解基準映像檔和各個映像檔所包含的套件，請參閱「執行階段基準映像檔」。

• REGION 與您要部署函式的 Google Cloud 區域。例如：us-central1。

• IMAGE_URL，其中引用映像檔路徑使用您選擇的 Artifact Registry 映像檔存放區，例如 projects/PROJECT_NAME/locations/LOCATION/repositories/REPOSITORY_NAME/FUNCTION。圖片名稱必須與您要建立的函式名稱相符。如果只提供存放區路徑，系統會使用函式名稱 FUNCTiON 建立映像檔。

指定位於其他專案或區域的 Artifact Registry 存放區時，請務必考量以下事項：

IAM 設定：

• 確認您已設定 IAM 權限，可部署其他 Google Cloud 專案的映像檔
• 此外，請確認建構服務帳戶已授權存取 REPOSITORY 的讀取和寫入權限。

網路設定：

• 請確認目標 REPOSITORY 可從目前的專案設定存取。

VPC Service Controls 設定：

• 請確認建構服務帳戶可在 VPC-SC 範圍內存取目標 REPOSITORY。

資料落地限制：

• 請注意，如果您在函式所在區域以外的區域指定 REPOSITORY，系統就會在不同區域之間移轉資料。

控制台

1. 前往 Google Cloud 控制台的「Cloud Run」頁面：

   前往 Cloud Run

2. 在服務清單中找出您要更新的服務，然後按一下該服務的詳細資料。

3. 按一下「Edit & deploy new revision」，即可顯示修訂版本部署表單。

4. 修改任何設定。

5. 按一下「Deploy」，然後等待部署作業完成。

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. 如要更新一或多項服務設定，請使用 gcloud run services update SERVICE 指令，搭配要更新的設定的指令列標記。將 SERVICE 改為服務名稱。

主控台

1. 前往 Google Cloud 控制台的「Cloud Run」頁面：

   前往 Cloud Run

2. 在「Services」清單中找出要更新的函式，然後按一下該函式的詳細資料。

3. 前往「來源」分頁，然後按一下「編輯來源」。

4. 按一下「Base image」旁的 mode「Edit runtime and security updates」，然後視需要從清單中選取其他「Runtime」或「Environment」，然後按一下「Save」。

5. 視需要修改函式進入點。

6. 在「檔案」部分，選取 add「新增檔案」來建立新檔案，選取 mode「重新命名檔案」來重新命名檔案，或是選取 delete「刪除檔案」來刪除檔案。

7. 在「Code」部分，視需要修改原始碼。

8. 按一下「儲存並重新部署」，然後等待部署作業完成。

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. 在包含函式原始碼的目錄中執行下列指令：

   gcloud run deploy FUNCTION \
          --source . \
          --function FUNCTION_ENTRYPOINT \
          --base-image BASE_IMAGE \
          --region REGION
   

   取代：

   • FUNCTION 與您要修改的函式名稱。

   • FUNCTION_ENTRYPOINT 與原始碼中函式的進入點。

   • BASE_IMAGE 搭配函式的基礎映像檔環境，例如 nodejs22、python313、go123、java21、dotnet8、ruby34 或 php84。

     或者，如果您想在堆疊中使用特定系統套件，或指定下載基本映像檔的區域，可以指定下列任一項目：

     • 完整的基本映像檔路徑，例如 us-central1-docker.pkg.dev/serverless-runtimes/google-22-full/runtimes/nodejs22。您可以使用這個選項指定基礎映像檔、堆疊中的特定系統套件，以及基礎映像檔的下載區域。
     • 完整基本圖片路徑的別名，例如 google-22/nodejs22 或 google-22-full/nodejs22。這個較短的別名選項可讓您指定堆疊中的基礎映像檔和特定系統套件。

     如要進一步瞭解基礎映像檔和各個映像檔所包含的套件，請參閱「執行階段基礎映像檔」。

   • REGION 與您要部署函式的 Google Cloud 區域。例如：us-central1。

   選用標記

   您可以在修改函式時設定下列選用標記：

   • 建構環境變數標記，用於在建構步驟期間指定環境變數，例如設定建構時的特定憑證或參數。

   • Worker pool 標記，用於指定在 VPC Service Controls 安全建構情境中要使用的 worker pool。

   • 自訂 Build 服務帳戶標記，可指定預設 Build 服務帳戶的替代方案，以提升安全性。

   • 自動更新基本映像檔標記，停用自動更新功能。根據預設，函式會啟用自動安全性更新功能。