Assegnazione di tag alle risorse Amazon EKS

È possibile utilizzare tag per aiutarti a gestire le risorse Amazon EKS. In questo argomento viene fornita una panoramica della funzione tag e viene illustrato come creare tag.

Nota

I tag sono un tipo di metadati separati dalle etichette e dalle annotazioni di Kubernetes. Per ulteriori informazioni sugli altri tipi di metadati, consulta le sezioni seguenti nella documentazione di Kubernetes:

• Etichette e selettori

• Annotazioni

Nozioni di base sui tag

Un tag è un'etichetta che assegni a una risorsa AWS. Ciascun tag è formato da una chiave e da un valore opzionale.

Puoi utilizzare i tag per categorizzare le risorse AWS. Ad esempio, puoi categorizzarle in base a scopo, proprietario o ambiente. In presenza di un numero elevato di risorse dello stesso tipo, si possono usare i tag assegnati a una risorsa specifica per identificarla rapidamente. Ad esempio, è possibile definire un set di tag per i cluster Amazon EKS per monitorare il proprietario di ogni cluster e il livello di pila. Ti consigliamo di definire un set coerente di chiavi di tag per ogni tipo di risorsa. È possibile cercare e filtrare le risorse in base ai tag aggiunti.

Dopo aver aggiunto un tag, puoi modificarne le chiavi e i valori oppure rimuovere i tag da una risorsa in qualsiasi momento. Se elimini una risorsa, verranno eliminati anche tutti i tag a essa associati.

I tag non hanno alcun significato semantico per Amazon EKS e vengono interpretati rigorosamente come una stringa di caratteri. È possibile impostare il valore di un tag su una stringa vuota. Tuttavia, non è possibile impostare il valore di un tag su null. Se aggiungi un tag con la stessa chiave di un tag esistente a una risorsa specifica, il nuovo valore sovrascrive quello precedente.

Se utilizzi AWS Identity and Access Management (IAM), puoi controllare quali utenti nel tuo account AWS dispongono dell'autorizzazione per gestire i tag.

Tagging delle risorse 

I tag sono disponibili per le risorse Amazon EKS seguenti:

• cluster

• gruppi di nodi gestiti

• profili Fargate

Puoi aggiungere un tag a queste risorse utilizzando le opzioni seguenti:

• Se utilizzi la console Amazon EKS, è possibile applicare tag alle risorse nuove o esistenti in qualsiasi momento. A tale scopo, è possibile utilizzare la sheda Tag nella pagina della risorsa interessata. Per ulteriori informazioni, consulta Utilizzo di tag tramite la console.

• Se utilizzi eksctl, è possibile applicare i tag alle risorse quando vengono create utilizzando l'opzione --tags.

• Se utilizzi la AWS CLI, l'API Amazon EKS o un SDK AWS, è possibile applicare i tag alle nuove risorse mediante il parametro tags nell'operazione API rilevante. Puoi applicare tag a risorse esistenti utilizzando l'operazione API TagResource. Per ulteriori informazioni, vedere TagResource.

Quando utilizzi alcune azioni per la creazione di risorse, puoi anche specificare i tag per la risorsa nello stesso momento in cui la crei. Se i tag non possono essere applicati durante la creazione di una risorsa, la risorsa non potrà essere creata. Mediante questo meccanismo ti assicuri che le risorse a cui desideri applicare tag al momento della creazione vengono create con tag specifici o non vengono create affatto. Se aggiungi tag alle risorse al momento della creazione, non è necessario eseguire script di assegnazione di tag personalizzati dopo la creazione di una risorsa.

I tag non si propagano ad altre risorse associate alla risorsa creata. Ad esempio, i tag del profilo Fargate non vengono propagati ad altre risorse associate al profilo Fargate, come i Pods pianificati con esso.

Limitazioni applicate ai tag

Ai tag si applicano le limitazioni seguenti:

• È possibile associare un massimo di 50 tag a una risorsa.

• Le chiavi dei tag non possono essere ripetute per una risorsa. Ogni chiave di tag deve essere univoca e può avere un solo valore.

• Le chiavi di tag possono contenere fino a 128 caratteri in UTF-8.

• Ogni valore può contenere fino a 256 caratteri UTF-8.

• Se moltiplichi Servizi AWS e le risorse utilizzano il tuo schema di tagging, limita i tipi di caratteri che usi. Alcuni servizi potrebbero avere restrizioni sui caratteri consentiti. I caratteri generalmente consentiti sono lettere, numeri, spazi e i simboli seguenti: + - = . _ : / @.

• I valori e le chiavi dei tag rispettano la distinzione tra maiuscole e minuscole.

• Non utilizzare aws:, AWS: o qualsiasi combinazione di maiuscole o minuscole di un tale prefisso per chiavi o valori. Questi sono riservati solo all'utilizzo di AWS. Non è possibile modificare né eliminare le chiavi o i valori di tag con tale prefisso. I tag con questo prefisso non rientrano nel tuo tags-per-resource limite.

Tagging delle risorse per la fatturazione

Quando applichi i tag ai cluster Amazon EKS, puoi utilizzarli per l'allocazione dei costi nel tuo Rapporti su costi e utilizzo. I dati di misurazione nel Rapporti su costi e utilizzo mostrano l'utilizzo in tutti i processi dei cluster di Amazon EKS. Per ulteriori informazioni, consulta AWS report su costi e utilizzo nella Guida per l'utente di AWS Billing.

Il tag di allocazione dei costi generato da AWS, specificamente aws:eks:cluster-name, consente di suddividere i costi delle istanze Amazon EC2 per ogni singolo cluster Amazon EKS in Cost Explorer. Tuttavia, questo tag non rileva le spese del piano di piano di controllo (control-plane). Il tag viene aggiunto automaticamente alle istanze Amazon EC2 che fanno parte di un cluster Amazon EKS. Questo comportamento si verifica indipendentemente dal fatto che le istanze vengano allocate tramite gruppi di nodi gestiti da Amazon EKS, Karpenter o direttamente con Amazon EC2. Questo tag specifico non viene conteggiato ai fini del limite di 50 tag. Per utilizzare il tag, il proprietario dell'account deve attivarlo nella console AWS Billing utilizzando l'API. Quando il proprietario di un account di gestione AWS Organizations attiva il tag, questo viene attivato anche per tutti gli account membri dell'organizzazione.

Puoi organizzare le informazioni di fatturazione in base alle risorse con gli stessi valori di chiave di tag. Puoi ad esempio applicare tag a numerose risorse con un nome di applicazione specifico, quindi organizzare le informazioni di fatturazione. In questo modo, puoi visualizzare il costo totale dell'applicazione in più servizi. Per ulteriori informazioni sulla configurazione di un report di allocazione dei costi mediante i tag, consulta Report di allocazione dei costi mensili nella Guida per l'utente di AWS Billing.

Nota

Se hai appena abilitato la reportistica, i dati relativi al mese corrente saranno disponibili per la visualizzazione dopo 24 ore.

Cost Explorer è uno strumento di reporting disponibile come parte di piano gratuito AWS. È possibile utilizzare Cost Explorer per visualizzare i grafici delle tue risorse Amazon EKS degli ultimi 13 mesi. Puoi anche prevedere le spese per i prossimi tre mesi. Puoi visualizzare i modelli relativi a quanto spendi in risorse AWS nel tempo. Ad esempio, puoi utilizzarlo per identificare aree che richiedono ulteriore studio e visualizzare le tendenze che puoi utilizzare per comprendere i costi. Puoi anche specificare intervalli di tempo per i dati e visualizzare i dati temporali per mese o per giorno.

Utilizzo di tag tramite la console

Con la console Amazon EKS è possibile gestire i tag associati ai gruppi di nodi gestiti o ai cluster nuovi o esistenti.

Quando selezioni una pagina relativa alle risorse nella console Amazon EKS, viene visualizzato l'elenco delle risorse corrispondenti. Ad esempio, se nel riquadro di navigazione sinistro si seleziona Cluster, nella console viene visualizzato l'elenco dei cluster Amazon EKS. Quando si seleziona una risorsa in uno di questi elenchi, (ad esempio un cluster specifico), se la risorsa supporta i tag, sarà possibile visualizzare e gestire i tag nella scheda Tag.

L'Editor di tag della AWS Management Console consente inoltre di gestire i tag modo unificato. Per ulteriori informazioni, consulta Tagging delle risorseAWS con l’editor di tag nella Guida per l'utente dell'editor di tag AWS.

Aggiunta di tag a una risorsa in fase di creazione

É possibile aggiungere tag ai gruppi di nodi gestiti, ai cluster Amazon EKS ed ai profili Fargate durante la creazione. Per ulteriori informazioni, consulta Creazione di un cluster Amazon EKS.

Aggiunta ed eliminazione di tag in una risorsa

Puoi aggiungere o eliminare i tag associati ai cluster direttamente dalla pagina della risorsa.

Per aggiungere o eliminare un tag su una singola risorsa

1. Aprire la console Amazon EKS all'indirizzo https://console.aws.amazon.com/eks/home#/clusters.

2. Seleziona la Regione AWS da utilizzare nella barra di navigazione.

3. Nel pannello di navigazione a sinistra, seleziona Cluster.

4. Scegliere un cluster specifico.

5. Scegliere la scheda Tags (Tag) quindi scegliere Manage tags (Gestisci tag).

6. Nella pagina Gestisci i tag, aggiungi o elimina i tag in base alle esigenze.

   • Per aggiungere un tag, scegli Add tag (Aggiungi tag). Specificare la chiave e il valore per ogni tag.

   • Per eliminare un tag, scegli Rimuovi tag.

7. Ripeti la procedura per ogni tag da aggiungere o eliminare.

8. Scegliere Update (Aggiorna) per terminare.

Utilizzo di tag tramite la CLI, l'API o eksctl

Utilizza i seguenti comandi AWS CLI o operazioni API Amazon EKS per aggiungere, aggiornare, elencare ed eliminare i tag per le risorse. È possibile utilizzare solo eksctl per aggiungere tag e contemporaneamente creare le nuove risorse con un unico comando.

Supporto dell'assegnazione di tag alle risorse Amazon EKS
Attività	AWS CLI	AWS Tools for Windows PowerShell	Azione API
Aggiungere sovrascrivere uno o più tag.	tag-resource	Add-EKSResourceTag	TagResource
Eliminare uno o più tag.	untag-resource	Remove-EKSResourceTag	UntagResource

I seguenti esempi mostrano come aggiungere o rimuovere tag alle o dalle risorse utilizzando la AWS CLI.

Esempio 1: applicazione di un tag a un cluster esistente

Il comando seguente applica un tag a un cluster esistente.

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

Esempio 2: rimozione di un tag a un cluster esistente

Il comando seguente elimina un tag da un cluster esistente.

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

Esempio 3: elencazione dei tag di una risorsa

Il comando seguente elenca i tag associati a una risorsa esistente.

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

Quando utilizzi alcune azioni per la creazione di risorse, puoi anche specificare i tag per la risorsa nello stesso momento in cui la crei. Le seguenti operazioni supportano l'assegnazione di tag durante la creazione di una risorsa.

Attività	AWS CLI	AWS Tools for Windows PowerShell	Azione API	eksctl
Creazione di un cluster	create-cluster	New-EKSCluster	CreateCluster	create cluster
Creazione di un gruppo di nodi gestito*	create-nodegroup	New-EKSNodegroup	CreateNodegroup	create nodegroup
Creazione di un profilo Fargate	create-fargate-profile	New-EKSFargateProfile	CreateFargateProfile.html	create fargateprofile

* Se desideri taggare anche le istanze Amazon EC2 durante la creazione di un gruppo di nodi gestito, crea il gruppo di nodi gestito utilizzando un modello di avvio. Per ulteriori informazioni, consulta Assegnazione di tag a istanze Amazon EC2. Se le istanze esistono già, è possibile taggare manualmente le istanze. Per ulteriori informazioni, consultare Assegnazione di tag alle risorse nella Guida per l'utente di Amazon EC2 per istanze Linux.