將容器映像檔部署至 Cloud Run 服務

控制台

如何部署容器映像檔：

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

   前往 Cloud Run。

2. 按一下「Deploy container」(部署容器)，顯示「Create service」(建立服務) 表單。

3. 在表單中選取部署選項。

   1. 如要手動部署容器，請選取「透過現有的容器映像檔部署單一修訂版本」，並指定容器映像檔。

   2. 如要自動執行持續部署作業，請選取「持續透過原始碼存放區部署新的修訂版本」，然後按照持續部署作業的說明操作。

4. 輸入服務名稱。服務名稱不得超過 49 個字元，且每個區域和專案的服務名稱不得重複。服務名稱一經設定即無法變更，而且會公開顯示。

5. 在「Region」(區域) 欄位中， 選取要使用服務的區域。

   區域選取器會顯示價格區間、網域對應的可用性，並醒目顯示碳影響最低的區域。

6. 在「驗證」下方，設定下列項目：

   • 如要建立公用 API 或網站，請選取「允許公開存取」。如果選取這個選項，系統會將「IAM 叫用者」角色指派給特殊 ID allUser。您可以在建立服務之後使用 IAM 編輯這項設定。
   • 如要透過驗證保護安全服務，請選取「需要驗證」。

7. 視需要設定帳單。

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

9. 視需要在表單中設定 Ingress 設定。

10. 按一下「容器、網路、安全性」，在適當的分頁中設定其他選用設定：

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

11. 設定完服務後，請按一下「Create」(建立)，將映像檔部署到 Cloud Run，然後等待部署作業完成。

12. 按一下畫面顯示的網址連結，開啟您所部署服務的穩定專屬端點。

gcloud

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

   啟用 Cloud Shell

   控制台底部會開啟 Cloud Shell 工作階段，並顯示指令列提示。 Google Cloud Cloud Shell 是已安裝 Google Cloud CLI 的殼層環境，並已針對您目前的專案設定好相關值。工作階段可能要幾秒鐘的時間才能初始化。

2. 如何部署容器映像檔：

   1. 請執行下列指令：

      gcloud run deploy SERVICE --image IMAGE_URL

      更改下列內容：

      • SERVICE：要部署的服務名稱。服務名稱不得超過 49 個字元，且每個區域和專案的服務名稱不得重複。如果服務尚未存在，這個指令會在部署期間建立服務。您可以完全省略這個參數，這樣系統會提示您輸入服務名稱。
      • IMAGE_URL：容器映像檔的參照，例如 us-docker.pkg.dev/cloudrun/container/hello:latest。如果您使用 Artifact Registry，則必須先建立存放區 REPO_NAME。網址格式為 LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG 。請注意，如果未提供 --image 標記，部署指令會嘗試從原始碼部署。

      如要建立公用 API 或網站，請使用 --allow-unauthenticated 旗標，允許公開存取服務。這會 將 Cloud Run 叫用者 IAM 角色 指派給 allUsers。您也可以指定 --no-allow-unauthenticated 來禁止公開存取。如果省略任一標記，在執行 deploy 指令時系統會提示您進行確認。

   2. 等待部署作業完成。成功完成時，畫面會顯示成功訊息，還有已部署服務的網址。

   請注意，如要部署到「不是」使用 run/region gcloud 屬性設定的位置，請使用以下指令：

   gcloud run deploy SERVICE --region REGION

YAML

您可以將服務規格儲存在 YAML 檔案中，然後使用 gcloud CLI 部署。

1. 建立新的 service.yaml 檔案，並加入以下內容：

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
   spec:
     template:
       spec:
         containers:
         - image: IMAGE

   更改下列內容：

   • SERVICE：Cloud Run 服務的名稱。 服務名稱不得超過 49 個字元，且每個區域和專案的服務名稱不得重複。
   • IMAGE：容器映像檔的網址。

   您也可以指定更多設定，例如環境變數或記憶體限制。

2. 使用下列指令部署新服務：

   gcloud run services replace service.yaml

   如果存在 service.yaml 檔案，gcloud run services replace 指令預設會使用該檔案。

3. 如要允許未經驗證的存取權，可以公開服務。

Terraform

如要瞭解如何套用或移除 Terraform 設定，請參閱「基本 Terraform 指令」。

  provider "google" {
    project = "PROJECT-ID"
  }

  resource "google_cloud_run_v2_service" "default" {
    name     = "SERVICE"
    location = "REGION"
    client   = "terraform"

    template {
      containers {
        image = "IMAGE_URL"
      }
    }
  }

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

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

撰寫

您可以將 Compose 規格儲存在 YAML 檔案中，然後使用單一 gcloud 指令，將其部署為 Cloud Run 服務。

如要將 compose.yaml 檔案部署為 Cloud Run 服務，請按照下列步驟操作：

1. 在專案目錄中，建立包含服務定義的 compose.yaml 檔案。

   services:
     web:
       image: IMAGE
       ports:
         - "8080:8080"

   將 IMAGE_URL 替換為容器映像檔的網址。

   您也可以指定更多設定選項，例如環境變數、密鑰和磁碟區掛接。

部署服務

1. 如要部署服務，請執行 gcloud run compose up 指令：

   gcloud run compose up compose.yaml

2. 回應y安裝必要元件或啟用 API 的任何提示。

3. 選用：公開發布服務，允許未經驗證的存取。

部署完成後，畫面會顯示 Cloud Run 服務網址。複製這個網址並貼到瀏覽器，即可查看正在執行的容器。您可以在 Google Cloud 控制台停用預設驗證。

MCP

您可以使用 AI 代理，透過官方 Cloud Run MCP 伺服器部署服務。

為獲得最佳結果，請先告知代理程式偏好使用 MCP 工具，而非 gcloud CLI，再開始使用這個 MCP 伺服器。

1. 如要設定 Cloud Run 遠端 MCP 伺服器，請按照「使用 Cloud Run 遠端 MCP 伺服器」指南中的操作說明進行。

2. 如要從範例 helloworld 容器映像檔部署服務，請使用下列提示指示代理程式： Deploy service "helloworld" to Cloud Run from the container image us-docker.pkg.dev/cloudrun/container/hello.

   代理程式會使用 deploy_service_from_image 工具，將容器映像檔部署為 Cloud Run 服務。

使用 /deploy 提示

您可以使用 /deploy 提示，透過 Cloud Run MCP 伺服器快速部署服務。你可能需要瀏覽聊天機器人選單，才能找到所需工具或提示。

如要將目前的工作目錄部署至 Cloud Run，請執行下列 /deploy 提示：

/deploy SERVICE_NAME \
    --project PROJECT_ID \
    --region REGION \

更改下列內容：

• SERVICE_NAME：Cloud Run 服務的名稱
• PROJECT_ID： Google Cloud 專案 ID
• REGION：區域名稱

用戶端程式庫

如要從程式碼部署新服務，請按照下列步驟操作：

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

REST API

如要部署新服務，請將 POST HTTP 要求傳送至 Cloud Run Admin API service 端點。

例如使用 curl：

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X POST \
  -d '{template: {containers: [{image: "IMAGE_URL"}]}}' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services?serviceId=SERVICE

更改下列內容：

• ACCESS_TOKEN：帳戶的有效存取權杖，該帳戶須具備部署服務的 IAM 權限。舉例來說，如果您已登入 gcloud，可以使用 gcloud auth print-access-token 擷取存取權杖。在 Cloud Run 容器執行個體中，您可以使用容器執行個體中繼資料伺服器擷取存取權杖。
• IMAGE_URL：容器映像檔的參照，例如 us-docker.pkg.dev/cloudrun/container/hello:latest。如果您使用 Artifact Registry，則必須先建立存放區 REPO_NAME。網址格式為 LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG 。
• SERVICE：要部署的服務名稱。 服務名稱不得超過 49 個字元，且每個區域和專案的服務名稱不得重複。
• REGION：服務的 Google Cloud 區域。
• PROJECT-ID： Google Cloud 專案 ID。