Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

部署 Cloud Run 函式

本頁面介紹如何部署和修改 Cloud Run 函數。如需部署 Hello World 函式的逐步範例，請參閱「部署範例函式」。

Cloud Run 函式部署作業會自動使用 Google Cloud 的 Buildpacks 和 Cloud Build，從函式的原始碼建構容器映像檔。您不需要在本機上安裝 Docker，也不用設定建構包或 Cloud Build。

Cloud Run functions 部署作業也會使用 Artifact Registry 儲存構件及管理容器映像檔。如果您的專案尚未建立名為 cloud-run-source-deploy 的 Artifact Registry 儲存庫，則 Artifact Registry 會自動建立該儲存庫。

如果您目前有函式，且需要為了回溯相容性使用 gcloud functions deploy 指令、Cloud Functions v2 API 或 google_cloudfunctions2_function Terraform 設定，請參閱「使用 gcloud functions deploy 指令部署函式」。

事前準備

請確認您已為 Cloud Run 設定新專案，如設定頁面所述。

啟用 Artifact Registry、Cloud Build、Cloud Run Admin API 和 Cloud Logging API：

  gcloud services enable artifactregistry.googleapis.com \
      cloudbuild.googleapis.com \
      run.googleapis.com \
      logging.googleapis.com

視需要啟用 Eventarc API，使用事件觸發條件：

  gcloud services enable eventarc.googleapis.com

如果專案受限於網域限制組織政策，禁止未經驗證的叫用，您必須按照「測試私人服務」一節的說明存取已部署的服務。

必要的角色

如要部署 Cloud Run 函式，您或管理員必須將下列 IAM 角色授予部署者帳戶和服務帳戶：

按一下即可查看部署者帳戶的必要角色

如要取得從來源建構及部署所需的權限，請要求管理員授予您下列 IAM 角色：

專案的 Cloud Run 原始碼開發人員 (roles/run.sourceDeveloper)
專案的服務使用情形用戶 (roles/serviceusage.serviceUsageConsumer)
Cloud Run 服務身分上的服務帳戶使用者 (roles/iam.serviceAccountUser)

按一下即可查看 Cloud Build 服務帳戶的必要角色

除非您覆寫此行為，否則 Cloud Build 會自動使用 Compute Engine 預設服務帳戶作為預設 Cloud Build 服務帳戶來建立您的原始程式碼和 Cloud Run 資源。要讓 Cloud Build 建立您的原始程式碼，請您的管理員將 Cloud Run Builder (roles/run.builder) 授予您專案上的 Compute Engine 預設服務帳戶：

  gcloud projects add-iam-policy-binding PROJECT_ID \
      --member=serviceAccount:PROJECT_NUMBER-compute@developer.gserviceaccount.com \
      --role=roles/run.builder

請將 PROJECT_NUMBER 替換為您的 Google Cloud專案編號，並將 PROJECT_ID 替換為您的 Google Cloud專案 ID。如需如何找出專案 ID 和專案編號的詳細操作說明，請參閱「建立及管理專案」。

將 Cloud Run 建構工具角色授予 Compute Engine 預設服務帳戶後，需要幾分鐘才能傳播。

如果您使用 Eventarc，請點選查看服務帳戶所需的角色。

如果您使用 Eventarc，可以選擇將下列角色授予服務帳戶：

Cloud Build 編輯器 (roles/cloudbuild.builds.editor)
Cloud Run 管理員 (roles/run.admin)
建立服務帳戶 (roles/iam.serviceAccountCreator)
Cloud Run 呼叫器 (roles/run.invoker)
Eventarc 管理員 (roles/eventarc.admin)
專案 IAM 管理員 (roles/resourcemanager.projectIamAdmin)
服務使用情形用戶 (roles/serviceusage.serviceUsageConsumer)
儲存空間管理員 (roles/storage.admin)

如要進一步瞭解如何為 Eventarc 觸發程序授予特定角色，請參閱「Cloud Run 目標的角色和權限」。

如需與 Cloud Run 相關聯的 IAM 角色和權限清單，請參閱「Cloud Run IAM 角色」和「Cloud Run IAM 權限」。如果您的 Cloud Run 服務與Google Cloud API（例如 Cloud Client Libraries）進行接口，請參閱服務身分設定指南。有關授予角色的更多信息，請參閱部署權限和管理存取。

建立及部署函式

您可以使用 Google Cloud 控制台或 gcloud CLI 部署 Cloud Run 函式。按一下分頁標籤，瞭解如何使用自選工具。

控制台

前往 Google Cloud 控制台的 Cloud Run「Services」(服務) 頁面：

前往 Cloud Run。
按一下「編寫函式」。
在「Service name」(服務名稱) 欄位中，輸入描述函式的名稱。服務名稱開頭須為英文字母，且最多只能包含 49 個字元，包括英文字母、數字或連字號。服務名稱結尾不得為連字號，且每個區域和專案的服務名稱不得重複。服務名稱無法更改，且公開可見。
在 Region 清單中，使用預設值，或選擇要部署函數的 region。
在「執行階段」清單中，使用預設值或選取執行階段版本。
（可選）在 觸發器 部分，按一下 新增觸發器 並選擇一個選項。「Eventarc 觸發條件」窗格隨即開啟，您可以在其中修改觸發條件的下列詳細資料：
1. 在「觸發條件名稱」欄位中，輸入觸發條件名稱或使用預設名稱。
2. 從清單中選擇一個 觸發器類型，以指定下列觸發器類型之一：
  - Google 來源：指定 Pub/Sub、Cloud Storage、Firestore 和其他 Google 事件供應商的觸發條件。
  - 自訂：透過應用程式程式碼產生及取用事件。按照「Eventarc 觸發條件」窗格中的提示建立管道。通道是一種資源，它用作管道，將自訂事件從生產者傳遞給消費者。自訂事件會發布至管道，而 Eventarc 觸發條件會訂閱這些事件。
  - 第三方 與提供 Eventarc 來源的非 Google 提供者整合。詳情請參閱「Eventarc 中的第三方事件」。
3. 從清單中選取「Event provider」(事件供應商)，選取提供事件類型的產品，觸發函式。如需事件提供者清單，請參閱「事件提供者和目的地」。
4. 從清單中選擇一個 事件類型。觸發器配置會根據支援的事件類型而有所不同。詳情請參閱「事件類型」。
5. 在「Region」(區域) 欄位中，選取 Eventarc 觸發程序的位置。一般來說，Eventarc 觸發條件的位置應與要監控事件的 Google Cloud 資源位置一致。在多數情況下，您也應該在相同區域中部署函式。如要進一步瞭解 Eventarc 觸發條件的所在位置，請參閱「瞭解 Eventarc 位置」。
6. 在「服務帳戶」欄位中，選取服務帳戶。 Eventarc 觸發程序會連結至服務帳戶，在叫用函式時做為身分。Eventarc 觸發條件的服務帳戶必須具備叫用函式的權限。根據預設，Cloud Run 會使用 Compute Engine 預設服務帳戶。
7. 如有需要，請指定服務網址路徑，將傳入的要求傳送至該路徑。這是目標服務上的相對路徑，觸發器的事件應該會傳送到該路徑。例如：/、/route、route 和 route/subroute。
8. 填妥必填欄位後，按一下「儲存觸發條件」。
在「驗證」下方，設定下列項目：
- 如果您要建立公開 HTTP 函式 (例如 Webhook)，請選取「允許公開存取」。如果選取這個選項，系統會將「IAM 叫用者」角色指派給特殊 ID allUser。您可以在建立服務之後使用 IAM 編輯這項設定。如果您沒有選取這個選項的權限 (Cloud Run 管理員角色)，服務會部署並要求驗證。
- 如要建立事件觸發函式，請選取「需要驗證」。
視需要更新函式的下列其他設定：
1. 視需要設定「帳單」。
2. 在 服務擴充 下，如果您使用預設的 Cloud Run 自動擴充，則可以選擇指定最小實例數。如果您使用手動調整資源配置，請指定服務的執行個體數量。
3. 依需求設定 輸入控管 設定。
4. 展開「Container(s), Volumes, Networking, Security」部分，在適當的分頁標籤中設定其他選用設定：
按一下「建立」，然後等待 Cloud Run 使用預留位置修訂版本建立服務。
控制台會將您重定向到 Source 選項卡，您可以在那裡查看函數的原始程式碼。點選儲存並重新部署。
在「來源」分頁中，您可以視需要按一下「顯示酬載」，查看傳入事件的酬載範例。
部署完成後，按一下「測試」按鈕，測試建立的函式。

gcloud

在 Google Cloud 控制台中啟用 Cloud Shell。

啟用 Cloud Shell

控制台底部會開啟 Cloud Shell 工作階段，並顯示指令列提示。 Google Cloud Cloud Shell 是已安裝 Google Cloud CLI 的殼層環境，並已針對您目前的專案設定好相關值。工作階段可能要幾秒鐘的時間才能初始化。
將 gcloud 元件更新到最新版本：
```
gcloud components update
```
在包含程式碼範例的目錄中執行下列指令：
```
gcloud run deploy FUNCTION \
       --source . \
       --function FUNCTION_ENTRYPOINT \
       --base-image BASE_IMAGE \
       --region REGION
```
更改項目：
- 將 FUNCTION 替換為您要部署的函式名稱。您可以完全省略此參數，但如果您省略它，系統會提示您輸入名稱。
- FUNCTION_ENTRYPOINT，指定原始碼中函式的進入點。這是 Cloud Run 在函式執行時執行的程式碼。此旗標的值必須是原始碼中既有的函式名稱或完整類別名稱。
- BASE_IMAGE 函式的基礎映像檔環境，例如 nodejs24、python314、go127、java25、dotnet10、ruby40 或 php85。如要進一步瞭解基礎映像檔，以及每個映像檔包含的套件，請參閱「執行階段基礎映像檔」。
- 將 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 region 函數一起使用。
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 管理函式，您必須先將函式程式碼建構為容器映像檔，然後使用 Google Cloud Platform Provider 的 google_cloud_run_v2_service 資源，在 Terraform 設定中定義 Cloud Run 服務。

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

建立新的 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 區域。例如：europe-west1。
SERVICE 改為 Cloud Run 服務名稱。服務名稱不得超過 49 個字元，且每個區域和專案的服務名稱不得重複。
IMAGE_URL，並參照只包含已建構函式的容器映像檔
BASE_IMAGE 為您的函數指定基礎圖像環境，例如 nodejs24、python314、go127、java25、dotnet10、ruby40 或 php85。如要進一步瞭解基礎映像檔，以及每個映像檔包含的套件，請參閱「執行階段基礎映像檔」。
FUNCTION_TARGET 加上你想用來當入口點的函數名稱。

此配置允許公開存取（相當於 --allow-unauthenticated）。若要將服務設為私有，請刪除 google_cloud_run_v2_service_iam_member 部分。

初始化 Terraform：
```
terraform init
```
套用 Terraform 設定：
```
terraform apply
```
輸入 yes，確認要套用所述動作。

Cloud Run 位置

Cloud Run 具有「地區性」，這表示執行 Cloud Run 服務的基礎架構位於特定地區，並由 Google 代管，可為該地區內所有區域提供備援功能。

選擇 Cloud Run 服務的執行地區時，請將延遲時間、可用性或耐用性需求做為主要考量。一般而言，您可以選擇最靠近使用者的區域，但您應考量 Cloud Run 服務所使用的其他 Google Cloud產品位置。使用分散在不同位置的 Google Cloud 產品，可能會影響服務的延遲時間和費用。

Cloud Run 可在下列地區使用：

採用級別 1 定價

asia-east1 (臺灣) <
asia-northeast1 (東京) <
asia-northeast2 (大阪) <
asia-south1 (印度孟買)
asia-southeast3 (曼谷) <0x0A
europe-north1 (芬蘭) 二氧化碳排放量低
europe-north2 (斯德哥爾摩) 二氧化碳排放量低
europe-southwest1 (馬德里) 二氧化碳排放量低
europe-west1 (比利時) 二氧化碳排放量低
europe-west4 (荷蘭) 二氧化碳排放量低
europe-west8 (米蘭) 二氧化碳排放量低
europe-west9 (巴黎) 二氧化碳排放量低
me-west1 (特拉維夫) <0x
northamerica-south1 (墨西哥) <
us-central1 (愛荷華州) 二氧化碳排放量低
us-east1 (南卡羅來納州) <
us-east4 (北維吉尼亞州) <
us-east5 (哥倫布) <0x0
us-south1 (達拉斯) 二氧化碳排放量低
us-west1 (奧勒岡州) 二氧化碳排放量低

採用級別 2 定價

africa-south1 (約翰尼斯堡) <0x
asia-east2 (香港)
asia-northeast3 (韓國首爾)
asia-southeast1 (新加坡) <
asia-southeast2 (雅加達) <0x0
asia-south2 (印度德里)
australia-southeast1 (雪梨) <0x0A
australia-southeast2 (墨爾本) <0x0
europe-central2 (波蘭華沙) 二氧化碳排放量低
europe-west10 (柏林) <0x0A
europe-west12 (杜林) 二氧化碳排放量低
europe-west2 (英國倫敦) 二氧化碳排放量低
europe-west3 (德國法蘭克福)
europe-west6 (瑞士蘇黎世) 二氧化碳排放量低
me-central1 (杜哈) <0x0A
me-central2 (達曼) <0x0A
northamerica-northeast1 (蒙特婁) 二氧化碳排放量低
northamerica-northeast2 (多倫多) 二氧化碳排放量低
southamerica-east1 (巴西聖保羅) 二氧化碳排放量低
southamerica-west1 (智利聖地牙哥) 二氧化碳排放量低
us-west2 (洛杉磯) 二氧化碳排放量低
us-west3 (鹽湖城)
us-west4 (拉斯維加斯) <0x

如果您已建立 Cloud Run 服務，即可在 Google Cloud 控制台的 Cloud Run 資訊主頁中查看區域。

啟用事件重試功能

Eventarc 使用 Pub/Sub 做為傳輸層，且預設的重試政策可能不適用於您的函式。

建立 Eventarc 觸發條件後，強烈建議您更新 Eventarc 中的重試政策，並在 Pub/Sub 中設定dead-letter 主題。

指定映像檔存放區

Cloud Run 函式部署作業會使用 Artifact Registry 儲存構件及管理容器映像檔。如果您的專案尚未建立名為 REGION-docker.pkg.dev/PROJECT_ID/cloud-run-source-deploy 的 Artifact Registry 儲存庫，則 Artifact Registry 會自動建立該儲存庫。

若要指定一個自行建立的 Artifact Registry 儲存庫，請使用下列命令：

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 為您的函數指定基礎圖像環境，例如 nodejs24、python314、go127、java25、dotnet10、ruby40 或 php85。如要進一步瞭解基礎映像檔，以及每個映像檔包含的套件，請參閱「執行階段基礎映像檔」。
將 REGION 替換為要部署函式的 Google Cloud 區域。例如：europe-west1。
IMAGE_URL，並使用您選擇的 Artifact Registry 映像檔存放區參照映像檔路徑，例如 projects/PROJECT_NAME/locations/LOCATION/repositories/REPOSITORY_NAME/FUNCTION。圖片名稱必須與您要建立的函式名稱相符。如果只提供儲存庫路徑，則將使用函數名稱 FUNCTION 建立映像。

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

IAM 設定：

請確保您已設定 IAM 權限以部署來自 other Google Cloud projects 的映像。
此外，請確認建構服務帳戶已獲得授權，可讀取及寫入 REPOSITORY。

網路設定：

確保目標 REPOSITORY 可從目前專案配置存取。

VPC Service Controls 設定：

請確認建構服務帳戶可以連線至 VPC-SC perimeter 內的目標 REPOSITORY。

資料落地限制：

請注意，在函式所處區域以外的區域指定 REPOSITORY，會導致資料跨區域傳輸。

修改現有函式

您可以修改函式的設定或程式碼：

修改設定

如要修改設定參數 (例如計費方案、記憶體和虛擬私有雲連線)，請按照適當分頁中的操作說明進行：

控制台

前往 Google Cloud 控制台的 Cloud Run「Services」(服務) 頁面：

前往 Cloud Run。
在服務清單中找到要更新的服務，然後按一下以開啟該服務的詳細資訊。
在適當的分頁中修改設定。
按一下 查看差異比較並重新部署，然後按一下 部署變更 以部署您的變更。

gcloud

在 Google Cloud 控制台中啟用 Cloud Shell。

啟用 Cloud Shell

控制台底部會開啟 Cloud Shell 工作階段，並顯示指令列提示。 Google Cloud Cloud Shell 是已安裝 Google Cloud CLI 的殼層環境，並已針對您目前的專案設定好相關值。工作階段可能要幾秒鐘的時間才能初始化。
若要更新一個或多個服務設定，請使用 gcloud run services update SERVICE 命令，並加上要更新的設定的命令列標誌。將 SERVICE 改為服務名稱。

重新部署新的原始碼

您可以使用 Google Cloud 控制台或 gcloud CLI，修改函式的基礎映像檔、執行階段和原始碼。

按一下分頁標籤，瞭解如何使用自選工具。

控制台

前往 Google Cloud 控制台的 Cloud Run「Services」(服務) 頁面：

前往 Cloud Run。
在「Services」(服務) 清單中找出要更新的函式，然後按一下開啟該函式的詳細資料。
前往「來源」分頁，然後按一下「編輯來源」。
按一下「基礎映像檔」旁的「編輯執行階段和安全性更新」，然後視需要從清單中選取其他「執行階段」或「環境」，並按一下「儲存並重新部署」。
視需要修改函式進入點。
在文件部分，選擇 新增文件 建立新文件，選擇 重新命名文件 重新命名文件，或選擇 刪除文件 刪除文件。
在「程式碼」部分中，視需要修改原始碼。
按一下 儲存並重新部署，然後等待部署完成。

gcloud

在 Google Cloud 控制台中啟用 Cloud Shell。

啟用 Cloud Shell

控制台底部會開啟 Cloud Shell 工作階段，並顯示指令列提示。 Google Cloud Cloud Shell 是已安裝 Google Cloud CLI 的殼層環境，並已針對您目前的專案設定好相關值。工作階段可能要幾秒鐘的時間才能初始化。
在包含函式原始碼的目錄中執行下列指令：
```
gcloud run deploy FUNCTION \
       --source . \
       --function FUNCTION_ENTRYPOINT \
       --base-image BASE_IMAGE \
       --region REGION
```
更改項目：
- FUNCTION 替換為要修改的函數名稱。
- FUNCTION_ENTRYPOINT 替換為原始碼中函式的進入點。
- BASE_IMAGE 為您的函數指定基礎圖像環境，例如 nodejs24、python314、go127、java25、dotnet10、ruby40 或 php85。
  
  或者，如要在堆疊中使用特定系統套件，或指定要從哪個區域下載基礎映像檔，可以指定下列其中一項：
  - 完整的基本映像檔路徑，例如 us-central1-docker.pkg.dev/serverless-runtimes/google-24-full/runtimes/nodejs24。這個選項可讓您指定基本映像檔、堆疊中的特定系統套件，以及要從哪個地區下載基本映像檔。
  - 完整基本圖片路徑的別名，例如 google-24/nodejs24 或 google-24-full/nodejs24。這種較短的別名選項可讓您指定堆疊中的基礎映像和特定的系統軟體包。
  如要進一步瞭解基礎映像檔，以及每個映像檔中包含的套件，請參閱「執行階段基礎映像檔」。
- 將 REGION 替換為要部署函式的 Google Cloud 區域。例如：europe-west1。
選用旗標

修改函式時，您可以設定下列選用旗標：
- 建構環境變數旗標，用於在建構步驟中指定環境變數，例如設定建構時間專屬的憑證或參數。
- 工作站集區標記，用於指定要在 VPC Service Controls 安全建構環境中使用哪個工作站集區。
- 自訂建構服務帳戶標記，可指定預設建構服務帳戶的替代方案，以提高安全性。
- 自動更新基本映像檔旗標，可停用自動更新功能。根據預設，函式會啟用自動安全性更新。

停用部署健康檢查

根據預設，Cloud Run 會啟動執行個體，並等待啟動探測通過，藉此檢查部署作業是否正常。如果健康狀態檢查失敗，系統會將修訂版本標示為不健康，且不會將流量轉送至該版本。

如果不需要或想加快部署速度，可以停用部署健康狀態檢查：

gcloud

如要停用部署健康狀態檢查，請使用 --no-deploy-health-check 旗標：

gcloud run deploy --image IMAGE_URL --no-deploy-health-check

更改下列內容：

IMAGE_URL：容器映像檔的參照，例如 us-docker.pkg.dev/cloudrun/container/hello:latest。如果您使用 Artifact Registry，則必須先建立存放區 REPO_NAME。網址格式為 LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG 。

如果先前已停用部署健康狀態檢查，請使用 --deploy-health-check 重新啟用。

YAML

如要停用部署健康狀態檢查，請將值為 'true' 的 run.googleapis.com/health-check-disabled 註解新增至 spec.template.metadata.annotations。

apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: SERVICE
spec:
  template:
    metadata:
      annotations:
        run.googleapis.com/health-check-disabled: 'true'

Terraform

如要停用部署健康狀態檢查，請在 template 區塊中，將 health_check_disabled 引數設為 true。

resource "google_cloud_run_v2_service" "default" {
  name     = "SERVICE"
  ...
  template {
    health_check_disabled = true
    ...
  }
}

來源 Bucket

建構程序和Google Cloud 控制台來源編輯器必須能存取原始碼。這是透過將原始程式碼上傳到 Cloud Storage 儲存桶來實現的。

使用 gcloud CLI 或 Google Cloud 控制台部署時，系統會自動佈建 Cloud Storage bucket，並為您上傳原始碼。預設情況下，您的程式碼儲存在名為 run-sources-PROJECT_ID-REGION 的儲存桶中。您必須負責管理這個值區中的存取控制清單 (ACL) 和來源物件。

如需使用特定 bucket (例如使用客戶自行管理的加密金鑰 (CMEK))，請先將本機來源檔案封裝成封存檔 (例如 ZIP 檔案)。然後將這個封存檔上傳至 bucket。如要從這個自訂位置部署，請使用 gcloud CLI 和 --source=gs://BUCKET_NAME/OBJECT_PATH 旗標。

後續步驟

部署新的 Cloud Run 函式後，您可以執行下列操作：

部署 Cloud Run 函式 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

事前準備

必要的角色

按一下即可查看部署者帳戶的必要角色

按一下即可查看 Cloud Build 服務帳戶的必要角色

如果您使用 Eventarc，請點選查看服務帳戶所需的角色。

建立及部署函式

控制台

gcloud

Terraform

Cloud Run 位置

採用級別 1 定價

採用級別 2 定價

啟用事件重試功能

指定映像檔存放區

gcloud

修改現有函式

修改設定

控制台

gcloud

重新部署新的原始碼

控制台

gcloud

選用旗標

停用部署健康檢查

gcloud

YAML

Terraform

來源 Bucket

後續步驟

部署 Cloud Run 函式