Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Passerelle Amazon ECS
Amazon ECS Gateway simplifie la mise en réseau d'entrée pour les applications conteneurisées. Il provisionne et gère automatiquement l'infrastructure qui achemine le trafic vers vos services Amazon Elastic Container Service (Amazon ECS). Au lieu de configurer des équilibreurs de charge d'applications, des auditeurs, des groupes cibles, des groupes de sécurité et des certificats pour chaque service, vous définissez les paramètres d'entrée une fois sur une passerelle et vous partagez cette infrastructure entre de nombreux services.
Vous créez une passerelle avec la configuration réseau de votre choix et vous l'associez à un ou plusieurs clusters Amazon ECS. Chaque service opte ensuite en ajoutant un paramètre de connecteur de passerelle. Amazon ECS provisionne et gère ensuite l'infrastructure d'entrée de votre AWS compte, en attribuant à chaque service connecté un nom d'hôte HTTPS unique.
Pour commencer, consultez [Création et gestion d'une passerelle](gateway-managing.md). Pour connecter un service à une passerelle qui existe déjà, voir [Connectez les services à une passerelle](gateway-connect-service.md).
## Comment fonctionne Amazon ECS Gateway
Amazon ECS Gateway sépare la gestion de l'infrastructure du déploiement des applications. Il prend en charge deux personnages principaux :
+ **Les équipes de la plateforme** possédez la passerelle. Ils créent et configurent des passerelles et les associent aux clusters Amazon ECS. La configuration d'une passerelle s'applique à tous les services qui y sont connectés et inclut des paramètres relatifs au réseau, à la sécurité et aux opérations :
+ **Réseautage**, par exemple si les services sont accessibles depuis Internet ou uniquement depuis l'intérieur du VPC, et quels sous-réseaux les équilibreurs de charge utilisent
+ **Sûreté**, par exemple quel groupe de sécurité contrôle le trafic entrant et quel AWS WAF L'ACL Web s'applique
+ **Opérations**, tels que l'emplacement des journaux d'accès, la capacité de l'équilibreur de charge à autoriser et l'en-tête de requête qui identifie le trafic de test lors des déploiements progressifs.
Vous ne pouvez pas modifier plusieurs de ces paramètres après avoir créé la passerelle. Pour plus d’informations, consultez [Personnalisation d'une passerelle](gateway-managing.md#gateway-customize).
+ **Équipes de candidature** intégrer leurs services à une passerelle en ajoutant un paramètre de connecteur de passerelle lors de la création ou de la mise à jour d'un service. Le connecteur nomme le port de conteneur qui reçoit le trafic et peut également définir un filtre de type d'accès et des contrôles de santé.
La configuration de l'entrée via une passerelle se fait en trois étapes :
1. **Créez une passerelle.** L'équipe de la plateforme crée une passerelle et définit sa configuration d'entrée, y compris les paramètres réseau et de sécurité.
1. **Associez la passerelle à des clusters.** L'équipe de la plateforme associe la passerelle à un ou plusieurs clusters Amazon ECS, ce qui la met à la disposition des services de ces clusters.
1. **Connectez les services.** Chaque service s'inscrit individuellement. Une équipe d'application ajoute un connecteur de passerelle lorsqu'elle crée ou met à jour un service, en nommant le port de conteneur qui reçoit le trafic.
Amazon ECS ne fournit aucune infrastructure tant que le premier service n'est pas connecté. Il crée ou réutilise ensuite les ressources partagées, crée les ressources par service et crée une route de passerelle qui dirige le trafic vers le service via une URL HTTPS unique.
## Avantages d'Amazon ECS Gateway
Les passerelles simplifient la configuration et la gestion des équilibreurs de charge d'applications pour vos applications. Amazon ECS Gateway offre les avantages suivants :
+ **Configuration centralisée.** Les équipes de la plateforme définissent les paramètres de réseau, de sécurité et de gestion du trafic une seule fois, et chaque service qui se connecte à la passerelle en hérite sur les clusters. Les équipes d'applications accèdent à leurs services sans configurer elles-mêmes de ressources ni avoir besoin d'expertise en matière de réseau.
+ **Gestion automatisée de l'infrastructure.** Amazon ECS fournit et gère les équilibreurs de charge des applications, les auditeurs, les groupes cibles, les groupes de sécurité, les certificats et les noms d'hôte DNS lorsque les services optent pour une passerelle.
+ **Optimisation des coûts.** Partagez les équilibreurs de charge des applications entre plusieurs services en utilisant la même configuration réseau afin de réduire les coûts.
+ **Infrastructure transparente.** Amazon ECS crée toutes les ressources de votre AWS compte, où vous pouvez les consulter et les gérer à l'aide du Console de gestion AWS et le AWS API.
## Concepts clés
Le tableau suivant décrit les concepts que vous utilisez lorsque vous utilisez Amazon ECS Gateway.
| Concept | Description |
| --- | --- |
| Passerelle | Ressource au niveau du compte, dotée de son propre ARN, qui définit la configuration d'entrée et gère l'infrastructure sous-jacente pour les services qui y sont connectés. Les noms de passerelles sont uniques au sein d'un compte et d'une région. |
| Gateway-cluster association | Lien entre une passerelle et un cluster qui met la passerelle à la disposition des services de ce cluster. Les associations sont multiples : une passerelle peut desservir plusieurs clusters et un cluster peut utiliser plusieurs passerelles. Pour plus d’informations, consultez [Limites du service Gateway](#gateway-service-quotas). |
| Connecteur Gateway | Paramètre d'activation d'un service qui le connecte à toutes les passerelles compatibles associées à son cluster. Le connecteur spécifie le nom du port de conteneur à exposer et inclut des paramètres facultatifs de type d'accès et de contrôle de santé. |
| Route de la passerelle | Ressource dotée de son propre ARN qui représente une connexion entre un service et une passerelle. Amazon ECS crée un itinéraire lorsque le service se connecte et le supprime lorsque le service se déconnecte. L'itinéraire indique l'état de la connexion, l'URL du service et les ressources sous-jacentes spécifiques au service. |
## Infrastructure gérée par Amazon ECS Gateway
Amazon ECS fournit deux catégories d'infrastructures d'entrée sur votre compte.
| Type de ressource | Ressources gérées | Description |
| --- | --- | --- |
| Infrastructure partagée | Équilibreur de charge des applications, écouteur d'équilibrage de charge, groupe de sécurité de l'équilibreur de charge | Ressources qu'une passerelle gère et partage entre plusieurs services Amazon ECS. |
| Service-specific infrastructure | AWS Certificate Manager certificat, nom d'hôte DNS, règle d'écoute, groupe cible, groupe de sécurité du service | Ressources créées par Amazon ECS pour chaque route de passerelle afin de diriger le trafic vers le service correspondant. |
Amazon ECS utilise le routage basé sur l'hôte pour diriger les demandes provenant d'un équilibreur de charge d'application partagé vers le service approprié. Chaque service reçoit un nom d'hôte généré sous la forme `https://.ecs..on.aws`. Le domaine varie selon AWS cloison.
Une passerelle ne fournit rien lorsque vous la créez ou que vous l'associez à un cluster. Lorsque le premier service se connecte, Amazon ECS provisionne le premier équilibreur de charge, son écouteur et son groupe de sécurité, puis ajoute les ressources propres à ce service. Au fur et à mesure que de plus en plus de services se connectent, Amazon ECS réutilise un équilibreur de charge doté de capacités, ou en met en service un autre. Jusqu'à 25 services partagent un même équilibreur de charge d'application, et chaque service possède son propre nom d'hôte, son propre certificat et ses propres règles d'écoute.
Amazon ECS étiquette les ressources qu'il gère `AmazonECSManaged=true` et avec la balise système `aws:ecs:gateway-arn`, dont la valeur est l'ARN de la passerelle. Le groupe cible, les règles d'écoute et le groupe de sécurité des services qu'Amazon ECS crée pour chaque route de passerelle comportent également `aws:ecs:gateway-route-arn`. Utilisez ces balises pour rechercher les ressources dans Elastic Load Balancing, Amazon EC2 et AWS Certificate Manager consoles.
## Tarification
L'utilisation d'Amazon ECS Gateway est gratuite. Vous ne payez que pour le sous-jacent AWS les ressources mises en service sur votre compte lorsque les services se connectent à une passerelle, y compris l'Application Load Balancer applicable, Amazon CloudWatch les journaux et les statistiques, ainsi que les frais de transfert de données.
## Disponibilité
Amazon ECS Gateway est disponible dans toutes les versions commerciales AWS Régions. Il prend en charge les services Amazon ECS qui utilisent le `awsvpc` mode réseau, sur tous les types de lancement : Amazon EC2, Fargate et Amazon ECS Managed Instances. Vous pouvez créer et gérer des passerelles à l'aide de la console Amazon ECS, AWS CLI, le AWS SDK, et CloudFormation.
## Limites du service Gateway
Le tableau suivant répertorie les quotas de service pour Amazon ECS Gateway.
| Limite | Value |
| --- | --- |
| Max Gateway-Cluster Associations par cluster | 5 |
| Nombre maximum de clusters par passerelle | 10 000 |
| Nombre maximum de connecteurs de passerelle par service | 1 |
| Équilibreur de charge maximum de services par application | 25 |
| Équilibreurs de charge d'application maximum par passerelle | 200 |
Le sous-jacent AWS les ressources sont également soumises à leurs propres quotas de service. Reportez-vous à [Quotas pour les équilibreurs de charge de vos applications](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-limits.html).
## Considérations
Consultez les points suivants avant d'adopter Amazon ECS Gateway.
**Une passerelle sert `HTTPS` trafic uniquement.** Une passerelle utilise des équilibreurs de charge d'applications avec un routage basé sur l'hôte. Elle dessert donc les applications Web et les API adressées par nom d'hôte. L'auditeur utilise uniquement le `HTTPS` protocole sur le port 443. Aucun autre protocole n'est pris en charge.
**Un service doit utiliser le `awsvpc` mode réseau.** Un service qui utilise le `bridge`, `host`, ou `none` le mode réseau ne peut pas se connecter à une passerelle.
**Une passerelle fonctionne au sein d'un seul compte.** Une passerelle et ses clusters doivent se trouver dans le même environnement AWS compte. Vous ne pouvez pas associer une passerelle à un cluster d'un autre compte.
**Une passerelle ne fonctionne pas avec les services du mode Express.** Il propose uniquement les services Amazon ECS.
**Un service possède un connecteur de passerelle.** Vous ne pouvez pas ajouter de second connecteur à un service. Un connecteur peut toujours connecter le service à plusieurs passerelles.
**Un service ne peut pas choisir une passerelle par son nom.** Un connecteur connecte le service à chaque passerelle compatible associée à son cluster. Une passerelle est compatible lorsqu'elle correspond au filtre de type d'accès si le service en définit un, dans le même VPC que le service, et couvre chaque zone de disponibilité dans laquelle le service s'exécute. Amazon ECS exclut toutes les passerelles qui ne correspondent pas, et la demande échoue lorsqu'aucune passerelle compatible ne répond aux trois conditions dans le cluster. Pour plus d’informations, consultez [Comment Amazon ECS sélectionne les passerelles compatibles](gateway-connect-service.md#gateway-select-compatible).
**Certains paramètres de passerelle sont immuables après leur création.** Vous ne pouvez pas modifier le nom, le type, le schéma, le port d'écoute, le protocole d'écoute, les sous-réseaux ou le type d'adresse IP d'une passerelle après l'avoir créée. Pour modifier l'un de ces éléments, créez une nouvelle passerelle et transférez-y les services. Pour plus d’informations, consultez [Mettre à jour une passerelle](gateway-managing.md#gateway-update).
**Amazon ECS ne consolide pas les équilibreurs de charge.** Une passerelle ajoute des équilibreurs de charge lorsque ceux existants sont pleins et les supprime lorsqu'ils sont vides. Il ne déplace pas les services entre les équilibreurs de charge, de sorte que plusieurs équilibreurs de charge partiellement remplis peuvent rester en place une fois les services interrompus.
**Amazon ECS ne répare pas les modifications apportées en dehors de celui-ci.** Si vous modifiez ou supprimez une ressource gérée par une passerelle, Amazon ECS ne la restaure pas. Le trafic vers les services concernés peut s'arrêter et les déploiements de services ultérieurs, les mises à jour de passerelles et les opérations de nettoyage peuvent échouer. Pour plus d’informations, consultez [Modifications apportées en dehors d'Amazon ECS](gateway-troubleshooting.md#gateway-changes-outside-ecs).