Las etiquetas de Cloud Run son pares clave-valor que se aplican a los grupos de trabajadores de Cloud Run. En esta página, se muestra cómo configurar, modificar y borrar etiquetas en tus grupos de trabajadores de Cloud Run. Ten en cuenta que cuando configuras una etiqueta en un grupo de trabajadores de Cloud Run, se crea una revisión nueva con esta etiqueta para este grupo de trabajadores. La etiqueta no se aplica a revisiones anteriores.
Entre los usos posibles, se incluyen los siguientes:
- Asignar costos y desglosar la facturación
- Identifica los recursos que usan los equipos individuales o los centros de costos.
- Distingue los entornos de implementación (producción, etapa de pruebas, control de calidad o prueba).
- Identificar propietarios y etiquetas de estado
- Filtra registros en Logging.
Reglas de uso de etiquetas
La siguiente regla se aplica al uso de etiquetas configuradas en un grupo de trabajadores de Cloud Run:
Solo se pueden usar etiquetas Google Cloud válidas en Cloud Run.
Roles obligatorios
Para obtener los permisos que necesitas para configurar y, luego, implementar grupos de trabajadores de Cloud Run, pídele a tu administrador que te otorgue los siguientes roles de IAM:
-
Desarrollador de Cloud Run (
roles/run.developer
) en el grupo de trabajadores de Cloud Run -
Usuario de la cuenta de servicio (
roles/iam.serviceAccountUser
) en la identidad del servicio
Para obtener una lista de los roles y los permisos de IAM asociados con Cloud Run, consulta los roles de IAM de Cloud Run y los permisos de IAM de Cloud Run. Si tu grupo de trabajadores de Cloud Run interactúa con las APIs deGoogle Cloud , como las bibliotecas cliente de Cloud, consulta la guía de configuración de identidades del servicio. Para obtener más información sobre cómo otorgar roles, consulta permisos de implementación y administra el acceso.
Configura o modifica etiquetas
Cualquier cambio en la configuración conlleva la creación de una revisión nueva. Las revisiones posteriores también adoptarán esta configuración de manera automática, a menos que realices actualizaciones explícitas para cambiarla.
Puedes configurar o modificar las etiquetas con Google Cloud CLI cuando creas un grupo de trabajadores nuevo o implementas una revisión nueva:
gcloud
Puedes actualizar las etiquetas de un grupo de trabajadores con el siguiente comando:
gcloud beta run worker-pools update WORKER_POOL --update-labels KEY=VALUE
Para actualizar más de una etiqueta, proporciona una lista delimitada por comas de pares clave-valor. Ten en cuenta que el comando update-labels
establece un valor nuevo para la clave de etiqueta si la etiqueta ya existe; de lo contrario, crea una etiqueta nueva.
Reemplaza lo siguiente:
- WORKER_POOL por el nombre de tu grupo de trabajadores de Cloud Run
- KEY por el nombre de la clave de etiqueta
- VALUE por el valor de la clave.
También puedes establecer etiquetas durante la implementación:
gcloud beta run worker-pools deploy WORKER_POOL --image IMAGE --labels KEY=VALUE
Para crear más de una etiqueta durante la implementación, proporciona una lista delimitada por comas de pares clave-valor.
Muestra una lista de servicios por etiqueta
Puedes enumerar servicios por etiqueta mediante un filtro de Google Cloud CLI:
gcloud beta run worker-pools list --filter metadata.labels.LABEL=VALUE
Reemplaza lo siguiente:
- LABEL por el nombre de la etiqueta
- VALUE por el valor que se incluirá en tu lista filtrada
Borra una etiqueta de un grupo de trabajadores
Puedes usar Google Cloud CLI para borrar etiquetas en un grupo de trabajadores.
gcloud
Para borrar todas las etiquetas de un grupo de trabajadores, haz lo siguiente:
gcloud beta run worker-pools update WORKER_POOL --clear-labels
Para borrar etiquetas específicas de un grupo de trabajadores, proporciona una lista de claves delimitadas por comas:
gcloud beta run worker-pools update WORKER_POOL --remove-labels LABEL
Reemplaza lo siguiente:
- WORKER_POOL por el nombre de tu grupo de trabajadores de Cloud Run
- LABEL por el nombre de tu etiqueta