Configurar etiquetas para servicios

Las etiquetas de Cloud Run son pares clave-valor que se aplican a los servicios y las revisiones de Cloud Run. En esta página se muestra cómo definir, modificar y eliminar etiquetas en tu servicio y tus revisiones de Cloud Run. Ten en cuenta que, cuando asignas una etiqueta a un servicio de Cloud Run, se crea una nueva revisión con esa etiqueta para el servicio. La etiqueta no se aplica a las revisiones anteriores.

Entre los posibles usos, se incluyen los siguientes:

  • Desglose de la facturación y la asignación de costes.
  • Identifica los recursos que utilizan los distintos equipos o centros de costes.
  • Distinguir los entornos de implementación (producción, desarrollo, control de calidad o prueba).
  • Identifica a los propietarios y las etiquetas de estado.
  • Filtrar registros en Logging.

Reglas de uso de las etiquetas

Se aplica la siguiente regla al uso de etiquetas definidas en un servicio de Cloud Run:

En Cloud Run solo se pueden usar etiquetas Google Cloud válidas.

Roles obligatorios

Para obtener los permisos que necesitas para configurar e implementar servicios de Cloud Run, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos:

Si vas a desplegar un servicio o una función a partir de código fuente, también debes tener otros roles concedidos en tu proyecto y en la cuenta de servicio de Cloud Build.

Para ver una lista de los roles y permisos de gestión de identidades y accesos asociados a Cloud Run, consulta los artículos Roles de gestión de identidades y accesos de Cloud Run y Permisos de gestión de identidades y accesos de Cloud Run. Si tu servicio de Cloud Run interactúa con APIs, como las bibliotecas de cliente de Cloud, consulta la guía de configuración de la identidad del servicio.Google Cloud Para obtener más información sobre cómo conceder roles, consulta los permisos de implementación y el artículo sobre cómo gestionar el acceso.

Definir o modificar etiquetas

Cualquier cambio en la configuración conlleva la creación de una nueva revisión. Las revisiones posteriores también recibirán automáticamente este ajuste de configuración, a menos que hagas cambios explícitos para modificarlo.

Las etiquetas que hayas definido anteriormente para tus funciones de Cloud Run mediante comandos gcloud functions o la API Cloud Functions v2 se propagan a Cloud Run cuando despliegas tus funciones en Cloud Run.

Puedes definir o modificar etiquetas con la Google Cloud consola, la CLI de Google Cloud o un archivo YAML cuando despliegues una revisión nueva.

Consola

  1. En la Google Cloud consola, ve a la página Servicios de Cloud Run:

    Ir a Cloud Run

  2. Marca la casilla situada a la izquierda del servicio al que quieras asignar la etiqueta.

  3. Asegúrate de que el panel de información de la parte derecha esté activado (Mostrar panel de información).

  4. Haz clic en Etiquetas para mostrar el panel de etiquetas.

    Definir etiqueta

  5. Para editar el valor de una clave de etiqueta, busque la etiqueta y cambie el Valor.

  6. Para definir una nueva etiqueta en el servicio, haga clic en Añadir etiqueta e indique la clave y el valor.

  7. Haz clic en Guardar.

gcloud

Puedes actualizar las etiquetas de un servicio con el siguiente comando:

gcloud run services update SERVICE --update-labels KEY=VALUE

Para actualizar más de una etiqueta, proporcione una lista de pares clave-valor delimitada por comas. Ten en cuenta que el comando update-labels asigna un nuevo valor a la clave de la etiqueta si esta ya existe. De lo contrario, crea una nueva etiqueta.

Haz los cambios siguientes:

  • SERVICE: el nombre de tu servicio de Cloud Run
  • KEY: el nombre de la clave de la etiqueta.
  • VALUE: el valor de la clave

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

gcloud run deploy SERVICE --image IMAGE --labels KEY=VALUE

Para crear más de una etiqueta durante la implementación, proporciona una lista de pares clave-valor delimitada por comas.

YAML

  1. Si va a crear un servicio, puede saltarse este paso. Si va a actualizar un servicio, descargue su configuración YAML:

    gcloud run services describe SERVICE --format export > service.yaml

  2. Actualiza los atributos labels en dos lugares:

    apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: SERVICE
  labels:
    LABEL: VALUE
spec:
  template:
    metadata:
      labels:
        LABEL: VALUE
      name: REVISION

    Haz los cambios siguientes:

    • SERVICE: el nombre de tu servicio de Cloud Run
    • LABEL: el nombre de la etiqueta
    • VALUE: el valor necesario
    • REVISION con un nuevo nombre de revisión o elimínelo (si está presente). Si proporcionas un nuevo nombre de revisión, debe cumplir los siguientes criterios:
      • Empieza por SERVICE-
      • Contiene solo letras minúsculas, números y -
      • No termina con -
      • No supera los 63 caracteres

    metadata.labels define etiquetas en el objeto de servicio, mientras que spec.template.metadata.label define etiquetas en la revisión creada. Solo se transfieren a los registros y a la facturación las etiquetas definidas en la revisión.

  3. Crea o actualiza el servicio con el siguiente comando:

    gcloud run services replace service.yaml

Terraform

Para saber cómo aplicar o quitar una configuración de Terraform, consulta Comandos básicos de Terraform.

Añade lo siguiente a un recurso google_cloud_run_v2_service en tu configuración de Terraform:

resource "google_cloud_run_v2_service" "default" {
  name     = "cloudrun-service-labels"
  location = "us-central1"

  deletion_protection = false # set to "true" in production

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"
    }
    # Labels
    labels = {
      foo : "bar"
      baz : "quux"
    }
  }
}

El extracto anterior añade dos etiquetas, foo (cuyo valor es bar) y baz (cuyo valor es quux), a tu instancia de Cloud Run.

Si añade las etiquetas en template, se definen las etiquetas de la revisión: solo se transfieren a los registros y a la facturación las etiquetas definidas para la revisión. Si añades las etiquetas a una ubicación que no sea template, la etiqueta se asignará al servicio, no a la revisión.

Haz los cambios siguientes:

  • name: el nombre de tu servicio.
  • location: la ubicación que se usa para tu servicio.
  • image: la imagen de tu contenedor.
  • foo y baz: los nombres de tus etiquetas.
  • bar y quux: los valores de las etiquetas que haya definido.

Mostrar servicios por etiqueta

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

  gcloud run services list --filter metadata.labels.LABEL=VALUE

Haz los cambios siguientes:

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

Eliminar una etiqueta de un servicio

Puedes usar la consola o la línea de comandos para eliminar etiquetas de un servicio.

Consola

  1. En la Google Cloud consola, ve a la página Servicios de Cloud Run:

    Ir a Cloud Run

  2. Marca la casilla situada a la izquierda del servicio del que quieres eliminar la etiqueta.

  3. Asegúrate de que el panel de información de la parte derecha esté activado (Mostrar panel de información).

  4. Haz clic en Etiquetas para mostrar el panel de etiquetas.

  5. Busca la etiqueta que quieras eliminar.

  6. Coloca el cursor a la derecha del cuadro de texto Valor de la etiqueta para que se muestre el icono de la papelera y haz clic en él.

  7. Haz clic en Guardar.

gcloud

Para borrar todas las etiquetas de un servicio, sigue estos pasos:

gcloud run services update SERVICE --clear-labels

Para eliminar etiquetas específicas de un servicio, proporciona una lista de claves separadas por comas:

gcloud run services update SERVICE --remove-labels LABEL

Haz los cambios siguientes:

  • SERVICE: el nombre de tu servicio de Cloud Run
  • LABEL: el nombre de tu discográfica