**Contribuisci a migliorare questa pagina** Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. Per contribuire a questa guida per l'utente, scegli il GitHub ** link ** Modifica questa pagina su che si trova nel riquadro destro di ogni pagina. Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Organizzazione delle risorse Amazon EKS con tag È 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. **Topics** + [Nozioni di base sui tag](#tag-basics) + [Tagging delle risorse](#tag-resources) + [Limitazioni applicate ai tag](#tag-restrictions) + [Tagging delle risorse per la fatturazione](#tag-resources-for-billing) + [Utilizzo di tag tramite la console](#tag-resources-console) + [Lavorare con i tag utilizzando la CLI, l'API o eksctl ``](#tag-resources-api-sdk) **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](https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/) [Annotazioni](https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/) ## Nozioni di base sui tag Un tag è un'etichetta che si assegna a una AWS risorsa. Ciascun tag è formato da una *chiave* e da un *valore* opzionale. Con i tag, puoi classificare le tue AWS risorse. 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, puoi definire un set di tag per i cluster Amazon EKS per monitorare il proprietario di ogni cluster e il livello di stack. Consigliamo di definire un set coerente di chiavi di tag per ciascun 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 del tuo AWS account sono autorizzati a 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, puoi 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](#tag-resources-console). + Se utilizzi `eksctl`, puoi applicare i tag alle risorse quando vengono create utilizzando l’opzione `--tags`. + Se utilizzi la AWS CLI, l'API Amazon EKS o un AWS SDK, puoi applicare tag a nuove risorse utilizzando il `tags` parametro sull'azione API pertinente. Puoi applicare tag a risorse esistenti utilizzando l'operazione API `TagResource`. Per ulteriori informazioni, consulta [TagResource](https://docs.aws.amazon.com/eks/latest/APIReference/API_TagResource.html). 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 viene 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 di Fargate non vengono propagati ad altre risorse associate a tale profilo, come i pod 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 possono contenere fino a 128 caratteri. UTF-8 + I valori possono contenere fino a 256 caratteri UTF-8. + Se più AWS servizi e risorse utilizzano il tuo schema di codifica, 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 come prefisso per chiavi o valori. Questi sono riservati solo all' AWS uso. Non puoi modificare né eliminare le chiavi o i valori di tag con tale prefisso. I tag con questo prefisso non vengono conteggiati per il limite del numero di tag per risorsa. ## 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 il rapporto su [AWS costi e utilizzo ](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-reports-costusage.html) nella * AWS Billing User Guide*. Il tag di allocazione dei costi AWS generato, in particolare`aws:eks:cluster-name`, consente di suddividere i costi delle istanze Amazon EC2 per singolo cluster Amazon EKS in ** Cost Explorer. ** Tuttavia, questo tag non rileva le spese del 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 venga eseguito il provisioning delle istanze 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 di AWS fatturazione o utilizzando l'API. Quando il proprietario dell'account di gestione di un' AWS organizzazione 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 sull'impostazione di un report di allocazione dei costi con tag, consulta [ The Monthly Cost Allocation Report ](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/configurecostallocreport.html) nella * AWS Billing User Guide. * **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 del AWS piano gratuito. È 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 vedere i modelli di quanto spendi in AWS risorse 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**. Puoi anche utilizzare ** Tag Editor ** in Console di gestione AWS, che fornisce un modo unificato per gestire i tag. Per ulteriori informazioni, consulta [ Taggare le AWS risorse con Tag Editor ](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html) nella Guida per l'utente di * AWS Tag Editor. * ### 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 [Crea un cluster Amazon EKS.](create-cluster.md). ### Aggiunta ed eliminazione di tag in una risorsa Puoi aggiungere o eliminare i tag associati ai cluster direttamente dalla pagina della risorsa. 1. Aprire la [Console Amazon EKS](https://console.aws.amazon.com/eks/home#/clusters). 1. Nella barra di navigazione, seleziona la AWS regione da utilizzare. 1. Nel pannello di navigazione a sinistra, seleziona **Cluster**. 1. Scegliere un cluster specifico. 1. Scegliere la scheda **Tags** (Tag) quindi scegliere **Manage tags** (Gestisci tag). 1. 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**. 1. Ripeti la procedura per ogni tag da aggiungere o eliminare. 1. Scegliere **Update (Aggiorna)** per terminare. ## Lavorare con i tag utilizzando la CLI, l'API o eksctl `` Usa i seguenti comandi AWS CLI o le operazioni API di Amazon EKS per aggiungere, aggiornare, elencare ed eliminare i tag per le tue risorse. È possibile utilizzare solo `eksctl` per aggiungere tag e contemporaneamente creare le nuove risorse con un unico comando. | Operazione | AWS CLI | AWS Strumenti per Windows PowerShell | Azione API | | --- | --- | --- | --- | | Aggiungere sovrascrivere uno o più tag. | [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/eks/tag-resource.html) | [Add-EKSResourceTag](https://docs.aws.amazon.com/powershell/latest/reference/items/Add-EKSResourceTag.html) | [TagResource](https://docs.aws.amazon.com/eks/latest/APIReference/API_TagResource.html) | | Eliminare uno o più tag. | [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/eks/untag-resource.html) | [Remove-EKSResourceTag](https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-EKSResourceTag.html) | [UntagResource](https://docs.aws.amazon.com/eks/latest/APIReference/API_UntagResource.html) | Gli esempi seguenti mostrano come etichettare o rimuovere i tag 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. | Operazione | AWS CLI | AWS Strumenti per Windows PowerShell | Azione API | eksctl | | --- | --- | --- | --- | --- | | Creazione di un cluster | [create-cluster](https://docs.aws.amazon.com/cli/latest/reference/eks/create-cluster.html) | [New-EKSCluster](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EKSCluster.html) | [CreateCluster](https://docs.aws.amazon.com/eks/latest/APIReference/API_CreateCluster.html) | `create cluster` | | Creazione di un gruppo di nodi gestito\* | [create-nodegroup](https://docs.aws.amazon.com/cli/latest/reference/eks/create-nodegroup.html) | [New-EKSNodegroup](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EKSNodegroup.html) | [CreateNodegroup](https://docs.aws.amazon.com/eks/latest/APIReference/API_CreateNodegroup.html) | `create nodegroup` | | Creazione di un profilo Fargate | [create-fargate-profile](https://docs.aws.amazon.com/cli/latest/reference/eks/create-fargate-profile.html) | [New-EKSFargateProfile](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EKSFargateProfile.html) | [CreateFargateProfile](https://docs.aws.amazon.com/eks/latest/APIReference/API_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](launch-templates.md#launch-template-tagging). Se le istanze esistono già, è possibile taggare manualmente le istanze. Per ulteriori informazioni, consulta [Tagging your resources](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#tag-resources) nella Guida per l’utente di Amazon EC2.