Usa etiquetas

Obtén información sobre cómo crear y usar etiquetas en tus servicios y revisiones de Cloud Run for Anthos en Google Cloud.

Las etiquetas son pares clave-valor que se aplican al servicio y las revisiones. Cuando estableces una etiqueta en un servicio de Cloud Run for Anthos, se crea una revisión nueva con esta etiqueta para este servicio. La etiqueta no se aplica a revisiones anteriores.

Las etiquetas de Cloud Run for Anthos son etiquetas de recursos de Kubernetes y no se propagan a Google Cloud. Si quieres obtener más información sobre el uso de etiquetas para analizar el uso de los recursos del clúster, consulta Información sobre el uso de recursos del clúster.

Reglas de uso de etiquetas

Solo se pueden usar las etiquetas de Kubernetes válidas en Cloud Run for Anthos.

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 etiquetas con Cloud Console, la herramienta de línea de comandos de gcloud o un archivo YAML cuando implementas un servicio nuevo o actualizas un servicio existente y Implementa una revisión:

Console

1. Implementar en Cloud Run for Anthos en Google Cloud

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 Labels (Etiquetas) para mostrar el panel de 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 Add Label (Agregar etiqueta) y proporciona la clave y el valor.

7. Haz clic en Guardar.

Línea de comandos

Puedes usar uno de los siguientes comandos gcloud kuberun a fin de establecer etiquetas para servicios nuevos o actualizar servicios existentes:

• Para servicios existentes, actualiza las etiquetas mediante la ejecución del comando gcloud kuberun core services update con uno de los siguientes parámetros:

  • --set-labels
  • --update-labels
  • --remove-labels
  • --clear-labels

  Ejemplo:

  gcloud kuberun core services update SERVICE --update-labels KEY1=VALUE1,KEY2=VALUE2
  

  Reemplaza lo siguiente:

  • SERVICE por el nombre de tu servicio
  • KEY1=VALUE1,KEY2=VALUE2 con una lista separada por comas de los pares de nombre y valor para cada etiqueta Especifica el nombre de la etiqueta para cada KEY y el valor de VALUE. Cómo especificar varios parámetros

  Opciones de parámetro del comando

  A fin de especificar varios conjuntos de pares clave-valor, puedes especificar varios parámetros para facilitar la lectura. Ejemplo:

  [...]
  --set-labels "KEY=VALUE1" \
  --set-labels "KEY=VALUE2" \
  --set-labels "KEY=VALUE3"
  

  Aceptar

• Para servicios nuevos, configura las etiquetas mediante la ejecución del comando gcloud kuberun core services create con el parámetro --set-labels:

  gcloud kuberun core services create SERVICE --image=IMAGE_URL --set-labels KEY1=VALUE1,KEY2=VALUE2
  

  Reemplaza lo siguiente:

  • IMAGE_URL por una referencia a la imagen del contenedor, como gcr.io/myproject/my-image:latest
  • SERVICE por el nombre de tu servicio
  • KEY1=VALUE1,KEY2=VALUE2 con una lista separada por comas de los pares de nombre y valor para cada etiqueta Especifica el nombre de la etiqueta para cada KEY y el valor de VALUE. Cómo especificar varios parámetros

  Opciones de parámetro del comando

  A fin de especificar varios conjuntos de pares clave-valor, puedes especificar varios parámetros para facilitar la lectura. Ejemplo:

  [...]
  --set-labels "KEY=VALUE1" \
  --set-labels "KEY=VALUE2" \
  --set-labels "KEY=VALUE3"
  

  Aceptar

YAML

Precaución: La implementación de cambios de configuración mediante archivos YAML reemplaza la configuración de los servicios existentes. Dado que un archivo YAML reemplaza por completo todas las configuraciones, debes evitar el uso de varios métodos para modificar tus servicios. Por ejemplo, no uses archivos YAML junto con los comandos de gcloud o Cloud Console.

Si deseas usar un archivo YAML para modificar la configuración de tu servicio existente, obtén una copia de la configuración actual, modifica y guarda los cambios en un archivo local y, luego, implementa esos cambios en tu servicio.

1. Muestra como YAML y, luego, copia la configuración de tu servicio en un archivo local, por ejemplo service.yaml:

   gcloud kuberun core services describe SERVICE --format yaml

   Reemplaza SERVICE por el nombre de tu servicio de Cloud Run for Anthos.

2. En tu archivo local, actualiza el atributo labels:

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

   Reemplazar

   • SERVICE por el nombre de tu servicio de Cloud Run for Anthos.
   • LABEL por el nombre de la etiqueta.
   • VALUE por el valor deseado

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

   gcloud beta run services replace service.yaml

Muestra una lista de servicios por etiqueta

Puedes enumerar servicios por etiqueta mediante un filtro del SDK de Cloud:

  gcloud kuberun core 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

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

Console

1. Implementar en Cloud Run for Anthos en Google Cloud

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 Labels 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 kuberun core services update SERVICE --clear-labels

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

gcloud kuberun core services update SERVICE --remove-labels LABEL

Reemplazar

• SERVICE por el nombre de tu servicio de Cloud Run for Anthos.
• LABEL por el nombre de tu etiqueta.