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](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html) (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](dual-stack-endpoint.md).
+ Les étapes décrites dans [Configurer l'utilisation d'Amazon ECS](get-set-up-for-amazon-ecs.md) sont terminées.
+ Votre utilisateur IAM dispose des autorisations requises spécifiées dans l’exemple de politique IAM [Amazon ECS\_ FullAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonECS_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.
1. Ouvrez la console à l'adresse [ https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).
1. Dans la page de navigation, choisissez **Clusters**.
1. Sur la page **Clusters**, choisissez le cluster dans lequel créer le service.
1. 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](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/create-service-console-v2.html), puis poursuivez ces étapes lorsque vous atteignez la section VPC Lattice.
1. Choisissez **Activer le réseau VPC** en cochant le bouton.
1. 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**.
1. 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 `host` ou `network` avec 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é.
1. 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 ](https://docs.aws.amazon.com/cli/latest/reference/vpc-lattice/register-targets.html) 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`.
1. À 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](https://docs.aws.amazon.com/vpc-lattice/latest/ug/listener-rules.html).
**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.
1. 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}}"
}
```
1. 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.json}}
```
**Note**
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](https://docs.aws.amazon.com/cli/latest/reference/vpc-lattice/create-target-group.html) 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"
}
```
1. Le fichier JSON ci-dessous {{ecs-service-vpc-lattice.json}} est un exemple utilisé pour associer un service Amazon ECS à un groupe cible VPC Lattice. L'`portName`exemple suivant est le même que celui que vous avez défini dans le `name` champ de `portMappings` proprié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 \
--cluster {{clusterName}} \
--serviceName {{ecs-service-vpc-lattice}} \
--cli-input-json file://{{ecs-service-vpc-lattice.json}}
```