Configura etiquetas para las instancias

Las etiquetas de Cloud Run son pares clave-valor que se aplican a las instancias de Cloud Run. En esta página, se muestra cómo configurar, modificar y borrar etiquetas en tus instancias de Cloud Run. Ten en cuenta que cuando configuras una etiqueta en una instancia de Cloud Run, se crea una revisión nueva con esta etiqueta para esta instancia. La etiqueta no se aplica a revisiones anteriores.

Entre los usos posibles, se incluyen los siguientes:

  • Asignación de costos y desgloses de 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).
  • Identifica 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 una instancia de Cloud Run:

Solo se pueden usar etiquetasválidas Google Cloud en Cloud Run.

Etiquetas para datos de facturación y Logging

Facturación de Cloud y Cloud Logging solo reciben etiquetas que se especifican en el atributo spec.template.metadata.labels en YAML o en template en Terraform. Si configuras etiquetas con el Google Cloud CLI, Cloud Run agrega las etiquetas a los atributos metadata.labels y spec.template.metadata.labels.

Roles obligatorios

Para obtener los permisos que necesitas para configurar y, luego, implementar las instancias de Cloud Run, pídele a tu administrador que te otorgue los siguientes roles de IAM:

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 instancia de Cloud Run interactúa con Google Cloud las APIs, 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

Puedes configurar o modificar etiquetas con Google Cloud CLI:

gcloud

Puedes actualizar las etiquetas de una instancia con el siguiente comando:

gcloud beta run instances update INSTANCE --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:

  • INSTANCE: El nombre de tu instancia de Cloud Run.
  • KEY: El nombre de tu clave de etiqueta.
  • VALUE: El valor de la clave.

También puedes establecer etiquetas durante la implementación:

gcloud beta run instances deploy INSTANCE --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.

YAML

  1. Si creas una instancia nueva, omite este paso. Si actualizas una instancia existente, descarga su configuración de YAML:

    gcloud beta run instances describe INSTANCE --format export > instance.yaml

  2. En el siguiente ejemplo, se incluye la configuración de YAML:

    apiVersion: run.googleapis.com/v1
kind: Instance
metadata:
  name: INSTANCE
  annotations:
    run.googleapis.com/launch-stage: BETA
  labels:
    KEY: VALUE
    KEY2: VALUE2
    KEY3: VALUE3

    Reemplaza lo siguiente:

    • INSTANCE: El nombre de tu instancia de Cloud Run.
    • KEY y VALUE: Los pares clave-valor para las etiquetas.

    metadata.labels establece etiquetas en el objeto de instancia, mientras que spec.template.metadata.labels establece etiquetas en la revisión creada. Cloud Run solo propaga las etiquetas establecidas en la revisión a Facturación de Cloud y Cloud Logging.

  3. Crea o actualiza la instancia con el siguiente comando:

    gcloud beta run instances replace instance.yaml

Enumera instancias por etiqueta

Puedes enumerar instancias por etiqueta mediante un filtro de Google Cloud CLI:

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

Reemplaza lo siguiente:

  • LABEL: El nombre de la etiqueta.
  • VALUE: El valor que se incluirá en tu lista filtrada.

Borra una etiqueta de una instancia

Puedes usar Google Cloud CLI para borrar etiquetas en una instancia.

gcloud

Para borrar todas las etiquetas de una instancia, ejecuta lo siguiente:

gcloud beta run instances update INSTANCE --clear-labels

Para borrar etiquetas específicas de una instancia, proporciona una lista de claves delimitadas por comas:

gcloud beta run instances update INSTANCE --remove-labels LABEL

Reemplaza lo siguiente:

  • INSTANCE: El nombre de tu instancia de Cloud Run.
  • LABEL: El nombre de tu etiqueta.