管理工作站集區

您可以在 Cloud Run 中查看詳細資料、停用現有 worker 集區，或刪除不需要的集區。您可以檢查已部署的設定、停止執行中的執行個體，以及移除未使用的資源。

必要的角色

如要取得管理 Cloud Run worker 集區和 worker 集區修訂版本所需的權限，請要求管理員授予您 Cloud Run worker 集區的「Cloud Run 開發人員」 (roles/run.developer) IAM 角色。

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

建立工作站集區

Cloud Run 會在您首次部署容器映像檔時，建立新的 worker 集區。如需更多操作說明，請參閱「部署新的 worker 集區」。

查看專案中的 worker 集區清單

使用 Google Cloud 控制台或 Google Cloud CLI，查看專案中可用的 worker 集區清單：

主控台

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

   前往 Cloud Run。

2. 從選單中選取「工作站集區」。頁面會列出可用的 worker 集區。

gcloud

如要列出專案中的 worker 集區，請執行下列指令：

gcloud run worker-pools list

您可以依工作站集區定義的屬性 (例如指派的標籤) 篩選這份清單。

用戶端程式庫

如要透過程式碼查看 worker 集區清單，請按照下列步驟操作：

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

REST API

如要查看專案中的 worker 集區清單，請向 Cloud Run Admin API workerPool 端點傳送 GET HTTP 要求。

例如，使用 curl：

curl -H "Authorization: Bearer ACCESS_TOKEN" \
   -X GET \
   https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools

更改下列內容：

• ACCESS_TOKEN：帳戶的有效存取權杖，該帳戶必須具備查看 worker 集區的 IAM 權限。舉例來說，如果您已登入 gcloud，可以使用 gcloud auth print-access-token 擷取存取權杖。在 Cloud Run 容器執行個體中，您可以使用容器執行個體中繼資料伺服器擷取存取權杖。
• PROJECT_ID： Google Cloud 專案 ID。
• REGION：worker 集區的 Google Cloud 區域。

查看 worker 集區的詳細資料

使用 Google Cloud 控制台、Google Cloud CLI 或 YAML，查看有關 worker 集區的更多詳細資料：

主控台

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

   前往 Cloud Run。

2. 從選單中選取「工作站集區」，即可顯示可用的工作站集區。

3. 按一下工作站集區，即可顯示詳細資料窗格。

gcloud

如要查看 worker 集區的詳細資料，請按照下列步驟操作：

gcloud run worker-pools describe WORKER_POOL

將 WORKER_POOL 替換為 worker 集區的名稱。

您可以使用 --format 旗標設定輸出內容的格式。舉例來說，如要將輸出內容格式設為 YAML，請執行下列指令：

gcloud run worker-pools describe WORKER_POOL
    --region REGION
    --format yaml

更改項目：

• 將 WORKER_POOL 替換為 worker 集區名稱。
• 將 REGION 替換為 worker 集區的 Google Cloud 區域。

YAML

如要查看 worker 集區的詳細資料，請下載其 YAML 設定：

gcloud run worker-pools describe WORKER_POOL --format export > worker-pool.yaml

用戶端程式庫

如要透過程式碼查看 worker 集區的詳細資料，請按照下列步驟操作：

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

REST API

如要查看工作人員集區的詳細資料，請將 GET HTTP 要求傳送至 Cloud Run Admin API workerPool 端點。

例如，使用 curl：

curl -H "Authorization: Bearer ACCESS_TOKEN" \
   -X GET \
   https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools/WORKER_POOL

更改下列內容：

• ACCESS_TOKEN：帳戶的有效存取權杖，該帳戶具有查看工作人員集區詳細資料的 IAM 權限。舉例來說，如果您已登入 gcloud，可以使用 gcloud auth print-access-token 擷取存取權杖。在 Cloud Run 容器執行個體中，您可以使用容器執行個體中繼資料伺服器擷取存取權杖。
• PROJECT_ID： Google Cloud 專案 ID。
• REGION：worker 集區的 Google Cloud 區域。
• WORKER_POOL：worker 集區的名稱。

停用現有的 worker 集區

停用 worker 集區會關閉該集區的所有執行個體。如要停用 worker 集區，請將資源調度設為零：

主控台

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

   前往 Cloud Run。

2. 從選單中選取「Worker pools」(工作站集區)，然後從工作站集區清單中，按一下要停用的工作站集區。

3. 按一下「Scaling: Manual (Instances: )」(資源調度：手動 (執行個體：)) 右側的筆形圖示，然後將值變更為 0。

4. 按一下「Save」(儲存)，即可更新並停用 worker 集區。

gcloud

gcloud run worker-pools update WORKER_POOL --instances=0

將 WORKER_POOL 替換為工作站集區的名稱。

YAML

1. 如要建立新的工作站集區，請跳過這個步驟。 如要更新現有 worker 集區，請下載其 YAML 設定：

   gcloud run worker-pools describe WORKER_POOL --format export > worker-pool.yaml

2. 將 scale 設為 0，即可停用工作站集區。 以下範例包含 YAML 設定：

   apiVersion: run.googleapis.com/v1
   kind: WorkerPool
   metadata:
     name: WORKER_POOL
     annotations:
       run.googleapis.com/scalingMode: manual
       run.googleapis.com/manualInstanceCount: `0`

   更改下列內容：

   • WORKER_POOL：Cloud Run worker 集區的名稱。

3. 使用下列指令建立或更新 worker 集區：

   gcloud run worker-pools replace worker-pool.yaml

   gcloud run worker-pools replace 指令預設會使用 worker-pool.yaml 檔案 (如有)。

用戶端程式庫

如要透過程式碼停用 worker 集區，請按照下列步驟操作：

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

REST API

如要停用 worker 集區，請向 Cloud Run Admin API workerPool 端點傳送 PATCH HTTP 要求。

例如，使用 curl：

curl -H "Authorization: Bearer ACCESS_TOKEN" \
   -H "Content-Type: application/json" \
   -X PATCH \
   -d '{"scaling":{"manualInstanceCount":0}}' \
   https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools/WORKER_POOL?update_mask=scaling.manualInstanceCount

更改下列內容：

• ACCESS_TOKEN：帳戶的有效存取權杖，該帳戶必須具備停用 worker 集區的 IAM 權限。舉例來說，如果您已登入 gcloud，可以使用 gcloud auth print-access-token 擷取存取權杖。在 Cloud Run 容器執行個體中，您可以使用容器執行個體中繼資料伺服器擷取存取權杖。
• PROJECT_ID： Google Cloud 專案 ID。
• REGION：worker 集區的 Google Cloud 區域。
• WORKER_POOL：worker 集區的名稱。

刪除現有工作站集區

刪除 worker 集區時，請注意下列事項：

• 刪除 worker 集區會一併刪除與該集區相關的所有資源，包括該集區的所有修訂版本，無論是否正在處理工作負載。
• 刪除工作人員集區不會自動從 Artifact Registry 移除容器映像檔。 如要從 Artifact Registry 刪除已刪除修訂版本使用的容器映像檔，請參閱「刪除映像檔」。
• 刪除 worker 集區後，在完全刪除前，Google Cloud CLI 仍會顯示該集區。但無法更新 worker 集區。

• 刪除工作站集區後即無法復原，無法復原或還原。

主控台

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

   前往 Cloud Run。

2. 從選單中選取「工作站集區」，然後從工作站集區清單中，選取要刪除的工作站集區。

3. 點選「刪除」。

gcloud

如要刪除 worker 集區，請使用下列指令：

gcloud run worker-pools delete WORKER_POOL --region REGION

更改項目：

• 將 WORKER_POOL 替換為工作站集區的名稱。
• 將 REGION 替換為 worker 集區的 Google Cloud 區域。

用戶端程式庫

如要透過程式碼刪除 worker 集區，請按照下列步驟操作：

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

REST API

如要刪除 worker 集區，請向 Cloud Run Admin API workerPool 端點傳送 DELETE HTTP 要求。

例如，使用 curl：

curl -H "Authorization: Bearer ACCESS_TOKEN" \
   -X DELETE \
   https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools/WORKER_POOL

更改下列內容：

• ACCESS_TOKEN：帳戶的有效存取權杖，該帳戶必須具備刪除 worker 集區的 IAM 權限。舉例來說，如果您已登入 gcloud，可以使用 gcloud auth print-access-token 擷取存取權杖。在 Cloud Run 容器執行個體中，您可以使用容器執行個體中繼資料伺服器擷取存取權杖。
• PROJECT_ID： Google Cloud 專案 ID。
• REGION：worker 集區的 Google Cloud 區域。
• WORKER_POOL：worker 集區的名稱。