为工作器池配置标签

Cloud Run 标签是应用于 Cloud Run 工作器池的键值对。本页面介绍了如何在 Cloud Run 工作器池上设置、修改和删除标签。请注意，在 Cloud Run 工作器池上设置标签时，系统会为此工作器池创建一个具有此标签的新修订版本；该标签不会应用于先前的修订版本。

可能的用途包括：

  • 费用分配和账单明细。
  • 确定各个团队或费用中心使用的资源。
  • 区分部署环境（生产、预演、质量检查或测试）。
  • 识别所有者和状态标签。
  • 在 Logging 中过滤日志。

标签使用规则

以下规则适用于使用在 Cloud Run 工作器池上设置的标签：

只能在 Cloud Run 上使用有效 Google Cloud 标签。

所需的角色

如需获得配置和部署 Cloud Run 工作器池所需的权限，请让您的管理员为您授予以下 IAM 角色：

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

设置或修改标签

任何配置更改都会导致新修订版本的创建。后续修订版本也将自动采用此配置设置，除非您进行了明确更新。

您可以在创建新的工作器池或部署新修订版本时使用 Google Cloud CLI 设置或修改标签：

gcloud

您可以使用以下命令更新工作器池的标签：

gcloud beta run worker-pools update WORKER_POOL --update-labels KEY=VALUE

如需更新多个标签，请提供以英文逗号分隔的键值对列表。请注意，如果标签已存在，update-labels 命令会为标签键设置新值，否则它会创建新标签。

您需要进行如下替换：

  • 将 WORKER_POOL 替换为 Cloud Run 工作器池的名称
  • 将 KEY 替换为您的标签键的名称
  • 将 VALUE 替换为键的值

您还可以在部署期间设置标签：

gcloud beta run worker-pools deploy WORKER_POOL --image IMAGE --labels KEY=VALUE

如需在部署期间创建多个标签，请提供以英文逗号分隔的键值对列表。

按标签列出服务

您可以使用 Google Cloud CLI 过滤条件按标签列出服务：

  gcloud beta run worker-pools list --filter metadata.labels.LABEL=VALUE

您需要进行如下替换：

  • 将 LABEL 替换为标签的名称
  • 将 VALUE 替换为要包含在过滤列表中的值

删除工作器池上的标签

您可以使用 Google Cloud CLI 删除工作器池上的标签。

gcloud

如需从工作器池中清除所有标签，请执行以下操作：

gcloud beta run worker-pools update WORKER_POOL --clear-labels

如需从工作器池中删除特定标签，请提供以英文逗号分隔的键列表：

gcloud beta run worker-pools update WORKER_POOL --remove-labels LABEL

您需要进行如下替换：

  • 将 WORKER_POOL 替换为 Cloud Run 工作器池的名称
  • 将 LABEL 替换为您的标签名称