Usa etiquetas

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

En esta página, se muestra cómo configurar, modificar y borrar etiquetas en el servicio, las revisiones y los trabajos de Cloud Run. En Cloud Run, las etiquetas son pares clave-valor que se aplican al servicio, la revisión o el trabajo. Ten en cuenta que cuando configuras una etiqueta en un servicio de Cloud Run, se crea una revisión del servicio nueva o con esta etiqueta para este servicio. La etiqueta no se aplica a revisiones anteriores.

Entre los usos posibles, se incluyen los siguientes:

  • Asignar costos y desglosar la facturación
  • Identificar los recursos que usan los equipos individuales o los centros de costos
  • Distinguir los entornos de implementación (producción, etapa de pruebas, control de calidad o prueba)
  • Identificar propietarios y etiquetas de estado
  • Filtrar registros en Logging

Reglas de uso de etiquetas

La siguiente regla se aplica al uso de etiquetas configuradas en un servicio o trabajo de Cloud Run:

Solo se pueden usar etiquetas de Google Cloud válidas en Cloud Run.

Configura o modifica etiquetas

Puedes establecer etiquetas en los servicios y trabajos de Cloud Run.

Para servicios de Cloud Run

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 etiquetas mediante la consola de Google Cloud, la línea de comandos de gcloud o un archivo YAML cuando implementas una revisión nueva.

Console

  1. Ir a Cloud Run

  2. Marca la casilla de verificación a la izquierda del servicio en el que configurarás la etiqueta.

  3. Asegúrate de que el Panel de información en el extremo derecho esté activado (Mostrar panel de información).

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

    Establece etiquetas

  5. Para editar un valor de una clave de etiqueta existente, ubica la etiqueta y cambia el Value (Valor) como desees.

  6. Para establecer una etiqueta nueva en el servicio, haz clic en Agregar etiqueta y proporciona la clave y el valor.

  7. Haz clic en Guardar.

Línea de comandos

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

gcloud run services update SERVICE --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 los siguientes elementos:

  • SERVICE por el nombre del servicio 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 run deploy SERVICE --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

Puedes descargar y ver la configuración del servicio existente mediante el comando gcloud run services describe --format export, que genera resultados limpios en formato YAML. Luego, puedes modificar los campos que se describen a continuación y subir el YAML modificado mediante el comando gcloud run services replace. Asegúrate de modificar los campos tal como se indica en la documentación.

  1. Para ver y descargar la configuración:

    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

    Reemplazar

    • SERVICE por el nombre del servicio de Cloud Run
    • LABEL por el nombre de la etiqueta
    • VALUE por el valor deseado
    • REVISION por un nombre de revisión nuevo o bórralo (si está presente). Si proporcionas un nuevo nombre de revisión, debe cumplir con los siguientes criterios:
      • Comienza con SERVICE-
      • Solo contiene letras minúsculas, números y -
      • No termina con -
      • No supera los 63 caracteres

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

  3. Reemplaza el servicio por la configuración nueva mediante el siguiente comando:

    gcloud run services replace service.yaml

Terraform

Agrega lo siguiente a un recurso google_cloud_run_service en la configuración de Terraform, en el atributo template. Esto aplica dos etiquetas, foo (cuyo valor es bar) y baz (cuyo valor es quux), a tu instancia de Cloud Run.

metadata {
  # Labels
  # https://cloud.google.com/run/docs/configuring/labels
  labels = {
    foo : "bar"
    baz : "quux"
  }
}

Para aplicar tu configuración de Terraform en un proyecto de Google Cloud, completa los siguientes pasos:

  1. Inicia Cloud Shell
  2. Establece el proyecto de Google Cloud en el que deseas aplicar la configuración de Terraform:
    export GOOGLE_CLOUD_PROJECT=PROJECT_ID
    
  3. Crea un directorio y abre un archivo nuevo en ese directorio. El nombre del archivo debe tener la extensión .tf, por ejemplo main.tf:
    mkdir DIRECTORY && cd DIRECTORY && nano main.tf
    
  4. Copia la muestra en main.tf.
  5. Revisa y modifica los parámetros de muestra que se aplicarán a tu entorno.
  6. Para guardar los cambios, presiona Ctrl-x y, luego, y.
  7. Inicializa Terraform mediante este comando:
    terraform init
  8. Revisa la configuración y verifica que los recursos que creará o actualizará Terraform coincidan con tus expectativas:
    terraform plan

    Corrige la configuración según sea necesario.

  9. Para aplicar la configuración de Terraform, ejecuta el siguiente comando y, luego, ingresa yes cuando se te solicite:
    terraform apply

    Espera hasta que Terraform muestre el mensaje “Apply complete!”.

  10. Abre tu proyecto de Google Cloud para ver los resultados. En la consola de Google Cloud, navega a tus recursos en la IU para asegurarte de que Terraform los haya creado o actualizado.

Para trabajos de Cloud Run

Para configurar una etiqueta en un trabajo de Cloud Run, debes hacer lo siguiente:

  1. Para configurar una etiqueta en un trabajo nuevo, sigue estos pasos:

    gcloud beta run jobs create JOB_NAME --image IMAGE_URL --labels KEY=VALUE

    Reemplazar

    • JOB_NAME por el nombre de tu trabajo.
    • KEY por el nombre de la clave de etiqueta
    • VALUE por el valor de la clave
    • Reemplaza IMAGE_URL por una referencia a la imagen de contenedor, como us-docker.pkg.dev/cloudrun/container/job:latest.
  2. Para configurar una etiqueta en un trabajo existente, haz lo siguiente:

    gcloud beta run jobs update JOB_NAME --labels KEY=VALUE

Para crear más de una etiqueta, 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 run services list --filter metadata.labels.LABEL=VALUE
  

Reemplazar

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

Borra una etiqueta de un servicio

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

Console

  1. Ir a Cloud Run

  2. Marca la casilla de verificación a la izquierda del servicio en el que borrarás la etiqueta.

  3. Asegúrate de que el Panel de información en el extremo derecho esté activado (Mostrar panel de información).

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

  5. Ubica la etiqueta que deseas borrar.

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

  7. Haz clic en Guardar.

Línea de comandos

Para borrar todas las etiquetas de un servicio, ejecuta lo siguiente:

gcloud run services update SERVICE --clear-labels

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

gcloud run services update SERVICE --remove-labels LABEL

Reemplaza los siguientes elementos:

  • SERVICE por el nombre del servicio de Cloud Run
  • LABEL por el nombre de tu etiqueta