

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

# Gateway Amazon ECS
<a name="gateway-overview"></a>

Amazon ECS Gateway semplifica il networking in ingresso per le applicazioni containerizzate. Fornisce e gestisce automaticamente l'infrastruttura che indirizza il traffico verso i tuoi servizi Amazon Elastic Container Service (Amazon ECS). Invece di configurare Application Load Balancer, listener, gruppi target, gruppi di sicurezza e certificati per ogni servizio, puoi definire le impostazioni di ingresso una sola volta su un gateway e condividere l'infrastruttura tra più servizi.

Crei un gateway con la configurazione di rete desiderata e lo associ a uno o più cluster Amazon ECS. Ogni servizio viene quindi attivato aggiungendo un parametro del connettore gateway. Amazon ECS effettua quindi il provisioning e gestisce l'infrastruttura di ingresso nel tuo AWS account, assegnando a ciascun servizio connesso un nome host HTTPS univoco.

Per iniziare, consulta [Crea e gestisci un gateway](gateway-managing.md). Per connettere un servizio a un gateway già esistente, vedi [Connetti i servizi a un gateway](gateway-connect-service.md).

## Come funziona Amazon ECS Gateway
<a name="gateway-how-it-works"></a>

Amazon ECS Gateway separa la gestione dell'infrastruttura dalla distribuzione delle applicazioni. Supporta due persone principali:
+ **Team della piattaforma** possiedono il gateway. Creano e configurano i gateway e li associano ai cluster Amazon ECS. La configurazione di un gateway si applica a tutti i servizi ad esso connessi e include impostazioni relative a rete, sicurezza e operazioni:
  + **Rete**, ad esempio se i servizi sono raggiungibili da Internet o solo dall'interno del VPC e quali sottoreti utilizzano i sistemi di bilanciamento del carico
  + **Sicurezza**, ad esempio quale gruppo di sicurezza controlla il traffico in entrata e quale AWS WAF si applica l'ACL web
  + **Operazioni**, ad esempio dove vanno i log di accesso, quanta capacità di bilanciamento del carico consentire e quale intestazione della richiesta identifica il traffico di test durante le implementazioni progressive.

  Non è possibile modificare alcune di queste impostazioni dopo aver creato il gateway. Per ulteriori informazioni, consulta [Personalizzazione di un gateway](gateway-managing.md#gateway-customize).
+ **Team applicativi** inseriscono i propri servizi in un gateway aggiungendo un parametro del connettore gateway quando creano o aggiornano un servizio. Il connettore nomina la porta del container che riceve il traffico e può anche impostare un filtro del tipo di accesso e controlli sullo stato di integrità.

La configurazione dell'ingresso tramite un gateway richiede tre passaggi:

1. **Crea un gateway.** Il team della piattaforma crea un gateway e ne definisce la configurazione di ingresso, comprese le impostazioni di rete e di sicurezza.

1. **Associa il gateway ai cluster.** Il team della piattaforma associa il gateway a uno o più cluster Amazon ECS, rendendolo disponibile per i servizi di tali cluster.

1. **Connetti i servizi.** Ogni servizio è abilitato individualmente. Un team applicativo aggiunge un connettore gateway quando crea o aggiorna un servizio, nominando la porta del contenitore che riceve il traffico.

Amazon ECS non fornisce alcuna infrastruttura finché il primo servizio non si connette. Quindi crea o riutilizza le risorse condivise, crea le risorse per servizio e crea un gateway route che indirizza il traffico verso il servizio tramite un URL HTTPS univoco.

## Vantaggi di Amazon ECS Gateway
<a name="gateway-benefits"></a>

I gateway semplificano la configurazione e la gestione degli Application Load Balancer per le tue applicazioni. Amazon ECS Gateway offre i seguenti vantaggi:
+ **Configurazione centralizzata.** I team della piattaforma definiscono le impostazioni di rete, sicurezza e gestione del traffico una sola volta e ogni servizio che si connette al gateway le eredita tra i cluster. I team applicativi possono accedere ai propri servizi senza dover configurare autonomamente le risorse o richiedere competenze di rete.
+ **Gestione automatizzata dell'infrastruttura.** Amazon ECS effettua il provisioning e gestisce gli Application Load Balancer, i listener, i gruppi target, i gruppi di sicurezza, i certificati e i nomi host DNS quando i servizi accettano un gateway.
+ **Ottimizzazione dei costi.** Condividi gli Application Load Balancer tra più servizi utilizzando la stessa configurazione di rete per ridurre i costi.
+ **Infrastruttura trasparente.** Amazon ECS crea tutte le risorse nel tuo AWS account, dove puoi visualizzarli e gestirli con Console di gestione AWS e il AWS API.

## Concetti chiave
<a name="gateway-key-concepts"></a>

La tabella seguente descrive i concetti con cui lavori quando usi Amazon ECS Gateway.


| Concetto | Description | 
| --- | --- | 
| portale | Una risorsa a livello di account, con un proprio ARN, che definisce la configurazione di ingresso e gestisce l'infrastruttura sottostante per i servizi ad essa connessi. I nomi dei gateway sono univoci all'interno di un account e di una regione. | 
| Gateway-cluster associazione | Un collegamento tra un gateway e un cluster che rende il gateway disponibile per i servizi in quel cluster. Le associazioni sono molti-a-molti: un gateway può servire più cluster e un cluster può utilizzare più gateway. Per ulteriori informazioni, consulta [Limiti del servizio Gateway](#gateway-service-quotas). | 
| Connettore gateway | Un parametro di opt-in su un servizio che lo connette a tutti i gateway compatibili associati al relativo cluster. Il connettore specifica il nome della porta del contenitore da esporre e include il tipo di accesso opzionale e le impostazioni di controllo dello stato. | 
| Percorso del gateway | Una risorsa con un proprio ARN che rappresenta una connessione tra un servizio e un gateway. Amazon ECS crea un percorso quando il servizio si connette e lo elimina quando il servizio si disconnette. Il percorso riporta lo stato della connessione, l'URL del servizio e le risorse specifiche del servizio sottostante. | 

## Infrastruttura gestita da Amazon ECS Gateway
<a name="gateway-managed-infrastructure"></a>

Amazon ECS fornisce due categorie di infrastrutture di ingresso nel tuo account.


| Tipo di risorsa | Risorse gestite | Description | 
| --- | --- | --- | 
| Infrastruttura condivisa | Application Load Balancer, listener del load balancer, gruppo di sicurezza Load Balancer | Risorse che un gateway gestisce e condivide tra più servizi Amazon ECS. | 
| Service-specific infrastruttura | AWS Certificate Manager certificato, nome host DNS, regola del listener, gruppo target, gruppo di sicurezza del servizio | Risorse che Amazon ECS crea per ciascuna route del gateway per indirizzare il traffico verso il servizio corrispondente. | 

Amazon ECS utilizza il routing basato su host per indirizzare le richieste da un Application Load Balancer condiviso al servizio appropriato. Ogni servizio riceve un nome host generato nel modulo `https://<unique-id>.ecs.<region>.on.aws`. Il dominio varia in base AWS partizione.

Un gateway non fornisce nulla quando lo si crea o lo si associa a un cluster. Quando il primo servizio si connette, Amazon ECS esegue il provisioning del primo load balancer, del relativo listener e del relativo gruppo di sicurezza, quindi aggiunge le risorse proprie del servizio. Man mano che più servizi si connettono, Amazon ECS riutilizza un sistema di bilanciamento del carico dotato di capacità o ne esegue il provisioning di un altro. Fino a 25 servizi condividono un Application Load Balancer e ogni servizio ha le proprie regole di hostname, certificato e listener.

Amazon ECS etichetta le risorse con cui gestisce `AmazonECSManaged=true` e con il tag di sistema `aws:ecs:gateway-arn`, il cui valore è l'ARN del gateway. Sono inoltre indicati il gruppo target, le regole del listener e il gruppo di sicurezza del servizio che Amazon ECS crea per ogni percorso del gateway `aws:ecs:gateway-route-arn`. Usa questi tag per trovare le risorse in Elastic Load Balancing, Amazon EC2 e AWS Certificate Manager console.

## Prezzi
<a name="gateway-pricing"></a>

Non sono previsti costi aggiuntivi per l'utilizzo di Amazon ECS Gateway. Paghi solo il prezzo sottostante AWS risorse assegnate al tuo account quando i servizi si connettono a un gateway, incluso l'Application Load Balancer applicabile, Amazon CloudWatch registri e metriche e costi di trasferimento dei dati.

## Disponibilità
<a name="gateway-availability"></a>

Amazon ECS Gateway è disponibile in tutte le versioni commerciali AWS Regioni. Supporta i servizi Amazon ECS che utilizzano `awsvpc` modalità di rete, su tutti i tipi di avvio: Amazon ECS EC2, Fargate e Amazon ECS Managed Instances. Puoi creare e gestire i gateway utilizzando la console Amazon ECS, AWS CLI, il AWS SDK e CloudFormation.

## Limiti del servizio Gateway
<a name="gateway-service-quotas"></a>

La tabella seguente elenca le quote di servizio per Amazon ECS Gateway.


| Limite | Valore | 
| --- | --- | 
| Max Gateway-Cluster Associazioni per cluster | 5 | 
| Numero massimo di cluster per gateway | 10.000 | 
| Numero massimo di connettori gateway per servizio | 1 | 
| Numero massimo di servizi per applicazione Load Balancer | 25 | 
| Numero massimo di sistemi di bilanciamento del carico delle applicazioni per gateway | 200 | 

Il sottostante AWS le risorse sono inoltre soggette alle proprie quote di servizio. Fare riferimento a [Quote per i vostri Application Load Balancer](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-limits.html).

## Considerazioni
<a name="gateway-considerations"></a>

Verifica quanto segue prima di adottare Amazon ECS Gateway.

**Un gateway serve `HTTPS` solo traffico.** Un gateway utilizza Application Load Balancer con routing basato su host, quindi serve applicazioni Web e API indirizzate tramite nome host. L'ascoltatore utilizza solo `HTTPS` protocollo sulla porta 443. Nessun altro protocollo è supportato.

**Un servizio deve utilizzare `awsvpc` modalità di rete.** Un servizio che utilizza `bridge`, `host`, o `none` la modalità di rete non può connettersi a un gateway.

**Un gateway funziona all'interno di un singolo account.** Un gateway e i relativi cluster devono trovarsi nello stesso AWS account. Non è possibile associare un gateway a un cluster in un altro account.

**Un gateway non funziona con i servizi Express Mode.** Serve solo i servizi Amazon ECS.

**Un servizio dispone di un connettore gateway.** Non è possibile aggiungere un secondo connettore a un servizio. Un connettore può comunque connettere il servizio a diversi gateway.

**Un servizio non può scegliere un gateway in base al nome.** Un connettore connette il servizio a tutti i gateway compatibili associati al relativo cluster. Un gateway è compatibile quando corrisponde al filtro del tipo di accesso, se il servizio ne imposta uno, nello stesso VPC del servizio e copre tutte le zone di disponibilità in cui viene eseguito il servizio. Amazon ECS esclude tutti i gateway che non corrispondono e la richiesta ha esito negativo quando nel cluster non è presente alcun gateway compatibile che soddisfi tutte e tre le condizioni. Per ulteriori informazioni, consulta [In che modo Amazon ECS seleziona i gateway compatibili](gateway-connect-service.md#gateway-select-compatible).

**Alcune impostazioni del gateway sono immutabili dopo la creazione.** Non è possibile modificare il nome, il tipo, lo schema, la porta del listener, il protocollo del listener, le sottoreti o il tipo di indirizzo IP di un gateway dopo averlo creato. Per modificare uno di questi elementi, create un nuovo gateway e trasferiteci i servizi. Per ulteriori informazioni, consulta [Aggiornare un gateway](gateway-managing.md#gateway-update).

**Amazon ECS non consolida i sistemi di bilanciamento del carico.** Un gateway aggiunge sistemi di bilanciamento del carico quando quelli esistenti sono pieni e li rimuove quando sono vuoti. Non sposta i servizi tra i sistemi di bilanciamento del carico, quindi diversi sistemi di bilanciamento del carico parzialmente riempiti possono rimanere dopo la cessazione dei servizi.

**Amazon ECS non ripara le modifiche apportate al di fuori di esso.** Se modifichi o elimini una risorsa gestita da un gateway, Amazon ECS non la ripristina. Il traffico verso i servizi interessati può interrompersi e le successive implementazioni dei servizi, gli aggiornamenti del gateway e le operazioni di pulizia possono fallire. Per ulteriori informazioni, consulta [Modifiche apportate all'esterno di Amazon ECS](gateway-troubleshooting.md#gateway-changes-outside-ecs).