Ayude a mejorar esta página
¿Quiere contribuir a esta guía del usuario? Desplácese hasta el final de esta página y seleccione Editar esta página en GitHub. Sus contribuciones ayudarán a que nuestra guía del usuario sea mejor para todos.
Organización de los recursos de Amazon EKS con etiquetas
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.
Temas
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:
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
tagsen la acción de la API pertinente. Puede aplicar etiquetas a recursos existentes a través de la acción de la APITagResource. 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
-
Abra la consola de Amazon EKS en https://console.aws.amazon.com/eks/home#/clusters
. -
En la barra de navegación, seleccione la Región de AWS que utilizará.
-
En el panel de navegación izquierdo, elija Clusters (Clústeres).
-
Elija un clúster específico.
-
Elija la pestaña Etiquetas y, a continuación, elija Administrar etiquetas.
-
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).
-
-
Repita este proceso para cada etiqueta que desee agregar o eliminar.
-
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.
| Tarea | AWS CLI | AWS Tools for Windows PowerShell | Acción de la API |
|---|---|---|---|
|
Agregar o sobrescribir una o varias etiquetas. |
|||
|
Eliminar una o varias etiquetas. |
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-arnresource_ARN--tagsteam=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-arnresource_ARN--tag-keystag_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-arnresource_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 |
|---|---|---|---|---|
|
Creación de un clúster |
|
|||
|
Crear un grupo de nodos administrados* |
|
|||
|
Crear un perfil de Fargate |
|
* 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.
