管理工作器池

本页面介绍了如何查看工作器池信息以及如何删除工作器池。

所需的角色

如需获得管理 Cloud Run 工作器池和工作器池修订版本所需的权限，请让管理员向您授予 Cloud Run 工作器池的 Cloud Run Developer (roles/run.developer) IAM 角色。

如需查看与 Cloud Run 关联的 IAM 角色和权限的列表，请参阅 Cloud Run IAM 角色和 Cloud Run IAM 权限。如果您的 Cloud Run 工作器池与Google Cloud API（例如 Cloud 客户端库）进行交互，请参阅服务身份配置指南。如需详细了解如何授予角色，请参阅部署权限和管理访问权限。

创建工作器池

首次部署容器映像时，Cloud Run 会创建一个新的工作器池。如需了解更多说明，请参阅部署新的工作器池。

查看项目中的工作器池列表

使用 Google Cloud 控制台或 Google Cloud CLI 查看项目中的可用工作器池列表：

控制台

  1. 在 Google Cloud 控制台中，前往 Cloud Run：

    转到 Cloud Run

  2. 从菜单中选择工作器池。页面中列出了可用的工作器池。

gcloud

如需列出项目中的工作器池，请执行以下操作：

gcloud beta run worker-pools list

您可以按工作器池定义的属性（例如已分配的标签）过滤此列表。

查看工作器池的更多详细信息

您可以使用 Google Cloud 控制台、Google Cloud CLI 或 YAML 查看有关工作器池的更多详细信息：

控制台

  1. 在 Google Cloud 控制台中，前往 Cloud Run：

    转到 Cloud Run

  2. 从菜单中选择工作器池以显示可用的工作器池。

  3. 点击相应工作器池以显示其详细信息窗格。

gcloud

如需查看工作器池的详细信息，请执行以下操作：

gcloud beta run worker-pools describe WORKER_POOL
 将 WORKER_POOL 替换为工作器池的名称。

您可以使用 --format 标志来设置输出的格式。例如，如需将输出格式设置为 YAML，请执行以下操作：

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

您需要进行如下替换：

  • 将 WORKER_POOL 替换为工作器池的名称。
  • 将 REGION 替换为工作器池所在的 Google Cloud 区域。

YAML

如需查看工作器池的详细信息，请下载其 YAML 配置：

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

停用现有工作器池

停用工作器池会关停该工作器池的所有实例。如需停用工作器池，请将扩缩设置为零：

控制台

  1. 在 Google Cloud 控制台中，前往 Cloud Run：

    转到 Cloud Run

  2. 从菜单中选择工作器池，然后从工作器池列表中点击要停用的工作器池。

  3. 点击扩缩：手动（实例数：）右侧的笔图标，然后将值更改为 0。

  4. 点击保存以更新并停用工作器池。

gcloud

gcloud beta run worker-pools update WORKER_POOL --scaling=0

将 WORKER_POOL 替换为工作器池的名称。

YAML

  1. 如果您要创建新的工作器池，请跳过此步骤。 如果您要更新现有工作器池，请下载其 YAML 配置：

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

  2. 将 scale 设置为值 0 可停用工作器池。 以下示例包含 YAML 配置：

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

    替换以下内容：

    • WORKER_POOL：Cloud Run 工作器池的名称。

  3. 使用以下命令创建或更新工作器池：

    gcloud beta run worker-pools replace workerpool.yaml

删除现有工作器池

删除工作器池时需要注意以下事项：

  • 删除工作器池会删除与其相关的所有资源，包括该工作器池的所有修订版本，无论其是否正在处理工作负载。
  • 删除工作器池不会自动移除 Artifact Registry 中的容器映像，需手动操作。要从 Artifact Registry 中删除已删除的修订版本所使用的容器映像，请参阅删除映像。
  • 删除工作器池后，该工作器池在 Google Cloud CLI 中仍然可见，直到删除完全完成。但您将无法对工作器池进行更新。

  • 删除工作器池是一项永久性操作。无法撤消或恢复。

控制台

  1. 在 Google Cloud 控制台中，前往 Cloud Run：

    转到 Cloud Run

  2. 从菜单中选择工作器池，然后从工作器池列表中选择要删除的工作器池。

  3. 点击删除。

gcloud

如需删除工作器池，请使用以下命令：

gcloud beta run worker-pools delete WORKER_POOL --region REGION

您需要进行如下替换：

  • 将 WORKER_POOL 替换为工作器池的名称。
  • 将 REGION 替换为工作器池所在的 Google Cloud 区域。