Etiquetado de los recursos de Amazon EKS - Amazon EKS

Etiquetado de los recursos de Amazon EKS

Para ayudarlo a administrar los recursos de Amazon EKS, puede asignar sus propios metadatos a cada recurso con etiquetas. En este tema se proporciona información general sobre la función de etiquetas y se muestra cómo puede crear etiquetas.

Conceptos básicos de etiquetas

Una etiqueta es una marca que se asigna a un recurso de AWS. Cada etiqueta está formada por una clave y un valor opcional, ambos definidos por el usuario.

Las etiquetas le permiten clasificar los recursos de AWS según, por ejemplo, su finalidad, propietario o entorno. Cuando tenga muchos recursos del mismo tipo, puede identificar rápidamente un recurso específico en función de las etiquetas que le haya asignado. 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.

Además, las etiquetas no se asignan a los recursos automáticamente. 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, pero no puede asignarle un valor nulo. Si agrega una etiqueta con la misma clave que una etiqueta existente en ese recurso, el nuevo valor sobrescribirá al anterior.

Puede etiquetar recursos de clúster nuevos o existentes mediante la AWS Management Console, la AWS CLI o la API de Amazon EKS. Solo puede etiquetar recursos de clúster nuevos mediante eksctl.

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

Etiquetado de los recursos

Puede etiquetar clústeres de Amazon EKS nuevos o existentes y grupos de nodos administrados.

Si utiliza la consola de Amazon EKS, puede aplicar etiquetas a los recursos nuevos o existentes cuando lo desee. Para ello, puede utilizar la pestaña Tags (Etiquetas) en la página de recursos pertinente. Si utiliza eksctl, puede aplicar etiquetas a los recursos cuando se crean mediante la opción --tags.

Si utiliza la API de Amazon EKS, la AWS CLI 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.

Además, algunas acciones de creación de recursos le permiten especificar etiquetas para un recurso al crearlo. Si las etiquetas no se pueden aplicar mientras se crea el recurso, entonces este no se creará. Este mecanismo garantiza que los recursos que pretendía etiquetar en el momento de su creación se creen con etiquetas específicas o no se creen en absoluto. Si etiqueta recursos en el momento de su creación, no es necesario ejecutar scripts de etiquetado personalizados después de la creación del recurso.

En la tabla siguiente se describen los recursos de Amazon EKS que se pueden etiquetar y aquellos que se pueden etiquetar en el momento de su creación.

Compatibilidad con el etiquetado de recursos de Amazon EKS
Recurso Admite etiquetas Admite la propagación de etiquetas Admite el etiquetado durante la creación (API de Amazon EKS, la AWS CLI, el SDK de AWS y eksctl)

Clústeres de Amazon EKS

No. Las etiquetas del clúster no se propagan a ningún otro recurso asociado al clúster.

Grupos de nodos administrados por Amazon EKS

No. Las etiquetas de grupo de nodos administrados no se propagan a ningún otro recurso asociado al grupo de nodos.

Perfiles de Fargate de Amazon EKS

No. Las etiquetas de perfil de Fargate no se propagan a ningún otro recurso asociado al perfil de Fargate, como los pods programados con él.

Restricciones de las etiquetas

Se aplican las siguientes restricciones básicas a las etiquetas:

  • Número máximo de etiquetas por recurso: 50

  • Para cada recurso, cada clave de etiqueta debe ser única y solo puede tener un valor.

  • Longitud máxima de la clave: 128 caracteres Unicode en UTF-8

  • Longitud máxima del valor: 256 caracteres Unicode en UTF-8

  • Si se utiliza su esquema de etiquetado en múltiples servicios y recursos de AWS, recuerde que otros servicios pueden tener restricciones sobre caracteres permitidos. Los caracteres permitidos generalmente son: letras, números y espacios representables en UTF-8, además de 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 que tengan este prefijo no cuentan para el límite de etiquetas por recurso.

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 un recurso en la consola de Amazon EKS, se muestra una lista de dicho recurso. Por ejemplo, si selecciona Clusters (Clústeres) en el panel de navegación, 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).

Adición de etiquetas a un recurso individual durante su creación

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 individual

Amazon EKS le permite agregar o eliminar 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 a utilizar.

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

  4. Elija un clúster específico. Seleccione la pestaña Configuration (Configuración). En la pestaña Tags (Etiquetas), elija Manage tags (Administrar etiquetas).

  5. En la página Update tags (Actualizar etiquetas), agregue o elimine las etiquetas según sea necesario.

    • Para agregar una etiqueta, elija Add Tag (Agregar etiqueta) y, a continuación, especifique la clave y el valor de cada etiqueta.

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

  6. Repita este proceso para cada etiqueta que desee agregar o eliminar y, a continuación, seleccione 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 a los recursos nuevos.

Compatibilidad con el etiquetado de recursos de Amazon EKS
Tarea AWS CLII 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 asociadas a un recurso existente.

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

Algunas acciones de creación de recursos le permiten especificar etiquetas al crear el recurso. Las siguientes acciones admiten etiquetado cuando se crea 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 también desea etiquetar las instancias de Amazon EC2 al crear un grupo de nodos administrados, cree dicho grupo con 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.