

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à.

# Etichetta automaticamente gli allegati Transit Gateway utilizzando AWS Organizations
<a name="tag-transit-gateway-attachments-automatically-using-aws-organizations"></a>

*Richard Milner-Watts, Haris Bin Ayub e John Capps, Amazon Web Services*

## Riepilogo
<a name="tag-transit-gateway-attachments-automatically-using-aws-organizations-summary"></a>

Su Amazon Web Services (AWS), puoi utilizzarlo [AWS Resource Access Manager](https://aws.amazon.com/ram/)per condividere [AWS Transit Gateway](https://aws.amazon.com/transit-gateway/)oltre Account AWS i confini. Tuttavia, quando si creano allegati Transit Gateway oltre i limiti dell'account, gli allegati vengono creati senza un tag Name. Ciò può rendere l'identificazione degli allegati dispendiosa in termini di tempo. 

Questa soluzione fornisce un meccanismo automatizzato per raccogliere informazioni su ogni allegato Transit Gateway per gli account all'interno di un'organizzazione gestita da [AWS Organizations](https://aws.amazon.com/organizations/). Il processo include la ricerca dell'intervallo [Classless Inter-Domain Routing (CIDR) dalla tabella di routing](https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) Transit Gateway. La soluzione applica quindi un tag Name sotto forma di all'allegato all'interno dell'`<CIDR-range>-<AccountName>`account che contiene il gateway di transito.

Questa soluzione può essere utilizzata insieme a una soluzione come il [Serverless Transit Network Orchestrator](https://aws.amazon.com/solutions/implementations/serverless-transit-network-orchestrator/) della Solutions Library. AWS Serverless Transit Network Orchestrator consente la creazione automatizzata di allegati Transit Gateway Gateway su larga scala.

## Prerequisiti e limitazioni
<a name="tag-transit-gateway-attachments-automatically-using-aws-organizations-prereqs"></a>

**Prerequisiti**
+ Un attivo Account AWS
+ Un' AWS Organizations organizzazione che contiene tutti gli account correlati
+ Accesso all'account di gestione dell'organizzazione, nella directory principale dell'organizzazione, per creare il ruolo richiesto AWS Identity and Access Management (IAM)
+ Un account membro della rete condivisa contenente uno o più gateway di transito condivisi con l'organizzazione e dotati di allegati

## Architecture
<a name="tag-transit-gateway-attachments-automatically-using-aws-organizations-architecture"></a>

La seguente schermata Console di gestione AWS mostra esempi di allegati Transit Gateway senza tag Name associato e due allegati Transit Gateway con tag Name generati da questa soluzione. La struttura del tag Name generato è. `<CIDR-range>-<AccountName>`

![\[La console mostra gli allegati senza tag Name e due allegati con i tag Name.\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/images/pattern-img/4b10dfec-43be-4337-9945-c64df921934a/images/7e7d4a47-f07a-4708-8022-a1d22855bb5d.png)


 

Questa soluzione utilizza un [AWS Step Functions](https://aws.amazon.com/step-functions/)flusso [AWS CloudFormation](https://aws.amazon.com/cloudformation/)di lavoro che gestisce la creazione di tag Transit Gateway Name su tutte le Regioni AWS configurazioni. Il flusso di lavoro richiama [AWS Lambda](https://aws.amazon.com/lambda/)funzioni che eseguono le attività sottostanti.

Dopo che la soluzione ha ottenuto i nomi degli account da AWS Organizations, la macchina a stati Step Functions ottiene tutti gli allegati Transit Gateway IDs. Questi vengono elaborati in parallelo per regione. Questa elaborazione include la ricerca dell'intervallo CIDR per ogni allegato. L'intervallo CIDR si ottiene cercando nelle tabelle di routing Transit Gateway all'interno della regione un ID allegato Transit Gateway corrispondente. Se tutte le informazioni richieste sono disponibili, la soluzione applica un tag Name all'allegato. La soluzione non sovrascriverà alcun tag Name esistente.

La soluzione viene eseguita secondo una pianificazione controllata da un EventBridge evento [Amazon](https://aws.amazon.com/eventbridge/). L'evento avvia la soluzione ogni giorno alle 06:00 UTC.

**Stack tecnologico Target**
+ Amazon EventBridge
+ AWS Lambda
+ AWS Organizations
+ AWS Transit Gateway
+ Amazon Virtual Private Cloud (Amazon VPC) (Amazon VPC)
+ AWS X-Ray

**Architettura Target**

L'architettura della soluzione e il flusso di lavoro sono illustrati nel diagramma seguente.

![\[Processo in nove fasi tra account di rete condivisi e di gestione dell'organizzazione.\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/images/pattern-img/4b10dfec-43be-4337-9945-c64df921934a/images/873cc89f-c6e3-43cd-94ed-59b6ea2b8d49.png)


1. L'evento pianificato avvia la regola.

1. La EventBridge regola avvia la macchina a stati Step Functions.

1. La macchina a stati richiama la funzione Lambda`tgw-tagger-organizations-account-query`.

1. La funzione `tgw-tagger-organizations-account-query` Lambda assume il ruolo nell'account di gestione dell'organizzazione.

1. La funzione `tgw-tagger-organizations-account-query` Lambda richiama l'API Organizations per restituire Account AWS i metadati.

1. La macchina a stati richiama la funzione Lambda`tgw-tagger-attachment-query`.

1. Per ogni regione, in parallelo, la macchina a stati richiama la funzione `tgw-tagger-rtb-query` Lambda per leggere l'intervallo CIDR per ogni allegato.

1. Per ogni regione, in parallelo, la macchina a stati richiama la funzione Lambda `tgw-tagger-attachment-tagger`****.

1. I name tag vengono creati per gli allegati Transit Gateway nell'account Shared Networking.

**Automazione e scalabilità**

La soluzione elabora ogni regione in parallelo per ridurre la durata totale dell'esecuzione.

## Tools (Strumenti)
<a name="tag-transit-gateway-attachments-automatically-using-aws-organizations-tools"></a>

**Servizi AWS**
+ [AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)fornisce un modo per modellare una raccolta di risorse correlate AWS e di terze parti, fornirle in modo rapido e coerente e gestirle durante tutto il loro ciclo di vita, trattando l'infrastruttura come codice.
+ [Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html) ti CloudWatch aiuta a monitorare i parametri delle tue risorse AWS e delle applicazioni su cui esegui AWS in tempo reale.
+ [Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) è un servizio di bus eventi senza server che puoi utilizzare per connettere le tue applicazioni con dati provenienti da una varietà di fonti. EventBridge riceve un evento, un indicatore di un cambiamento nell'ambiente e applica una regola per indirizzare l'evento verso un obiettivo. Le regole abbinano gli eventi agli obiettivi in base alla struttura dell'evento, chiamata pattern di evento, o a una pianificazione.
+ [AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html)è un servizio di elaborazione che supporta l'esecuzione di codice senza fornire o gestire server. Lambda esegue il codice solo quando necessario e si ridimensiona automaticamente, da poche richieste al giorno a migliaia al secondo. I costi saranno calcolati in base al tempo di elaborazione effettivo. Quando il codice non è in esecuzione non viene addebitato alcun costo.
+ [AWS Organizations](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_introduction.html)ti aiuta a gestire e governare centralmente il tuo ambiente man mano che cresci e scalerai le tue risorse. AWS Utilizzando Organizations, puoi creare nuove risorse Account AWS e allocarle in modo programmatico, raggruppare account per organizzare i flussi di lavoro, applicare politiche agli account o ai gruppi per la governance e semplificare la fatturazione utilizzando un unico metodo di pagamento per tutti i tuoi account.
+ [AWS Step Functions](https://docs.aws.amazon.com/step-functions/latest/dg/welcome.html)è un servizio di flusso di lavoro visivo a basso codice utilizzato per orchestrare Servizi AWS, automatizzare i processi aziendali e creare applicazioni serverless. I flussi di lavoro gestiscono gli errori, i nuovi tentativi, la parallelizzazione, le integrazioni dei servizi e l'osservabilità, in modo che gli sviluppatori possano concentrarsi su logiche aziendali di maggior valore.
+ [AWS Transit Gateway](https://aws.amazon.com/transit-gateway/)connette e gestisce reti locali tramite un hub centrale. VPCs Ciò semplifica la rete e pone fine alle complesse relazioni di peering. Funziona come un router cloud, in modo che ogni nuova connessione venga effettuata una sola volta.
+ [Amazon Virtual Private Cloud (Amazon VPC)](https://docs.aws.amazon.com/vpc/latest/userguide/what-is-amazon-vpc.html) è un servizio per l'avvio di AWS risorse in una rete virtuale logicamente isolata da te definita.
+ [AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/aws-xray.html)raccoglie dati sulle richieste servite dalla tua applicazione e fornisce strumenti che puoi utilizzare per visualizzare, filtrare e ottenere informazioni su tali dati per identificare problemi e opportunità di ottimizzazione.

**Codice**

Il codice sorgente di questa soluzione è disponibile nel GitHub repository [Transit Gateway Attachment Tagger](https://github.com/aws-samples/tgw-attachment-tagger). Il repository include i seguenti file:
+ `tgw-attachment-tagger-main-stack.yaml`crea tutte le risorse per supportare questa soluzione all'interno dell'account Shared Networking.
+ `tgw-attachment-tagger-organizations-stack.yaml`****crea un ruolo nell'account di gestione dell'organizzazione.

## Epiche
<a name="tag-transit-gateway-attachments-automatically-using-aws-organizations-epics"></a>

### Implementa lo stack di soluzioni principale
<a name="deploy-the-main-solution-stack"></a>


| Operazione | Description | Competenze richieste | 
| --- | --- | --- | 
| Raccogli le informazioni necessarie sui prerequisiti. | Per configurare l'accesso tra account dalla funzione Lambda all'API, è necessario AWS Organizations l'ID account per l'account di gestione dell'organizzazione.****L'ordine in cui vengono creati i due CloudFormation stack è importante. È necessario prima distribuire le risorse nell'account di rete condivisa. Il ruolo nell'account di rete condivisa deve già esistere prima di distribuire le risorse nell'account di gestione dell'organizzazione. Per ulteriori informazioni, consulta la [documentazione relativa ad AWS](https://docs.amazonaws.cn/en_us/IAM/latest/UserGuide/id_roles_create_for-user.html). | DevOps ingegnere | 
| Avvia il CloudFormation modello per lo stack di soluzioni principale. | Il modello per lo stack di soluzioni principale implementerà i ruoli IAM, il flusso di lavoro Step Functions, le funzioni Lambda e l'evento Amazon. CloudWatch Apri l'account Console di gestione AWS for the Shared Networking, quindi apri la console: &CFN.  Crea lo stack utilizzando il `tgw-attachment-tagger-main-stack.yaml` modello e i seguenti valori:  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/tag-transit-gateway-attachments-automatically-using-aws-organizations.html)[Per ulteriori informazioni sul lancio di uno CloudFormation stack, consulta la documentazione.AWS](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html) | DevOps ingegnere | 
| Verifica che la soluzione sia stata avviata correttamente. | Attendi che lo CloudFormation stack raggiunga lo stato **CREATE\$1COMPLETE**. Questa operazione dovrebbe richiedere meno di un minuto.Apri la console Step Functions e verifica che sia stata creata una nuova macchina a stati con il nome **tgw-attachment-tagger-state-machine**. | DevOps ingegnere | 

### Implementa lo stack AWS Organizations
<a name="deploy-the-aws-organizations-stack"></a>


| Operazione | Description | Competenze richieste | 
| --- | --- | --- | 
| Raccogli le informazioni necessarie sui prerequisiti. | Per configurare l'accesso tra account dalla funzione Lambda all'API AWS Organizations, è necessario l'ID account per l'account Shared Networking. | DevOps ingegnere | 
| Avvia il CloudFormation modello per lo stack Organizations | Il modello per lo stack AWS Organizations implementerà il ruolo IAM nell'account di gestione dell'organizzazione. Accedi alla console AWS per l'account di gestione dell'organizzazione, quindi apri la CloudFormation console.  Crea lo stack utilizzando il `tgw-attachment-tagger-organizations-stack.yaml` modello e i seguenti valori:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/tag-transit-gateway-attachments-automatically-using-aws-organizations.html)Per le altre opzioni di creazione dello stack, utilizzate le impostazioni predefinite. | DevOps ingegnere | 
| Verifica che la soluzione sia stata avviata correttamente. | Attendi che lo CloudFormation stack raggiunga lo stato **CREATE\$1COMPLETE**. Questa operazione dovrebbe richiedere meno di un minuto.Apri la console AWS Identity and Access Management (IAM) e verifica che sia stato creato un nuovo ruolo con il nome **tgw-attachment-tagger-organization-query-role**. | DevOps ingegnere | 

### Verifica la soluzione
<a name="verify-the-solution"></a>


| Operazione | Description | Competenze richieste | 
| --- | --- | --- | 
| Avvia la macchina a stati. | Apri la console Step Functions per l'account Shared Networking e scegli **Macchine a stati** nel riquadro di navigazione.Seleziona la macchina a stati **tgw-attachment-tagger-state-machine** e scegli **Avvia esecuzione**.  Poiché l'input di questa macchina a stati non viene utilizzato dalla soluzione, è possibile utilizzare il valore predefinito.<pre>{<br />    "Comment": "Insert your JSON here"<br />}</pre>Selezionare **Start Execution (Avvia esecuzione)**. | DevOps ingegnere | 
| Sorveglia la macchina statale fino al completamento. | Nella nuova pagina che si apre, puoi guardare la macchina a stati funzionare. La durata dipenderà dal numero di allegati Transit Gateway da elaborare.In questa pagina è possibile esaminare ogni fase della macchina a stati. È possibile visualizzare le varie attività all'interno della macchina a stati e seguire i collegamenti ai CloudWatch registri delle funzioni Lambda. Per le attività eseguite in parallelo all'interno della mappa, puoi utilizzare l'elenco a discesa **Indice** per visualizzare le implementazioni specifiche per ogni regione. | DevOps ingegnere | 
| Verifica i tag degli allegati Transit Gateway. | Apri la console VPC per l'account Shared Networking e scegli **Transit Gateway** Attachments.  Sulla console, viene fornito un tag Name per gli allegati che soddisfano i criteri (l'allegato viene propagato a una tabella di routing Transit Gateway e il proprietario della risorsa è un membro dell'organizzazione). | DevOps ingegnere | 
| Verifica l'inizio CloudWatch dell'evento. | Attendi l'inizio CloudWatch dell'evento. L'evento è previsto per le 06:00 UTC. Quindi apri la console Step Functions per l'account Shared Networking e scegli **Macchine a stati** nel riquadro di navigazione.Seleziona la macchina a stati **tgw-attachment-tagger-state-macchina.** Verifica che la soluzione sia stata eseguita alle 06:00 UTC. | DevOps ingegnere | 

## Risorse correlate
<a name="tag-transit-gateway-attachments-automatically-using-aws-organizations-resources"></a>
+ [AWS Organizations](https://aws.amazon.com/organizations/)
+ [AWS Resource Access Manager](https://aws.amazon.com/ram/)
+ [Orchestrator di rete di transito senza server](https://aws.amazon.com/solutions/implementations/serverless-transit-network-orchestrator/)
+ [Creazione di ruoli IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html)
+ [Creazione di uno stack sulla console AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html)