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.
Créez un service qui utilise VPC Lattice
Vous pouvez utiliser le Console de gestion AWS ou le AWS CLI pour créer un service avec VPC Lattice.
Conditions préalables
Avant de commencer ce didacticiel, vérifiez que vous respectez les conditions requises suivantes :
-
La dernière version de AWS CLI est installée et configurée. Pour plus d’informations, consultez Installing the AWS Command Line Interface (Installation de).
Note
Vous pouvez utiliser des points de terminaison de service à double pile pour interagir avec Amazon ECS à partir des AWS CLI kits SDK et de l'API Amazon ECS via IPv4 et IPv6. Pour de plus amples informations, veuillez consulter Utilisation des points de terminaison à double pile Amazon ECS.
-
Les étapes décrites dans Configurer l'utilisation d'Amazon ECS sont terminées.
-
Votre utilisateur IAM dispose des autorisations requises spécifiées dans l’exemple de politique IAM Amazon ECS_ FullAccess.
Créez un service qui utilise VPC Lattice avec Console de gestion AWS
Procédez comme suit pour créer un service avec VPC Lattice à l’aide de l’ Console de gestion AWS.
Ouvrez la console à l'adresse https://console.aws.amazon.com/ecs/v2
. -
Dans la page de navigation, choisissez Clusters.
-
Sur la page Clusters, choisissez le cluster dans lequel créer le service.
-
Sous l'onglet Services choisissez Create (Créer).
Si vous n’avez jamais créé de service auparavant, suivez les étapes décrites dans Création d’un service Amazon ECS à l’aide de la console, puis poursuivez ces étapes lorsque vous atteignez la section VPC Lattice.
-
Choisissez Activer le réseau VPC en cochant le bouton.
-
Pour utiliser un rôle existant, pour Rôle d’infrastructure ECS pour Amazon ECS, choisissez-en un que vous avez déjà créé pour l’utiliser lors de la création du groupe cible VPC Lattice. Pour créer un rôle, Créer un rôle d’infrastructure ECS.
-
Choisissez le VPC.
Le VPC dépend du mode réseau que vous avez sélectionné lors de l’enregistrement de votre définition de tâche. Si vous utilisez le mode
hostounetworkavec EC2, choisissez votre VPC.Pour le mode
awsvpc, le VPC est automatiquement sélectionné en fonction du VPC que vous avez choisi sous Mise en réseau et ne peut pas être modifié. -
Sous Groupes cibles, sélectionnez le ou les groupes cibles. Vous devez choisir au moins un groupe cible et pouvez en avoir jusqu’à cinq. Sélectionnez Ajouter un groupe cible pour ajouter d’autres groupes cibles. Choisissez le Nom du port, le Protocole et le Port pour chaque groupe cible que vous avez choisi. Pour supprimer un groupe cible, sélectionnez Supprimer.
Note
-
Si vous souhaitez ajouter un groupe cible existant, vous devez utiliser l’ AWS CLI. Pour obtenir des instructions sur la façon d'ajouter des groupes cibles à l'aide de AWS CLI, voir register-targets dans la AWS Command Line Interface Référence.
-
Bien qu’un service VPC Lattice puisse avoir plusieurs groupes cibles, chaque groupe cible ne peut être ajouté qu’à un seul service.
-
Pour créer un service dans une IPv6-only configuration, choisissez des groupes cibles dont le type d'adresse IP est
IPv6.
-
-
À ce stade, vous accédez à la console VPC Lattice pour poursuivre la configuration. C’est ici que vous incluez vos nouveaux groupes cibles dans l’action par défaut de l’écouteur ou dans les règles d’un service VPC Lattice existant.
Pour plus d’informations, consultez la section Règles d’écoute pour votre service VPC Lattice.
Important
Vous devez autoriser le préfixe de règle de trafic entrant vpc-lattice à accéder à votre groupe de sécurité, sinon les tâches et la surveillance de l’état échoueront.
Créez un service qui utilise VPC Lattice avec AWS CLI
Utilisez le AWS CLI pour créer un service avec VPC Lattice. Remplacez chaque user input
placeholder par vos propres informations.
-
Créez un fichier de configuration de groupe cible. L’exemple suivant est nommé
tg-config.json{ "ipAddressType": "IPV4", "port": 443, "protocol": "HTTPS", "protocolVersion": "HTTP1", "vpcIdentifier": "vpc-f1663d9868EXAMPLE" } -
Utilisez la commande suivante pour créer un groupe cible VPC Lattice.
aws vpc-lattice create-target-group \ --name my-lattice-target-group-ip \ --type IP \ --config file://tg-config.jsonNote
Pour créer un service dans une IPv6-only configuration, créez des groupes cibles avec un type d'adresse IP de
IPv6. Pour plus d’informations, consultez la section create-target-group dans la Référence des commandes AWS CLI .Exemple de sortie :
{ "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:targetgroup/tg-0eaa4b9ab4EXAMPLE", "config": { "healthCheck": { "enabled": true, "healthCheckIntervalSeconds": 30, "healthCheckTimeoutSeconds": 5, "healthyThresholdCount": 5, "matcher": { "httpCode": "200" }, "path": "/", "protocol": "HTTPS", "protocolVersion": "HTTP1", "unhealthyThresholdCount": 2 }, "ipAddressType": "IPV4", "port": 443, "protocol": "HTTPS", "protocolVersion": "HTTP1", "vpcIdentifier": "vpc-f1663d9868EXAMPLE" }, "id": "tg-0eaa4b9ab4EXAMPLE", "name": "my-lattice-target-group-ip", "status": "CREATE_IN_PROGRESS", "type": "IP" } -
Le fichier JSON ci-dessous
ecs-service-vpc-lattice.jsonest un exemple utilisé pour associer un service Amazon ECS à un groupe cible VPC Lattice. L'portNameexemple suivant est le même que celui que vous avez défini dans lenamechamp deportMappingspropriété de votre définition de tâche.{ "serviceName": "ecs-service-vpc-lattice", "taskDefinition": "ecs-task-def", "vpcLatticeConfigurations": [ { "targetGroupArn": "arn:aws:vpc-lattice:us-west-2:123456789012:targetgroup/tg-0eaa4b9ab4EXAMPLE", "portName": "testvpclattice", "roleArn": "arn:aws:iam::123456789012:role/ecsInfrastructureRoleVpcLattice" } ], "desiredCount":5, "role": "ecsServiceRole" }Utilisez la commande suivante pour créer un service Amazon ECS et l'associer au groupe cible VPC Lattice à l'aide de l'exemple JSON précédent.
aws ecs create-service \ --clusterclusterName\ --serviceNameecs-service-vpc-lattice\ --cli-input-json file://ecs-service-vpc-lattice.json