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 groupe de déploiement avec CodeDeploy
Vous pouvez utiliser la CodeDeploy console, le AWS CLI CodeDeploy APIs, ou un CloudFormation modèle pour créer des groupes de déploiement. Pour plus d'informations sur l'utilisation d'un CloudFormation modèle pour créer un groupe de déploiement, consultez[CloudFormation modèles de CodeDeploy référence](reference-cloudformation-templates.md).
Lorsque vous utilisez la CodeDeploy console pour créer une application, vous configurez son premier groupe de déploiement en même temps. Lorsque vous utilisez le AWS CLI pour créer une application, vous créez son premier groupe de déploiement lors d'une étape distincte.
Dans le cadre de la création d'un groupe de déploiement, vous devez spécifier un rôle de service. Pour de plus amples informations, veuillez consulter [Étape 2 : créer un rôle de service pour CodeDeploy](getting-started-create-service-role.md).
**Topics**
+ [Création d'un groupe de déploiement pour un déploiement sur place (console)](deployment-groups-create-in-place.md)
+ [Création d'un groupe de déploiement pour un blue/green déploiement EC2/sur site (console)](deployment-groups-create-blue-green.md)
+ [Création d'un groupe de déploiement pour un déploiement Amazon ECS (console)](deployment-groups-create-ecs.md)
+ [Configuration d'un équilibreur de charge dans Elastic Load Balancing pour les déploiements CodeDeploy Amazon EC2](deployment-groups-create-load-balancer.md)
+ [Configuration d'un équilibreur de charge, de groupes cibles et d'écouteurs pour les déploiements CodeDeploy Amazon ECS](deployment-groups-create-load-balancer-for-ecs.md)
+ [Création d'un groupe de déploiement (CLI)](deployment-groups-create-cli.md)
# Création d'un groupe de déploiement pour un déploiement sur place (console)
Pour utiliser la CodeDeploy console afin de créer un groupe de déploiement pour un déploiement sur place :
**Avertissement**
Ne suivez pas cette procédure si :
Vous n'avez pas préparé vos instances pour qu'elles soient utilisées dans le premier déploiement CodeDeploy d'une application. Pour configurer vos instances, suivez les instructions fournies dans la rubrique [Utilisation d'instances pour CodeDeploy](instances.md), puis suivez la procédure décrite dans cette rubrique.
Vous souhaitez créer un groupe de déploiement qui utilise une configuration de déploiement personnalisée, mais vous n'avez pas encore créé la configuration de déploiement. Suivez les instructions fournies dans la rubrique [Créez une configuration de déploiement avec CodeDeploy](deployment-configurations-create.md), puis suivez la procédure décrite dans cette rubrique.
Vous ne disposez pas d'un rôle de service qui CodeDeploy accorde, au minimum, la confiance et les autorisations décrites dans[Étape 2 : créer un rôle de service pour CodeDeploy](getting-started-create-service-role.md). Pour créer et configurer un rôle de service, suivez les instructions fournies dans la rubrique [Étape 2 : créer un rôle de service pour CodeDeploy](getting-started-create-service-role.md), puis suivez la procédure décrite dans cette rubrique.
Vous souhaitez sélectionner un Classic Load Balancer, un Application Load Balancer ou un Network Load Balancer dans Elastic Load Balancing pour le déploiement sur place, mais vous ne l'avez pas encore créé.
1. Connectez-vous à la CodeDeploy console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/codedeploy.](https://console.aws.amazon.com/codedeploy)
**Note**
Connectez-vous avec le même utilisateur que celui que vous avez configuré[Commencer avec CodeDeploy](getting-started-codedeploy.md).
1. Dans le volet de navigation, développez **Deploy**, puis choisissez **Applications**.
1. Sur la page **Applications**, choisissez le nom de l'application pour laquelle vous voulez créer un groupe de déploiement.
1. Sur la page de votre application, dans l'onglet **Groupe de déploiement**, choisissez **Créer un groupe de déploiement**.
1. Dans **Nom du groupe de déploiement**, entrez un nom décrivant le groupe de déploiement.
**Note**
Si vous souhaitez utiliser les mêmes paramètres que ceux utilisés dans un autre groupe de déploiement (y compris le nom du groupe de déploiement, les balises, les noms des groupes Amazon EC2 Auto Scaling, ou les deux, et la configuration de déploiement), spécifiez ces paramètres sur cette page. Bien que ce nouveau groupe de déploiement et le groupe de déploiement existant portent le même nom, ils CodeDeploy sont traités comme des groupes de déploiement distincts, car ils sont chacun associés à des applications distinctes.
1. Dans **Rôle de service**, choisissez un rôle de service qui accorde l'accès CodeDeploy à votre instance cible.
1. Dans **Type de déploiement**, choisissez **Sur place**.
1. Dans **Configuration de l'environnement**, procédez comme suit :
1. Si vous souhaitez déployer votre application dans un groupe Amazon EC2 Auto Scaling, **sélectionnez les groupes Amazon EC2 Auto Scaling**, puis choisissez le nom du groupe Amazon EC2 Auto Scaling dans lequel déployer la révision de votre application. Lorsque de nouvelles instances Amazon EC2 sont lancées dans le cadre d'un groupe Amazon EC2 Auto Scaling, CodeDeploy vous pouvez déployer automatiquement vos révisions sur les nouvelles instances. Vous pouvez ajouter jusqu'à 10 groupes Amazon EC2 Auto Scaling à un groupe de déploiement. Pour de plus amples informations, veuillez consulter [Intégration CodeDeploy à Amazon EC2 Auto Scaling](integrations-aws-auto-scaling.md).
1.
Si vous avez sélectionné les groupes **Amazon EC2 Auto Scaling**, **sélectionnez éventuellement Ajouter un crochet de terminaison aux groupes Auto Scaling** pour CodeDeploy installer un crochet de terminaison dans votre groupe Auto Scaling lorsque vous créez ou mettez à jour le groupe de déploiement. Lorsque ce hook est installé, il CodeDeploy effectuera des déploiements de terminaison. Pour de plus amples informations, veuillez consulter [Permettre les déploiements de terminaison lors d'événements de scale-in d'Auto Scaling](integrations-aws-auto-scaling.md#integrations-aws-auto-scaling-behaviors-hook-enable).
1. Si vous souhaitez baliser vos instances, sélectionnez les instances **Amazon EC2 ou les instances** **sur** site. Dans les champs **Clé** et **Valeur**, entrez les valeurs de la paire clé-valeur que vous avez utilisée pour étiqueter les instances. Vous pouvez baliser jusqu'à 10 paires clé-valeur dans un seul groupe de balises.
1. Vous pouvez utiliser des caractères génériques dans le champ **Valeur** pour identifier toutes les instances étiquetées selon certains modèles, tels que les noms d'instances, de centres de coûts et de groupes Amazon EC2 similaires, etc. Par exemple, si vous choisissez **Nom** dans le champ **Clé** et que vous entrez **GRP-\$1a** dans le champ **Valeur**, CodeDeploy identifie toutes les instances correspondant à ce modèle, telles que **GRP-1a****GRP-2a**, et**GRP-XYZ-a**.
1. Le champ **Valeur** est sensible à la casse.
1. Pour supprimer une paire clé-valeur de la liste, choisissez l'icône de suppression.
Lorsqu' CodeDeploy il trouve des instances correspondant à chaque paire clé-valeur spécifiée ou au nom du groupe Amazon EC2 Auto Scaling, il affiche le nombre d'instances correspondantes. Pour plus d'informations sur ces instances, cliquez sur le nombre.
Si vous souhaitez affiner les critères des instances dans lesquelles procéder au déploiement, sélectionnez **Ajouter un groupe de balises** pour créer un groupe de balises. Vous pouvez créer jusqu'à trois groupes de balises, comprenant chacun jusqu'à 10 paires clé-valeur. Lorsque vous utilisez plusieurs groupes de balises dans un groupe de déploiement, seules les instances identifiées par tous les groupes de balises sont incluses dans le groupe de déploiement. Cela signifie qu'une instance doit correspondre à au moins une des balises dans chacun des groupes pour pouvoir être incluse dans le groupe de déploiement.
Pour plus d'informations sur l'utilisation de groupes de balises pour affiner votre groupe de déploiement, consultez la rubrique [Marquage des instances pour les groupes de déploiement dans CodeDeploy](instances-tagging.md).
1. Dans **Configuration de l'agent avec Systems Manager**, spécifiez comment vous souhaitez installer et mettre à jour l' CodeDeploy agent sur les instances de votre groupe de déploiement. Pour plus d'informations sur l' CodeDeploy agent, consultez la section [Utilisation de l' CodeDeploy agent](https://docs.aws.amazon.com/en_us/codedeploy/latest/userguide/codedeploy-agent.html). Pour plus d'informations sur Systems Manager, voir [Qu'est-ce que Systems Manager ?](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html)
1. **Jamais** : ignorez la configuration de CodeDeploy l'installation avec Systems Manager. L'agent doit être installé sur les instances pour être utilisé dans les déploiements. Choisissez cette option uniquement si vous souhaitez installer l'agent CodeDeploy d'une autre manière.
1. **Une seule fois** : Systems Manager installera l' CodeDeploy agent une fois sur chaque instance de votre groupe de déploiement.
1. **Maintenant et planifiez les mises à jour** : Systems Manager créera une association avec State Manager qui installera l' CodeDeploy agent selon le calendrier que vous avez configuré. Pour de plus amples informations sur State Manager et les associations, veuillez consulter [À propos de State Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-state-about.html).
1. Dans **Configuration de déploiement**, sélectionnez une configuration de déploiement pour contrôler la vitesse à laquelle les instances sont déployées, par exemple une à la fois ou toutes à la fois. Pour plus d'informations sur les configurations de déploiement, consultez [Utilisation des configurations de déploiement dans CodeDeploy](deployment-configurations.md).
1. (Facultatif) Dans **Load Balancer**, sélectionnez **Activer l'équilibrage de charge**, puis dans les listes, sélectionnez les groupes cibles Classic Load Balancer, Application Load Balancer et Network Load Balancer pour gérer le trafic vers les instances pendant le déploiement. CodeDeploy Vous pouvez sélectionner jusqu'à 10 équilibreurs de charge classiques et 10 groupes cibles, pour un total de 20 éléments. Assurez-vous que les instances Amazon EC2 vers lesquelles vous souhaitez déployer sont enregistrées auprès des équilibreurs de charge (équilibreurs de charge classiques) ou des groupes cibles (équilibreurs de charge d'application et équilibreurs de charge réseau) sélectionnés.
Lors d'un déploiement, les instances d'origine sont désenregistrées des équilibreurs de charge et des groupes cibles sélectionnés afin d'empêcher le trafic d'être acheminé vers ces instances pendant le déploiement. Lorsque le déploiement est terminé, chaque instance est réenregistrée auprès de *tous les* équilibreurs de charge classiques et groupes cibles sélectionnés.
Pour plus d'informations sur les équilibreurs de charge pour les CodeDeploy déploiements, consultez. [Intégration CodeDeploy à Elastic Load Balancing](integrations-aws-elastic-load-balancing.md)
**Avertissement**
Si vous configurez à la fois des groupes Auto Scaling et des équilibreurs de charge Elastic Load Balancing dans ce groupe de déploiement et que vous souhaitez [associer des équilibreurs de charge aux groupes Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/attach-load-balancer-asg.html), nous vous recommandons de compléter cette pièce jointe *avant* de créer le CodeDeploy déploiement à partir de ce groupe de déploiement. Toute tentative de terminer la pièce jointe après avoir créé le déploiement peut entraîner le désenregistrement inattendu de toutes les instances des équilibreurs de charge.
1. (Facultatif) Développez **Advanced** et configurez toutes les options que vous souhaitez inclure dans le déploiement, telles que les déclencheurs de notification Amazon SNS, les CloudWatch alarmes Amazon, les options Auto Scaling ou les annulations automatiques.
Pour de plus amples informations, veuillez consulter [Configuration des options avancées d'un groupe de déploiement](deployment-groups-configure-advanced-options.md).
1. Choisissez **Créer un groupe de déploiement**.
# Création d'un groupe de déploiement pour un blue/green déploiement EC2/sur site (console)
Pour utiliser la CodeDeploy console afin de créer un groupe de déploiement pour un déploiement bleu/vert :
**Avertissement**
Ne suivez pas cette procédure si :
Vous ne disposez pas d'instances sur lesquelles l' CodeDeploy agent est installé que vous souhaitez remplacer au cours du processus de blue/green déploiement. Pour configurer vos instances, suivez les instructions fournies dans la rubrique [Utilisation d'instances pour CodeDeploy](instances.md), puis suivez la procédure décrite dans cette rubrique.
Vous souhaitez créer une application qui utilise une configuration de déploiement personnalisée, mais vous n'avez pas encore créé la configuration de déploiement. Suivez les instructions fournies dans la rubrique [Créez une configuration de déploiement avec CodeDeploy](deployment-configurations-create.md), puis suivez la procédure décrite dans cette rubrique.
Vous ne disposez pas d'un rôle de service qui CodeDeploy accorde, au minimum, la confiance et les autorisations décrites dans[Étape 2 : créer un rôle de service pour CodeDeploy](getting-started-create-service-role.md). Pour créer et configurer un rôle de service, suivez les instructions fournies dans la rubrique [Étape 2 : créer un rôle de service pour CodeDeploy](getting-started-create-service-role.md), puis suivez la procédure décrite dans cette rubrique.
Vous n'avez pas créé de Classic Load Balancer ou d'Application Load Balancer dans Elastic Load Balancing pour l'enregistrement des instances dans votre environnement de remplacement. Pour de plus amples informations, veuillez consulter [Configuration d'un équilibreur de charge dans Elastic Load Balancing pour les déploiements CodeDeploy Amazon EC2](deployment-groups-create-load-balancer.md).
1. Connectez-vous à la CodeDeploy console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/codedeploy.](https://console.aws.amazon.com/codedeploy)
**Note**
Connectez-vous avec le même utilisateur que celui que vous avez configuré[Commencer avec CodeDeploy](getting-started-codedeploy.md).
1. Dans le volet de navigation, développez **Deploy**, puis choisissez **Applications**.
1. Sur la page **Applications**, choisissez le nom de l'application pour laquelle vous voulez créer un groupe de déploiement.
1. Sur la page de votre application, dans l'onglet **Groupe de déploiement**, choisissez **Créer un groupe de déploiement**.
1. Dans **Nom du groupe de déploiement**, entrez un nom décrivant le groupe de déploiement.
**Note**
Si vous souhaitez utiliser les mêmes paramètres que ceux utilisés dans un autre groupe de déploiement (y compris le nom du groupe de déploiement, les balises, les noms des groupes Amazon EC2 Auto Scaling et la configuration de déploiement), choisissez ces paramètres sur cette page. Bien que ce nouveau groupe de déploiement et le groupe de déploiement existant aient le même nom, CodeDeploy les traite comme des groupes de déploiement distincts, car ils sont associés à des applications distinctes.
1. Dans **Rôle de service**, choisissez un rôle de service qui accorde l'accès CodeDeploy à votre instance cible.
1. Dans **Type de déploiement**, choisissez **Bleu/vert**.
1. Dans **Configuration de l'environnement**, procédez comme suit :
+ Sélectionnez la méthode à utiliser pour fournir des instances pour votre environnement de remplacement. Vous avez les options suivantes :
+ **Copier automatiquement le groupe Amazon EC2 Auto Scaling** CodeDeploy : crée un groupe Amazon EC2 Auto Scaling en copiant celui que vous spécifiez.
+ **Manually provision instances** : Vous ne spécifiez pas d'instance pour l'environnement de remplacement tant que vous n'avez pas créé de déploiement. Vous devez créer les instances avant de commencer le déploiement. Au lieu de cela, vous spécifiez ici les instances que vous souhaitez remplacer.
+ Si vous avez sélectionné **Copier automatiquement le groupe Amazon EC2 Auto Scaling**, **sélectionnez éventuellement Ajouter un crochet de terminaison aux groupes Auto Scaling** pour CodeDeploy installer un crochet de terminaison dans votre groupe Auto Scaling lorsque vous créez ou mettez à jour le groupe de déploiement. Lorsque ce hook est installé, il CodeDeploy effectuera des déploiements de terminaison. Pour de plus amples informations, veuillez consulter [Permettre les déploiements de terminaison lors d'événements de scale-in d'Auto Scaling](integrations-aws-auto-scaling.md#integrations-aws-auto-scaling-behaviors-hook-enable).
1. Dans **Configuration de l'agent avec Systems Manager**, spécifiez comment vous souhaitez installer et mettre à jour l' CodeDeploy agent sur les instances de votre groupe de déploiement. Pour plus d'informations sur l' CodeDeploy agent, consultez la section [Utilisation de l' CodeDeploy agent](https://docs.aws.amazon.com/en_us/codedeploy/latest/userguide/codedeploy-agent.html). Pour plus d'informations sur Systems Manager, voir [Qu'est-ce que Systems Manager ?](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html)
1. **Jamais** : ignorez la configuration de CodeDeploy l'installation avec Systems Manager. L'agent doit être installé sur les instances pour être utilisé dans les déploiements. Choisissez cette option uniquement si vous souhaitez installer l'agent CodeDeploy d'une autre manière.
1. **Une seule fois** : Systems Manager installera l' CodeDeploy agent une fois sur chaque instance de votre groupe de déploiement.
1. **Maintenant et planifiez les mises à jour** : Systems Manager créera une association avec State Manager qui installera l' CodeDeploy agent selon le calendrier que vous avez configuré. Pour de plus amples informations sur State Manager et les associations, veuillez consulter [À propos de State Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-state-about.html).
1. En fonction de votre choix à l'étape 8, effectuez l'une des opérations suivantes:
+ Si vous avez choisi **Copier automatiquement le groupe Amazon EC2 Auto Scaling** : **dans le groupe Amazon EC2 Auto Scaling**, choisissez ou entrez le nom du groupe Amazon EC2 Auto Scaling que vous souhaitez utiliser comme modèle pour le groupe Amazon EC2 Auto Scaling créé pour les instances de votre environnement de remplacement. Le nombre d'instances actuellement saines dans le groupe Amazon EC2 Auto Scaling que vous sélectionnez est créé dans votre environnement de remplacement.
+ Si vous avez choisi **Provisionner les instances manuellement** : sélectionnez les groupes **Amazon EC2 Auto Scaling****, les instances Amazon EC2 Auto Scaling**, ou les deux pour spécifier les instances à ajouter à ce groupe de déploiement. Entrez les valeurs des balises Amazon EC2 Auto Scaling ou les noms de groupes Amazon EC2 Auto Scaling pour identifier les instances de votre environnement d'origine (c'est-à-dire les instances que vous souhaitez remplacer ou qui exécutent la révision actuelle de l'application).
1. Dans **Load balancer**, sélectionnez **Activer l'équilibrage de charge**, puis dans les listes, sélectionnez les Classic Load Balancers, les groupes cibles Application Load Balancer et les groupes cibles Network Load Balancer auprès desquels vous souhaitez enregistrer vos instances Amazon EC2 de remplacement. Chaque instance de remplacement sera enregistrée auprès de *tous les* équilibreurs de charge classiques et groupes cibles sélectionnés. Vous pouvez sélectionner jusqu'à 10 équilibreurs de charge classiques et 10 groupes cibles, pour un total de 20 éléments.
Le trafic sera redirigé des instances d'origine vers les instances de remplacement conformément aux paramètres de **réacheminement du trafic** et de configuration de **déploiement** que vous avez choisis.
Pour plus d'informations sur les équilibreurs de charge pour les CodeDeploy déploiements, consultez. [Intégration CodeDeploy à Elastic Load Balancing](integrations-aws-elastic-load-balancing.md)
**Avertissement**
Si vous configurez à la fois des groupes Auto Scaling et des équilibreurs de charge Elastic Load Balancing dans ce groupe de déploiement, et que vous souhaitez [associer les équilibreurs de charge à des groupes Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/attach-load-balancer-asg.html), nous vous recommandons de compléter cette pièce jointe *avant* de créer le CodeDeploy déploiement à partir de ce groupe de déploiement. Toute tentative de terminer la pièce jointe après avoir créé le déploiement peut entraîner le désenregistrement inattendu de toutes les instances des équilibreurs de charge.
1. Dans **Paramètres de déploiement**, vérifiez les options par défaut pour réacheminer le trafic vers l'environnement de remplacement, quelle configuration de déploiement utiliser pour le déploiement, et comment les instances dans l'environnement d'origine sont gérées après le déploiement.
Si vous voulez modifier les paramètres, passez à l'étape suivante. Sinon, passez à l'étape 14.
1. Pour modifier les paramètres de déploiement pour le blue/green déploiement, choisissez l'un des paramètres suivants.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/codedeploy/latest/userguide/deployment-groups-create-blue-green.html)
1. (Facultatif) Dans **Advanced**, configurez les options que vous souhaitez inclure dans le déploiement, telles que les déclencheurs de notification Amazon SNS, les CloudWatch alarmes Amazon, les options Auto Scaling ou les annulations automatiques.
Pour plus d'informations sur la spécification des options avancées dans les groupes de déploiement, consultez [Configuration des options avancées d'un groupe de déploiement](deployment-groups-configure-advanced-options.md).
1. Choisissez **Créer un groupe de déploiement**.
# Création d'un groupe de déploiement pour un déploiement Amazon ECS (console)
1. Connectez-vous à la CodeDeploy console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/codedeploy.](https://console.aws.amazon.com/codedeploy)
**Note**
Connectez-vous avec le même utilisateur que celui que vous avez configuré[Commencer avec CodeDeploy](getting-started-codedeploy.md).
1. Dans le volet de navigation, développez **Deploy**, puis choisissez **Applications**.
1. Dans la **table des applications**, choisissez le nom de l'application qui est associée au groupe de déploiement que vous voulez modifier.
1. Sur la page de l'application, dans la section **Groupes de déploiement**, choisissez le nom du groupe de déploiement que vous souhaitez modifier.
1. Sur la page de votre application, dans l'onglet **Groupe de déploiement**, choisissez **Créer un groupe de déploiement**. Pour plus d'informations sur ce dont vous avez besoin pour créer un groupe de déploiement pour un déploiement Amazon ECS, consultez[Avant de commencer un déploiement Amazon ECS](deployment-steps-ecs.md#deployment-steps-prerequisites-ecs).
1. Dans **Nom du groupe de déploiement**, entrez un nom décrivant le groupe de déploiement.
**Note**
Si vous souhaitez utiliser les mêmes paramètres que ceux utilisés dans un autre groupe de déploiement (y compris le nom de groupe de déploiement et la configuration de déploiement), choisissez ces paramètres sur cette page. Bien que ce nouveau groupe et le groupe existant puissent porter le même nom, ils CodeDeploy sont traités comme des groupes de déploiement distincts, car chacun est associé à une application distincte.
1. Dans **Rôle de service**, choisissez un rôle de service qui accorde CodeDeploy l'accès à Amazon ECS. Pour de plus amples informations, veuillez consulter [Étape 2 : créer un rôle de service pour CodeDeploy](getting-started-create-service-role.md).
1. Dans **Nom de l'équilibreur de charge**, choisissez le nom de l'équilibreur de charge qui achemine le trafic vers votre service Amazon ECS.
1. Dans **Port de l'écouteur de production**, choisissez le port et le protocole de l'écouteur qui achemine le trafic de production vers votre service Amazon ECS.
1. (Facultatif) Dans **Port du récepteur de test**, choisissez le port et le protocole d'un écouteur de test qui achemine le trafic vers l'ensemble de tâches de remplacement dans votre service Amazon ECS pendant le déploiement. Vous pouvez spécifier une ou plusieurs fonctions Lambda dans le AppSpec fichier qui s'exécutent pendant le hook. `AfterAllowTestTraffic` Les fonctions peuvent exécuter des tests de validation. Si un test de validation échoue, une annulation du déploiement est déclenchée. Si les tests de validation réussissent, le hook suivant dans le cycle de vie du déploiement, `BeforeAllowTraffic`, est déclenché. Si aucun port d'écouteur de test n'est spécifié, rien ne se passe pendant le `AfterAllowTestTraffic` hook. Pour de plus amples informations, veuillez consulter [AppSpec section « hooks » pour un déploiement Amazon ECS](reference-appspec-file-structure-hooks.md#appspec-hooks-ecs).
1. Dans Nom du **groupe cible 1 et Nom** **du groupe cible 2**, choisissez les groupes cibles utilisés pour acheminer le trafic lors de votre déploiement. CodeDeploy lie un groupe cible à l'ensemble de tâches d'origine de votre service Amazon ECS et l'autre à son ensemble de tâches de remplacement. Pour plus d'informations, consultez la section [Groupes cibles pour vos équilibreurs de charge d'application](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-target-groups.html).
1. Choisissez **Réacheminer le trafic immédiatement** ou **Spécifiez quand le trafic doit être redirigé** pour déterminer à quel moment le rediriger vers votre service Amazon ECS mis à jour.
Si vous choisissez **Réacheminer le trafic immédiatement**, le déploiement redirige automatiquement le trafic une fois que l'ensemble de tâches de remplacement a été provisionné.
Si vous choisissez **Spécifier quand rediriger le trafic**, choisissez le nombre de jours, d'heures et de minutes à attendre une fois que l'ensemble de tâches de remplacement a été correctement provisionné. Pendant ce temps d'attente, les tests de validation dans les fonctions Lambda spécifiées dans le AppSpec fichier sont exécutés. Si le temps d'attente expire avant que le trafic ne soit redirigé, l'état du déploiement passe à. `Stopped`
1. Pour **la résiliation de la révision initiale**, choisissez le nombre de jours, d'heures et de minutes à attendre après un déploiement réussi avant que la tâche définie initialement dans votre service Amazon ECS ne soit interrompue.
1. (Facultatif) Dans **Avancé**, configurez les options que vous souhaitez inclure dans le déploiement, telles que les déclencheurs de notification Amazon SNS, les CloudWatch alarmes Amazon ou les annulations automatiques.
Pour de plus amples informations, veuillez consulter [Configuration des options avancées d'un groupe de déploiement](deployment-groups-configure-advanced-options.md).
# Configuration d'un équilibreur de charge dans Elastic Load Balancing pour les déploiements CodeDeploy Amazon EC2
Avant d'exécuter un blue/green déploiement, ou un déploiement sur place pour lequel vous souhaitez spécifier un équilibreur de charge facultatif dans le groupe de déploiement, vous devez avoir créé au moins un Classic Load Balancer, un Application Load Balancer ou un Network Load Balancer dans Elastic Load Balancing. Pour les blue/green déploiements, vous utilisez cet équilibreur de charge pour enregistrer les instances qui constituent votre environnement de remplacement. Les instances de votre environnement original peuvent, le cas échéant, être inscrites auprès de ce même équilibreur de charge. Pour les déploiements sur place, l'équilibreur de charge est utilisé pour désenregistrer les instances sur lesquelles ils travaillent et les réenregistrer une fois le travail terminé. CodeDeploy
CodeDeploy prend en charge blue/green et déploie sur place des instances Amazon EC2 via plusieurs équilibreurs de charge. Supposons, par exemple, que vous disposiez de 200 instances Amazon EC2, dont 100 sont enregistrées auprès de 2 équilibreurs de charge classiques et 100 autres sont enregistrées auprès de 4 groupes cibles dans 2 équilibreurs de charge d'application. Dans ce scénario, vous CodeDeploy pourrez effectuer blue/green et mettre en place des déploiements sur les 200 instances, même s'ils sont répartis entre 2 équilibreurs de charge classiques, 2 équilibreurs de charge d'application et 4 groupes cibles.
CodeDeploy prend en charge jusqu'à 10 équilibreurs de charge classiques et 10 groupes cibles, pour un total de 20 articles.
Pour configurer un ou plusieurs Classic Load Balancers, suivez les instructions de la section [Tutorial : Create a Classic Load](https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-getting-started.html) Balancer *in User Guide for Classic* Load Balancers. Notez ce qui suit :
+ Dans **Étape 2 : Définition d'un équilibreur de charge**, dans **Créer un équilibreur dans**, choisissez le même VPC que vous avez sélectionné lorsque vous avez créé les instances.
+ **Étape 5 : Inscription des instances EC2 auprès de votre équilibreur de charge**, sélectionnez les instances actuellement dans votre groupe de déploiement (déploiements sur-place) ou que vous avez sélectionnées pour être dans votre environnement d'origine (déploiements bleus/verts).
+ Dans **Étape 7 : Création et vérification de votre équilibreur de charge**, notez l'adresse DNS de l'équilibreur de charge.
Par exemple, si vous avez nommé votre équilibreur de charge `my-load-balancer`, votre adresse DNS s'affiche dans un format tel que `my-load-balancer-1234567890.us-east-2.elb.amazonaws.com`.
Pour configurer un ou plusieurs équilibreurs de charge d'application, suivez les instructions de l'une des rubriques suivantes :
+ [Création d'un Application Load Balancer](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/create-application-load-balancer.html)
+ [Tutoriel : Création d'un Application Load Balancer à l'aide du AWS CLI](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/tutorial-application-load-balancer-cli.html)
Pour configurer un ou plusieurs équilibreurs de charge réseau, suivez les instructions de l'une des rubriques suivantes :
+ [Création d'un Network Load Balancer](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/create-network-load-balancer.html)
+ [Tutoriel : Création d'un Network Load Balancer à l'aide du AWS CLI](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/network-load-balancer-cli.html)
# Configuration d'un équilibreur de charge, de groupes cibles et d'écouteurs pour les déploiements CodeDeploy Amazon ECS
Avant d'exécuter un déploiement à l'aide de la plateforme de calcul Amazon ECS, vous devez créer un Application Load Balancer ou un Network Load Balancer, deux groupes cibles et un ou deux écouteurs. Cette rubrique explique comment créer un Application Load Balancer. Pour de plus amples informations, veuillez consulter [Avant de commencer un déploiement Amazon ECS](deployment-steps-ecs.md#deployment-steps-prerequisites-ecs).
L'un des groupes cibles dirige le trafic vers l'ensemble de tâches d'origine de votre application Amazon ECS. L'autre groupe cible dirige le trafic vers son ensemble de tâches de remplacement. Au cours du déploiement, CodeDeploy crée un ensemble de tâches de remplacement et redirige le trafic de l'ensemble de tâches d'origine vers le nouveau. CodeDeploy détermine le groupe cible utilisé pour chaque ensemble de tâches.
Un écouteur est utilisé par votre équilibreur de charge pour diriger le trafic vers vos groupes cibles. Un écouteur de production est obligatoire. Vous pouvez spécifier un écouteur de test facultatif qui dirige le trafic vers votre ensemble de tâches de remplacement lors de l'exécution des tests de validation.
L'équilibreur de charge doit utiliser un VPC avec deux sous-réseaux publics dans différentes zones de disponibilité. Les étapes suivantes vous montrent comment confirmer votre VPC par défaut, créer un Amazon EC2 Application Load Balancer, puis créer deux groupes cibles pour votre équilibreur de charge. Pour plus d'informations, consultez la section [Groupes cibles pour vos équilibreurs de charge réseau](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/load-balancer-target-groups.html).
## Vérifiez votre VPC, vos sous-réseaux publics et votre groupe de sécurité par défaut
Cette rubrique explique comment créer un Amazon EC2 Application Load Balancer, deux groupes cibles et deux ports pouvant être utilisés lors d'un déploiement Amazon ECS. L'un des ports est facultatif et n'est nécessaire que si vous dirigez le trafic vers un port de test pour les tests de validation lors de votre déploiement.
1. Connectez-vous à la console Amazon VPC AWS Management Console et ouvrez-la à l'adresse. [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/)
1. Vérifiez le VPC par défaut à utiliser. Dans le volet de navigation, sélectionnez **Votre VPCs**. Notez que le VPC affiche **Oui** dans la colonne **VPC par défaut**. Il s'agit de votre VPC par défaut. Il contient les sous-réseaux par défaut que vous utilisez.
1. Choisissez **Sous-réseaux**. Notez le sous-réseau IDs de deux sous-réseaux qui indiquent **Oui** dans la colonne **Sous-réseau par défaut**. Vous les utilisez IDs lorsque vous créez votre équilibreur de charge.
1. Choisissez chaque sous-réseau, puis choisissez l'onglet **Description**. Vérifiez que les sous-réseaux que vous souhaitez utiliser sont dans des zones de disponibilité différentes.
1. Choisissez les sous-réseaux, puis choisissez l'onglet **Table de routage**. Pour vérifier que chaque sous-réseau que vous souhaitez utiliser est un sous-réseau public, vérifiez qu'une ligne comportant un lien vers une passerelle Internet est incluse dans la table de routage.
1. Connectez-vous à la console Amazon EC2 AWS Management Console et ouvrez-la à l'adresse. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)
1. Depuis le panneau de navigation, sélectionnez **Groupes de sécurité**.
1. Vérifiez que le groupe de sécurité que vous souhaitez utiliser est disponible et notez son ID de groupe (par exemple, **sg-abcd1234**). Vous l'utilisez lors de la création de votre équilibreur de charge.
## Création d'un Amazon EC2 Application Load Balancer, de deux groupes cibles et d'écouteurs (console)
Pour utiliser la console Amazon EC2 afin de créer un Amazon EC2 Application Load Balancer :
1. Connectez-vous à la console Amazon EC2 AWS Management Console et ouvrez-la à l'adresse. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)
1. Dans le volet de navigation, choisissez **Load Balancers**.
1. Sélectionnez **Create Load Balancer** (Créer un équilibreur de charge).
1. Choisissez **Équilibreur de charge d'application**, puis choisissez **Créer**.
1. Dans **Nom**, entrez le nom de votre équilibreur de charge.
1. Dans **Méthode**, choisissez **Accessible sur Internet**.
1. Dans **Type d'adresse IP**, choisissez **ipv4**.
1. (Facultatif) Configurez un deuxième port d'écoute pour votre équilibreur de charge. Vous pouvez exécuter des tests de validation de déploiement à l'aide du trafic de test qui est diffusé vers ce port.
1. Sous **Protocole de l'équilibreur de charge**, choisissez **Ajouter un écouteur**.
1. Sous **Protocole de l'équilibreur de charge** pour le deuxième écouteur, choisissez **HTTP**.
1. Sous **Port de l'équilibreur de charge**, entrez **8080**.
1. Sous **Zones de disponibilité**, dans **VPC**, choisissez le VPC par défaut, puis sélectionnez les deux sous-réseaux par défaut que vous souhaitez utiliser.
1. Choisissez **Next: Configure Security Settings** (Suivant : Configurer les paramètres de sécurité).
1. Choisissez **Next: Configure Security Groups** (Suivant : Configurer des groupes de sécurité).
1. Choisissez **Select an existing security group (Sélectionner un groupe de sécurité existant)**, choisissez le groupe de sécurité par défaut, puis notez son ID.
1. Choisissez **Next: Configure Routing** (Suivant :Configurer le routage).
1. Dans **Groupe cible**, choisissez **Nouveau groupe cible** et configurez votre premier groupe cible :
1. Dans **Nom**, entrez un nom de groupe cible (par exemple, **target-group-1**).
1. Dans **Type cible**, choisissez **IP**.
1. Dans **Protocole**, choisissez **HTTP**. Dans **Port**, entrez **80**.
1. Choisissez **Next: Register Targets** (Suivant : Enregistrer des cibles).
1. Choisissez **Suivant : Vérification**, puis **Créer**.
**Pour créer un deuxième groupe cible pour votre équilibreur de charge**
1. Une fois votre équilibreur de charge configuré, ouvrez la console Amazon EC2. Dans le volet de navigation, sélectionnez **Groupes cibles**.
1. Sélectionnez **Créer un groupe cible**.
1. Dans **Nom**, entrez un nom de groupe cible (par exemple, **target-group-2**).
1. Dans **Type cible**, choisissez **IP**.
1. Dans **Protocole**, choisissez **HTTP**. Dans **Port**, entrez **80**.
1. Dans **VPC**, choisissez le VPC par défaut.
1. Choisissez **Créer**.
**Note**
Vous devez avoir créé deux groupes cibles pour votre équilibreur de charge afin que votre déploiement Amazon ECS puisse s'exécuter. Vous utilisez l'ARN de l'un de vos groupes cibles lorsque vous créez votre service Amazon ECS. Pour plus d'informations, consultez [Étape 4 : Création d'un service Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/create-blue-green.html#create-blue-green-taskdef) dans le *guide de l'utilisateur Amazon ECS*.
## Création d'un Amazon EC2 Application Load Balancer, de deux groupes cibles et d'écouteurs (CLI)
Pour créer un Application Load Balancer à l'aide de : AWS CLI
1. Utilisez la [create-load-balancer](https://docs.aws.amazon.com/cli/latest/reference/elbv2/create-load-balancer.html)commande pour créer un Application Load Balancer. Spécifiez deux sous-réseaux qui ne se trouvent pas dans la même zone de disponibilité et un groupe de sécurité.
```
aws elbv2 create-load-balancer --name bluegreen-alb \
--subnets subnet-abcd1234 subnet-abcd5678 --security-groups sg-abcd1234 --region us-east-1
```
Les données de sortie contiennent l'Amazon Resource Name (ARN) de l'équilibreur de charge, au format suivant :
```
arn:aws:elasticloadbalancing:region:aws_account_id:loadbalancer/app/bluegreen-alb/e5ba62739c16e642
```
1. Utilisez la [create-target-group](https://docs.aws.amazon.com/cli/latest/reference/elbv2/create-target-group.html)commande pour créer votre premier groupe cible. CodeDeploy achemine le trafic de ce groupe cible vers la tâche d'origine ou la tâche de remplacement définie dans votre service.
```
aws elbv2 create-target-group --name bluegreentarget1 --protocol HTTP --port 80 \
--target-type ip --vpc-id vpc-abcd1234 --region us-east-1
```
Les données de sortie contiennent l'ARN du premier groupe cible, au format suivant :
```
arn:aws:elasticloadbalancing:region:aws_account_id:targetgroup/bluegreentarget1/209a844cd01825a4
```
1. Utilisez la [create-target-group](https://docs.aws.amazon.com/cli/latest/reference/elbv2/create-target-group.html)commande pour créer votre deuxième groupe cible. CodeDeploy achemine le trafic du groupe cible vers l'ensemble de tâches qui n'est pas desservi par votre premier groupe cible. Par exemple, si votre premier groupe cible achemine le trafic vers l'ensemble de tâches d'origine, ce groupe cible achemine le trafic vers l'ensemble de tâches de remplacement.
```
aws elbv2 create-target-group --name bluegreentarget2 --protocol HTTP --port 80 \
--target-type ip --vpc-id vpc-abcd1234 --region us-east-1
```
Les données de sortie contiennent l'ARN du deuxième groupe cible, au format suivant :
```
arn:aws:elasticloadbalancing:region:aws_account_id:targetgroup/bluegreentarget2/209a844cd01825a4
```
1. Utilisez la commande [create-listener](https://docs.aws.amazon.com/cli/latest/reference/elbv2/create-listener.html) pour créer un écouteur avec une règle par défaut qui transfère le trafic de production vers le port 80.
```
aws elbv2 create-listener --load-balancer-arn arn:aws:elasticloadbalancing:region:aws_account_id:loadbalancer/app/bluegreen-alb/e5ba62739c16e642 \
--protocol HTTP --port 80 \
--default-actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:region:aws_account_id:targetgroup/bluegreentarget1/209a844cd01825a4 --region us-east-1
```
Les données de sortie contiennent l'ARN de l'écouteur, au format suivant :
```
arn:aws:elasticloadbalancing:region:aws_account_id:listener/app/bluegreen-alb/e5ba62739c16e642/665750bec1b03bd4
```
1. (Facultatif) Utilisez la commande [create-listener](https://docs.aws.amazon.com/cli/latest/reference/elbv2/create-listener.html) pour créer un deuxième écouteur avec une règle par défaut qui transfère le trafic de test vers le port 8080. Vous pouvez exécuter des tests de validation de déploiement à l'aide du trafic de test qui est diffusé vers ce port.
```
aws elbv2 create-listener --load-balancer-arn arn:aws:elasticloadbalancing:region:aws_account_id:loadbalancer/app/bluegreen-alb/e5ba62739c16e642 \
--protocol HTTP --port 8080 \
--default-actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:region:aws_account_id:targetgroup/bluegreentarget2/209a844cd01825a4 --region us-east-1
```
Les données de sortie contiennent l'ARN de l'écouteur, au format suivant :
```
arn:aws:elasticloadbalancing:region:aws_account_id:listener/app/bluegreen-alb/e5ba62739c16e642/665750bec1b03bd4
```
# Création d'un groupe de déploiement (CLI)
Pour utiliser le AWS CLI pour créer un groupe de déploiement, appelez la [create-deployment-group](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment-group.html)commande en spécifiant :
+ Le nom de l'application. Pour afficher la liste des noms d'applications, appelez la commande [list-applications.](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-applications.html)
+ Nom pour le groupe de déploiement. Un groupe de déploiement portant ce nom est créé pour l'application spécifiée. Un groupe de déploiement ne peut être associé qu'à une seule application.
+ Informations sur les balises, les groupes de balises ou les noms de groupes Amazon EC2 Auto Scaling qui identifient les instances à inclure dans le groupe de déploiement.
+ L'identifiant Amazon Resource Name (ARN) du rôle de service qui permet d'agir CodeDeploy au nom de votre AWS compte lorsque vous interagissez avec d'autres AWS services. Pour obtenir le nom ARN du rôle de service, consultez la rubrique [Obtenez l'ARN du rôle de service (CLI)](getting-started-create-service-role.md#getting-started-get-service-role-cli). Pour plus d'informations sur les rôles de service, consultez la section [Termes et concepts relatifs aux rôles](https://docs.aws.amazon.com/IAM/latest/UserGuide/roles-toplevel.html#roles-about-termsandconcepts) dans le *Guide de l'utilisateur d'IAM*.
+ Les informations sur le type de déploiement, sur place ou bleu/vert, à associer au groupe de déploiement.
+ (Facultatif) Le nom d'une configuration de déploiement existante. Pour afficher la liste des configurations de déploiement, consultez [Consultez les détails de configuration du déploiement avec CodeDeploy](deployment-configurations-view-details.md). Si aucun nom n'est spécifié, CodeDeploy utilise une configuration de déploiement par défaut.
+ (Facultatif) Commandes permettant de créer un déclencheur qui envoie des notifications concernant les événements de déploiement et d'instance aux personnes abonnées à une rubrique Amazon Simple Notification Service. Pour de plus amples informations, veuillez consulter [Surveillance des déploiements à l'aide des notifications d'événements Amazon SNS](monitoring-sns-event-notifications.md).
+ (Facultatif) Commandes permettant d'ajouter des CloudWatch alarmes existantes au groupe de déploiement qui sont activées si une métrique spécifiée dans une alarme tombe en dessous ou dépasse un seuil défini.
+ (Facultatif) Commandes permettant à un déploiement de revenir à la dernière version correcte connue en cas d'échec du déploiement ou d'activation CloudWatch d'une alarme.
+ (Facultatif) Commandes pour un déploiement afin de générer des hooks d'événements du cycle de vie lors d'un événement de scale-in Auto Scaling. Pour de plus amples informations, veuillez consulter [Comment fonctionne Amazon EC2 Auto Scaling avec CodeDeploy](integrations-aws-auto-scaling.md#integrations-aws-auto-scaling-behaviors).
+ Pour les déploiements sur place :
+ (Facultatif) Les noms des équilibreurs de charge classiques, des équilibreurs de charge d'application ou des équilibreurs de charge réseau dans Elastic Load Balancing qui gèrent le trafic vers les instances pendant les processus de déploiement.
+ Pour les blue/green déploiements :
+ Configuration du processus blue/green de déploiement :
+ Comment les nouvelles instances dans l'environnement de remplacement sont mises en service.
+ S'il faut réacheminer immédiatement le trafic vers l'environnement de remplacement ou attendre une période donnée pour que le trafic soit réacheminé manuellement.
+ Si les instances dans l'environnement d'origine doivent être résiliées.
+ Les noms des équilibreurs de charge classiques, des équilibreurs de charge d'application ou des équilibreurs de charge réseau dans Elastic Load Balancing à utiliser pour les instances enregistrées dans l'environnement de remplacement.
**Avertissement**
Si vous configurez à la fois un groupe Auto Scaling et un équilibreur de charge Elastic Load Balancing dans votre groupe de déploiement et que vous souhaitez [associer l'équilibreur de charge au groupe Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/attach-load-balancer-asg.html), nous vous recommandons de compléter cette pièce jointe *avant* de créer le CodeDeploy déploiement à partir de ce groupe de déploiement. Toute tentative de terminer la pièce jointe après avoir créé le déploiement peut entraîner le désenregistrement inattendu de toutes les instances de l'équilibreur de charge.