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.

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 una instancia de Cloud Run:

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

Etiquetas para datos de facturación y registro

La Facturación de Cloud y Cloud Logging reciben etiquetas que se especifican en el atributo metadata.labels en YAML o con Google Cloud CLI.

Roles obligatorios

Para obtener los permisos que necesitas para configurar e implementar 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 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 los permisos de implementación y cómo administrar el acceso.

Configura o modifica etiquetas

Puedes configurar o modificar las etiquetas con Google Cloud CLI o YAML:

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 esta ya existe; de lo contrario, crea una etiqueta nueva.

Reemplaza lo siguiente:

  • INSTANCE: Es el nombre de tu instancia de Cloud Run.
  • KEY: Es el nombre de la clave de etiqueta.
  • VALUE: Es 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: Es el nombre de tu instancia de Cloud Run.
    • KEY y VALUE: Son los pares clave-valor para las etiquetas.

    metadata.labels establece etiquetas en el objeto de instancia.

  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 con un filtro de Google Cloud CLI:

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

Reemplaza lo siguiente:

  • LABEL: Es el nombre de la etiqueta.
  • VALUE: Es el valor que se incluirá en la 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: Es el nombre de tu instancia de Cloud Run.
  • LABEL: Es el nombre de tu etiqueta.