建立及管理 Cloud Run 執行個體

預覽 — Cloud Run 執行個體

這項功能適用《服務專屬條款》中「一般服務條款」一節的《正式發布前產品條款》。正式發布前功能是依「原樣」提供，支援服務可能受限。 詳情請參閱推出階段說明。

本頁說明如何建立及管理可個別定址的單例 Cloud Run 執行個體。與根據傳入流量調整資源配置的 Cloud Run 服務不同，執行個體是專用的運算容器，您可以使用生命週期轉換 (建立、停止、啟動、更新、刪除) 手動管理。

支援的地區

您可以在任何支援的區域中建立 Cloud Run 執行個體，但下列區域除外：

• europe-west1
• us-central1
• us-east1

事前準備

1. 按照設定頁面的說明，為 Cloud Run 設定新專案。

2. 啟用 Cloud Run Admin API：

   gcloud services enable run.googleapis.com
   

3. 將 gcloud 元件更新到最新版本：

   gcloud components update

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

必要的角色

如要取得設定及部署 Cloud Run 執行個體所需的權限，請要求管理員授予您下列 IAM 角色：

• Cloud Run 執行個體上的 Cloud Run 開發人員 (roles/run.developer)
• 服務身分上的服務帳戶使用者 (roles/iam.serviceAccountUser)

如需與 Cloud Run 相關聯的 IAM 角色和權限清單，請參閱「Cloud Run IAM 角色」和「Cloud Run IAM 權限」。如果 Cloud Run 執行個體與Google Cloud API (例如 Cloud 用戶端程式庫) 介接，請參閱服務身分設定指南。 如要進一步瞭解如何授予角色，請參閱「部署權限」和「管理存取權」。

建立執行個體

您可以部署容器映像檔來建立新執行個體。如果您未提供名稱，系統會自動產生名稱。

gcloud

如要使用 gcloud beta run instances create 指令建立新的 Cloud Run 執行個體，請按照下列步驟操作：

gcloud beta run instances create INSTANCE_NAME \
    --image IMAGE_URL \
    --region REGION

如要使用 gcloud beta run instances deploy 指令建立新的 Cloud Run 執行個體，請按照下列步驟操作：

gcloud beta run instances deploy INSTANCE_NAME \
    --image IMAGE_URL \
    --region REGION

更改下列內容：

• INSTANCE_NAME：要建立的執行個體名稱。專案和區域中的執行個體名稱不得重複。您無法建立與現有 Cloud Run 執行個體或服務同名的執行個體。
• IMAGE_URL：容器映像檔的參照，例如 us-docker.pkg.dev/cloudrun/container/instances:latest。
• REGION：執行執行個體的 Google Cloud 區域，例如 europe-west1。

用戶端程式庫

如要從程式碼建立新執行個體，請按照下列步驟操作：

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

REST API

如要建立新的 Cloud Run 執行個體，請將 POST HTTP 要求傳送至 instances 端點。

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "containers": [{
      "image": "IMAGE_URL",
      "ports": [{"containerPort": PORT}]
    }],
    "ingress": "INGRESS_TRAFFIC_ALL",
    "invokerIamDisabled": true,
    "timeout": "3600s"
  }' \
  "https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances?instance_id=INSTANCE_NAME"

更改下列內容：

• IMAGE_URL：容器映像檔網址。
• PORT：容器監聽的通訊埠。
• PROJECT_ID：您的 Google Cloud 專案 ID。
• REGION：部署作業的 Google Cloud 區域。
• INSTANCE_NAME：新執行個體的名稱。

建立執行個體後，該執行個體會收到 Cloud Run URL，格式如下：

https://INSTANCE_NAME-PROJECT_NUMBER.REGION.run.app

更新執行個體

更新執行個體時 (例如容器映像檔、通訊埠或環境變數)，執行個體會重新啟動。

注意： Cloud Run 執行個體沒有永久磁碟儲存空間。如要保留檔案和資料，請先儲存至外部儲存空間，再更新裝置。

gcloud

如要使用 gcloud beta run instances update 指令更新 Cloud Run 執行個體，請執行下列操作：

gcloud beta run instances update INSTANCE_NAME \
    --image NEW_IMAGE_URL \
    --region REGION

如要使用 gcloud beta run instances deploy 指令更新 Cloud Run 執行個體，請執行下列操作：

gcloud beta run instances deploy INSTANCE_NAME \
    --image IMAGE_URL \
    --region REGION

REST API

如要透過 API 更新 Cloud Run 執行個體設定，請將 PATCH HTTP 要求傳送至執行個體 URI 端點。

curl -H "Content-Type: application/json" \
  -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -d '{template: {containers: [{image: "IMAGE_URL"}]}}' \
  "https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/INSTANCE_NAME"

停止執行個體

使用停止指令或方法，停止執行中的 Cloud Run 執行個體。

注意： 停止執行個體會終止作用中的容器執行階段，並刪除所有記憶體內檔案和未保存的系統狀態。如要保留檔案和資料，請先儲存至外接儲存裝置，再停止備份。

gcloud

停止執行個體：

gcloud beta run instances stop INSTANCE_NAME \
    --region REGION

用戶端程式庫

如要透過程式碼停止執行中的執行個體：

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

REST API

如要停止執行個體，請使用 :stop 裝飾器傳送 POST HTTP 要求：

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/INSTANCE_NAME:stop"

啟動或重新啟動執行個體

使用 start 指令或方法啟動已停止的執行個體，或強制重新啟動現有執行個體。

gcloud

如要啟動或重新啟動執行個體，請按照下列指示操作：

gcloud beta run instances start INSTANCE_NAME \
    --region REGION

用戶端程式庫

如要透過程式碼啟動已停止的執行個體，請按照下列步驟操作：

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

REST API

如要啟動執行個體，請使用 :start 裝飾器傳送 POST HTTP 要求：

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/INSTANCE_NAME:start"

查看專案中的執行個體清單

您可以查看專案中所有啟用和停用的執行個體。

gcloud

如要列出特定區域中的執行個體：

gcloud beta run instances list \
    --region REGION

將 REGION 替換為執行個體執行的 Google Cloud 區域。

用戶端程式庫

如要透過程式碼列出有效和無效的執行個體，請執行下列操作：

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

REST API

如要擷取執行個體清單，請傳送 GET HTTP 要求：

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances"

查看執行個體詳細資料

使用 describe 指令或方法，查看設定詳細資料和目前狀態。

gcloud

如要說明執行個體，請執行下列操作：

gcloud beta run instances describe INSTANCE_NAME \
    --region REGION

用戶端程式庫

如要透過程式碼查看執行個體設定詳細資料和狀態，請按照下列步驟操作：

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

REST API

如要說明執行個體，請傳送 GET HTTP 要求：

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/INSTANCE_NAME"

刪除執行個體

刪除執行個體會從專案中永久移除其設定、中繼資料、公開直接網址對應和身分角色。

注意： 執行個體刪除後會永久移除，無法啟動或復原。

gcloud

如要刪除執行個體：

gcloud beta run instances delete INSTANCE_NAME \
    --region REGION

用戶端程式庫

如要從程式碼刪除執行個體，請按照下列步驟操作：

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

REST API

如要刪除執行個體，請傳送 DELETE HTTP 要求：

curl -X DELETE \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/INSTANCE_NAME"

後續步驟

• 如要查看執行個體的記錄交易，請參閱「在 Cloud Run 中記錄及查看記錄」。
• 設定 Cloud Run 執行個體：
  • 記憶體上限
  • CPU 上限
  • 容器通訊埠和進入點
  • 環境變數
  • 磁碟區掛接
  • 容器健康狀態檢查
  • 密鑰
  • 服務 ID
  • 預設網址
  • 重新啟動政策
  • IAP