Etiquetado de los recursos de Amazon EKS

Puede usar etiquetas para ayudarlo a administrar sus recursos de Amazon EKS. En este tema se proporciona información general sobre la función de etiquetas y se muestra cómo puede crear etiquetas.

nota

Las etiquetas son un tipo de metadatos independiente de las etiquetas y anotaciones de Kubernetes. Para obtener más información sobre estos otros tipos de metadatos, consulte las secciones siguientes de la documentación de Kubernetes:

• Etiquetas y selectores

• Annotations

Conceptos básicos de etiquetas

Una etiqueta es una marca que se asigna a un recurso de AWS. Cada etiqueta consta de una clave y un valor opcional.

Con las etiquetas, puede categorizar sus recursos de AWS. Por ejemplo, puede clasificar los recursos en categorías por objetivo, propietario o entorno. Cuando tiene muchos recursos del mismo tipo, puede utilizar las etiquetas que asignó a un recurso específico para identificarlo rápidamente. Por ejemplo, puede definir un conjunto de etiquetas para los clústeres de Amazon EKS a fin de ayudar a realizar un seguimiento del propietario y del nivel de pila de cada clúster. Le recomendamos que diseñe un conjunto coherente de claves de etiqueta para cada tipo de recurso. Puede buscar y filtrar los recursos en función de las etiquetas que agregue.

Después de agregar una etiqueta, puede editar las claves y los valores de las etiquetas o eliminar etiquetas de un recurso en cualquier momento. Si elimina un recurso, también se eliminará cualquier etiqueta asignada a dicho recurso.

Las etiquetas no tienen ningún significado semántico para Amazon EKS, por lo que se interpretan estrictamente como cadenas de caracteres. Puede establecer el valor de una etiqueta como una cadena vacía. Sin embargo, no se puede establecer el valor de una etiqueta como nulo. Si agrega una etiqueta con la misma clave que una etiqueta existente en ese recurso, el nuevo valor sobrescribirá al anterior.

Si utiliza AWS Identity and Access Management (IAM), puede controlar qué usuarios de su cuenta de AWS tienen permiso para administrar etiquetas.

Etiquetado de recursos

Las siguientes etiquetas de soporte de recursos de Amazon EKS:

• clústeres

• grupos de nodos administrados

• Perfiles de Fargate

Puede etiquetar estos recursos con lo siguiente:

• Si utiliza la consola de Amazon EKS, puede aplicar etiquetas a recursos nuevos o existentes en cualquier momento. Para ello, puede utilizar la pestaña Tags (Etiquetas) en la página de recursos pertinente. Para obtener más información, consulte Uso de etiquetas mediante la consola.

• Si utiliza eksctl, puede aplicar etiquetas a los recursos cuando se crean mediante la opción --tags.

• Si utiliza la AWS CLI, la API de Amazon EKS o un SDK de AWS, puede aplicar etiquetas a los recursos nuevos mediante el parámetro tags en la acción de la API pertinente. Puede aplicar etiquetas a recursos existentes a través de la acción de la API TagResource. Para obtener más información, consulte TagResource.

Cuando se utilizan algunas acciones de creación de recursos, se pueden especificar también etiquetas para el recurso al mismo tiempo que se crea. Si las etiquetas no pueden aplicarse mientras se crea el recurso, este no podrá crearse. Este mecanismo garantiza que los recursos que se pretenden etiquetar se creen con las etiquetas que se especifican o no se creen en absoluto. Si se etiquetan los recursos al crearlos, no es necesario ejecutar scripts de etiquetado personalizados después de crear el recurso.

Las etiquetas no se propagan a otros recursos asociados al recurso que se crea. Por ejemplo, las etiquetas de perfil de Fargate no se propagan a otros recursos asociados al perfil de Fargate, como los Pods que están programados con él.

Restricciones de las etiquetas

Se aplican las siguientes restricciones a las etiquetas:

• Se puede asociar un máximo de 50 etiquetas a un recurso.

• Las claves de etiquetas no se pueden repetir para un recurso. Cada clave de etiqueta debe ser única y solo puede tener un valor.

• Las claves pueden tener hasta 128 caracteres en UTF-8.

• Los valores pueden tener hasta 256 caracteres en UTF-8.

• Si hay múltiples Servicios de AWS y los recursos usan su esquema de etiquetado, limite los tipos de caracteres que usa. Algunos servicios pueden tener restricciones en cuanto a los caracteres permitidos. En general, los caracteres permitidos son letras, números, espacios y los siguientes caracteres: + - = . _ : / @.

• Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas.

• No utilice aws:, AWS:, ni ninguna combinación de mayúsculas o minúsculas del mismo como prefijo para claves o valores. Estos están reservados solo para la utilización de AWS. Las claves y valores de etiquetas que tienen este prefijo no se pueden editar. Las etiquetas con este prefijo no cuentan para el límite de etiquetas por recurso.

Etiquetado de los recursos para facturación

Cuando aplica etiquetas a los clústeres de Amazon EKS, puede utilizarlas para la asignación de costos en sus Informes de costo y uso. Los datos de medición de sus Informes de costo y uso muestran el uso en todos sus clústeres de Amazon EKS. Para obtener más información, consulte Informe de costos y usos de AWS en la Guía del usuario de AWS Billing.

La etiqueta de asignación de costos generada por AWS, específicamente aws:eks:cluster-name, le permite desglosar los costos de las instancias de Amazon EC2 por clúster individual de Amazon EKS en el Explorador de costos. Sin embargo, esta etiqueta no captura los gastos del plano de control. La etiqueta se agrega automáticamente a las instancias de Amazon EC2 que participan en un clúster de Amazon EKS. Este comportamiento se produce independientemente de si las instancias se aprovisionan mediante grupos de nodos administrados de Amazon EKS, Karpenter o directamente con Amazon EC2. Esta etiqueta específica no cuenta para el límite de 50 etiquetas. Para usar la etiqueta, el propietario de la cuenta debe activarla en la consola de AWS Billing o mediante la API. Cuando el propietario de una cuenta de administración de AWS Organizations activa la etiqueta, esta también se activa para todas las cuentas miembro de la organización.

También puede organizar su información de facturación en función de los recursos que tienen los mismos valores de clave de etiqueta. Por ejemplo, puede etiquetar varios recursos con un nombre de aplicación específico y, luego, organizar su información de facturación. De esta manera, puede ver el costo total de la aplicación en distintos servicios. Para obtener más información acerca de la configuración de un informe de asignación de costos con etiquetas, consulte Informe de asignación de costos mensual en la Guía del usuario de AWS Billing.

nota

Si acaba de activar los informes, los datos del mes actual estarán disponibles para su visualización después de 24 horas.

El Explorador de costos es una herramienta de informes que está disponible como parte del nivel gratuito de AWS. Puede utilizar el Explorador de costos para ver los gráficos de sus recursos de Amazon EKS de los últimos 13 meses. También puede prever cuánto va a gastar en los próximos tres meses. Puede ver los patrones de lo que gasta en recursos de AWS a lo largo del tiempo. Por ejemplo, se puede utilizar para identificar aspectos que deben estudiarse más a fondo y observar tendencias que pueden ayudar a comprender los costos. También puede especificar intervalos de tiempo para los datos y ver los datos temporales por día o por mes.

Uso de etiquetas mediante la consola

Con la consola de Amazon EKS puede administrar las etiquetas asociadas a los clústeres nuevos o existentes y a grupos de nodos administrados.

Al seleccionar una página específica de recursos en la consola de Amazon EKS, se muestra una lista de esos recursos. Por ejemplo, si selecciona Clusters (Clústeres) en el panel de navegación izquierda, la consola muestra una lista de los clústeres de Amazon EKS. Al seleccionar un recurso de una de estas listas (por ejemplo, un clúster concreto) que admite etiquetas, puede ver y administrar sus etiquetas en la pestaña Tags (Etiquetas).

También puede utilizar Tag Editor (Editor de etiquetas) en laAWS Management Console, que proporciona una forma unificada de administrar las etiquetas. Para obtener más información, consulte Etiquetar recursos de AWS con el editor de etiquetas en la Guía del usuario del editor de etiquetas deAWS.

Adición de etiquetas a un recurso al crearlo

Puede agregar etiquetas a clústeres de Amazon EKS y grupos de nodos administrados y perfiles de Fargate al crearlos. Para obtener más información, consulte Creación de un clúster de Amazon EKS.

Adición y eliminación de etiquetas en un recurso

Puede agregar o eliminar las etiquetas asociadas a sus clústeres directamente desde la página del recurso.

Para agregar o eliminar una etiqueta en un recurso individual

1. Abra la consola de Amazon EKS en https://console.aws.amazon.com/eks/home#/clusters.

2. En la barra de navegación, seleccione la Región de AWS que utilizará.

3. En el panel de navegación izquierdo, elija Clusters (Clústeres).

4. Elija un clúster específico.

5. Elija la pestaña Etiquetas y, a continuación, elija Administrar etiquetas.

6. En la página Manage tags (Administrar etiquetas), agregue o elimine las etiquetas según sea necesario.

   • Para agregar una etiqueta, elija Add tag (Añadir etiqueta). Especifique la clave y el valor para cada etiqueta.

   • Para eliminar una etiqueta, seleccione Remove tag (Eliminar etiqueta).

7. Repita este proceso para cada etiqueta que desee agregar o eliminar.

8. Elija Update (Actualizar) para finalizar.

Uso de etiquetas mediante la CLI, la API o eksctl

Utilice los siguientes comandos de la AWS CLI o las operaciones de la API de Amazon EKS para agregar, actualizar, enumerar y eliminar las etiquetas de sus recursos. Solo puede utilizar eksctl para agregar etiquetas mientras se crean simultáneamente los nuevos recursos con un comando.

Compatibilidad con el etiquetado de recursos de Amazon EKS
Tarea	AWS CLI	AWS Tools for Windows PowerShell	Acción de la API
Agregar o sobrescribir una o varias etiquetas.	tag-resource	Add-EKSResourceTag	TagResource
Eliminar una o varias etiquetas.	untag-resource	Remove-EKSResourceTag	UntagResource

Los siguientes ejemplos muestran cómo agregar o quitar etiquetas a los recursos mediante la AWS CLI.

Ejemplo 1: Etiquetar un clúster existente

El siguiente comando etiqueta un clúster existente.

aws eks tag-resource --resource-arn resource_ARN --tags team=devs

Ejemplo 2: Quitar la etiqueta de un clúster existente

El siguiente comando elimina una etiqueta de un clúster existente.

aws eks untag-resource --resource-arn resource_ARN --tag-keys tag_key

Ejemplo 3: enumerar etiquetas de un recurso

El siguiente comando enumera las etiquetas que están asociadas a un recurso existente.

aws eks list-tags-for-resource --resource-arn resource_ARN

Cuando se utilizan algunas acciones de creación de recursos, se pueden especificar etiquetas al mismo tiempo que se crea el recurso. Las siguientes acciones permiten especificar una etiqueta al crear un recurso.

Tarea	AWS CLI	AWS Tools for Windows PowerShell	Acción de la API	eksctl
Crear un clúster	create-cluster	New-EKSCluster	CreateCluster	create cluster
Crear un grupo de nodos administrados*	create-nodegroup	New-EKSNodegroup	CreateNodegroup	create nodegroup
Crear un perfil de Fargate	create-fargate-profile	New-EKSFargateProfile	CreateFargateProfile.html	create fargateprofile

* Si desea etiquetar también las instancias de Amazon EC2 al crear un grupo de nodos administrados, cree el grupo de nodos administrados mediante una plantilla de lanzamiento. Para obtener más información, consulte Etiquetado de instancias de Amazon EC2. Si las instancias ya existen, puede etiquetarlas de forma manual. Para obtener más información, consulte Etiquetado de los recursos en la Guía del usuario de Amazon EC2 para instancias de Linux.