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.
# Utilisation de groupes de déploiement dans CodeDeploy
Vous pouvez spécifier un ou plusieurs groupes de déploiement pour une CodeDeploy application. Chaque déploiement d'application utilise l'un de ses groupes de déploiement. Le groupe de déploiement contient les paramètres et les configurations utilisés lors du déploiement. La plupart des paramètres des groupes de déploiement dépendent de la plate-forme de calcul utilisée par votre application. Certains paramètres, tels que les annulations, les déclencheurs et les alarmes, peuvent être configurés pour les groupes de déploiement de n'importe quelle plate-forme informatique.
## Groupes de déploiement dans des déploiements de plateforme de calcul Amazon ECS
Dans un déploiement Amazon ECS, un groupe de déploiement spécifie le service Amazon ECS, l'équilibreur de charge, un écouteur de test facultatif et deux groupes cibles. Il indique également quand rediriger le trafic vers l'ensemble de tâches de remplacement et quand mettre fin à l'ensemble de tâches d'origine et à l'application Amazon ECS après un déploiement réussi.
## Groupes de déploiement dans les déploiements de plateformes AWS Lambda informatiques
Dans un déploiement AWS Lambda, un groupe de déploiement définit un ensemble de CodeDeploy configurations pour les futurs déploiements d'une fonction. AWS Lambda Par exemple, le groupe de déploiement indique comment acheminer le trafic vers une nouvelle version d'une fonction Lambda. Il peut également spécifier des alarmes et des restaurations. Un seul déploiement dans un groupe de déploiement AWS Lambda peut remplacer une ou plusieurs configurations de groupe.
## Groupes de déploiement dans les déploiements de plateformes de calcul EC2/sur site
Dans un déploiement EC2/sur site, un groupe de déploiement est un ensemble d'instances individuelles ciblées pour un déploiement. Un groupe de déploiement contient des instances étiquetées individuellement, des instances Amazon EC2 dans des groupes Amazon EC2 Auto Scaling, ou les deux.
Dans un déploiement sur place, les instances du groupe de déploiement sont mises à jour avec la dernière révision d'application.
Lors d'un blue/green déploiement, le trafic est redirigé d'un ensemble d'instances à un autre en annulant l'enregistrement des instances d'origine auprès d'un ou de plusieurs équilibreurs de charge et en enregistrant un ensemble d'instances de remplacement sur lequel la dernière version de l'application est généralement déjà installée.
Vous pouvez associer plusieurs groupes de déploiement à une application dans CodeDeploy. Cela permet de déployer une révision d'application vers différents ensembles d'instances à différents moments. Par exemple, vous pouvez utiliser un groupe de déploiement pour déployer une révision d'application dans un ensemble d'instances balisé `Test` dans lequel vous garantissez la qualité du code. Ensuite, vous déployez la même révision d'application vers un groupe de déploiement avec les instances balisées `Staging` pour la vérification supplémentaire. Enfin, lorsque vous êtes prêt à libérer la dernière application pour les clients, vous déployez dans un groupe de déploiement qui inclut les instances balisées `Production`.
Vous pouvez également utiliser plusieurs groupes de balises afin d'affiner encore les critères pour les instances comprises dans un groupe de déploiement. Pour plus d'informations, consultez [Marquage des instances pour les groupes de déploiement dans CodeDeploy](instances-tagging.md).
Lorsque vous utilisez la CodeDeploy console pour créer une application, vous configurez simultanément son premier groupe de déploiement. 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.
Pour consulter la liste des groupes de déploiement déjà associés à votre AWS compte, consultez[Afficher les détails du groupe de déploiement avec CodeDeploy](deployment-groups-view-details.md).
Pour plus d'informations sur les balises d'instance Amazon EC2, consultez [Utilisation des balises à l'aide de la console](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#Using_Tags_Console). Pour en savoir plus sur les instances sur site, consultez la rubrique [Utilisation d'instances locales pour CodeDeploy](instances-on-premises.md). Pour plus d'informations sur Amazon EC2 Auto Scaling, [Intégration CodeDeploy à Amazon EC2 Auto Scaling](integrations-aws-auto-scaling.md) consultez.
## Rubriques
+ [Créez un groupe de déploiement avec CodeDeploy](deployment-groups-create.md)
+ [Afficher les détails du groupe de déploiement avec CodeDeploy](deployment-groups-view-details.md)
+ [Modifiez les paramètres du groupe de déploiement avec CodeDeploy](deployment-groups-edit.md)
+ [Configuration des options avancées d'un groupe de déploiement](deployment-groups-configure-advanced-options.md)
+ [Supprimer un groupe de déploiement avec CodeDeploy](deployment-groups-delete.md)
# 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.
# Afficher les détails du groupe de déploiement avec CodeDeploy
Vous pouvez utiliser la CodeDeploy console AWS CLI, le ou le CodeDeploy APIs pour afficher les détails de tous les groupes de déploiement associés à une application.
**Topics**
+ [
## Afficher les détails du groupe de déploiement (console)
](#deployment-groups-view-details-console)
+ [
## Afficher les détails du groupe de déploiement (CLI)
](#deployment-groups-view-details-cli)
## Afficher les détails du groupe de déploiement (console)
Pour utiliser la CodeDeploy console afin de consulter les détails du groupe de déploiement, procédez comme suit :
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 associé au groupe de déploiement.
**Note**
Si aucune entrée n'est affichée, assurez-vous que la bonne région est sélectionnée. Dans la barre de navigation, dans le sélecteur de région, choisissez l'une des régions répertoriées dans [Région et Endpoints](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) dans le. *Références générales AWS* CodeDeploy n'est pris en charge que dans ces régions.
1. Pour afficher les détails sur un groupe de déploiement individuel, sur l'onglet **Groupes de déploiement**, choisissez le nom du groupe de déploiement.
## Afficher les détails du groupe de déploiement (CLI)
Pour utiliser le AWS CLI pour afficher les détails du groupe de déploiement, appelez la `get-deployment-group` commande ou la `list-deployment-groups` commande.
Pour afficher des détails sur un groupe de déploiement unique, appelez la commande [get-deployment-group](https://docs.aws.amazon.com/cli/latest/reference/deploy/get-deployment-group.html), en spécifiant :
+ Le nom de l'application associée au groupe de déploiement. Pour obtenir le nom de l'application, appelez la commande [list-applications.](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-applications.html)
+ Le nom du groupe de déploiement. Pour obtenir le nom du groupe de déploiement, appelez la commande [list-deployment-groups](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-groups.html).
Pour afficher la liste des noms des groupes de déploiement, appelez la commande [list-deployment-groups](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-groups.html), en spécifiant le nom de l'application associée aux groupes de déploiement. Pour obtenir le nom de l'application, appelez la commande [list-applications.](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-applications.html)
# Modifiez les paramètres du groupe de déploiement avec CodeDeploy
Vous pouvez utiliser la CodeDeploy console AWS CLI, le ou le CodeDeploy APIs pour modifier les paramètres d'un groupe de déploiement.
**Avertissement**
N'utilisez pas ces étapes si vous souhaitez que le groupe de déploiement utilise un groupe de déploiement not-yet-created personnalisé. Au lieu de cela, suivez les instructions de la rubrique [Créez une configuration de déploiement avec CodeDeploy](deployment-configurations-create.md), puis revenez à cette rubrique. N'utilisez pas ces étapes si vous souhaitez que le groupe de déploiement utilise un autre rôle not-yet-created de service. Le rôle de service doit CodeDeploy disposer, au minimum, des 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 avec les autorisations appropriées, suivez les instructions de l'[Étape 2 : créer un rôle de service pour CodeDeploy](getting-started-create-service-role.md), puis revenez à cette rubrique.
**Topics**
+ [
## Modifier les paramètres du groupe de déploiement (console)
](#deployment-groups-edit-console)
+ [
## Modifier les paramètres du groupe de déploiement (CLI)
](#deployment-groups-edit-cli)
## Modifier les paramètres du groupe de déploiement (console)
Pour utiliser la CodeDeploy console afin de modifier les paramètres du groupe de déploiement :
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 liste des applications, choisissez le nom de l'application qui est associée au groupe de déploiement que vous voulez modifier.
**Note**
Si aucune entrée n'est affichée, assurez-vous que la bonne région est sélectionnée. Dans la barre de navigation, dans le sélecteur de région, choisissez l'une des régions répertoriées dans [Région et Endpoints](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) dans le. *Références générales AWS* CodeDeploy est pris en charge dans ces régions uniquement.
1. Choisissez l'onglet **Groupes de déploiement**, puis choisissez le nom du groupe de déploiement que vous souhaitez modifier.
1. Sur la page **Groupe de déploiement**, choisissez **Modifier**.
1. Modifiez les options du groupe de déploiement si nécessaire.
Pour plus d'informations sur les composants de groupe de déploiement, consultez [Créez un groupe de déploiement avec CodeDeploy](deployment-groups-create.md).
1. Sélectionnez **Enregistrer les modifications**.
## Modifier les paramètres du groupe de déploiement (CLI)
Pour utiliser le AWS CLI pour modifier les paramètres du groupe de déploiement, appelez la [update-deployment-group](https://docs.aws.amazon.com/cli/latest/reference/deploy/update-deployment-group.html)commande en spécifiant :
+ Pour les déploiements EC2/sur site et Lambda AWS :
+ 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)
+ Le nom de groupe de déploiement actuel. Pour afficher la liste des noms des groupes de déploiement, appelez la commande [list-deployment-groups](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-groups.html).
+ (Facultatif) Un autre nom de groupe de déploiement.
+ (Facultatif) Un autre nom de ressource Amazon (ARN) correspondant à un 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/cross-acct-access.html) dans le *Guide de l'utilisateur d'IAM*.
+ (Facultatif) Le nom de la configuration de déploiement. 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 ce n'est pas spécifié, CodeDeploy utilise une configuration de déploiement par défaut.)
+ (Facultatif) Commandes permettant d'ajouter une ou plusieurs 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).
+ (Facultatif) Commandes permettant de créer ou de mettre à jour un déclencheur qui publie dans une rubrique d'Amazon Simple Notification Service, afin que les abonnés à cette rubrique reçoivent des notifications concernant les événements de déploiement et d'instance dans ce groupe de déploiement. Pour plus d'informations, consultez [Surveillance des déploiements à l'aide des notifications d'événements Amazon SNS](monitoring-sns-event-notifications.md).
+ Pour les déploiements EC2/sur site uniquement :
+ (Facultatif) Des balises de remplacement ou groupes de balises qui identifient de façon unique les instances à inclure dans le groupe de déploiement.
+ (Facultatif) Les noms des groupes Amazon EC2 Auto Scaling de remplacement à ajouter au groupe de déploiement.
+ Pour les déploiements Amazon ECS uniquement :
+ Le service Amazon ECS à déployer.
+ Informations sur l'équilibreur de charge, notamment l'Application Load Balancer ou le Network Load Balancer, les groupes cibles requis pour le déploiement d'Amazon ECS, ainsi que les informations relatives à la production et aux auditeurs de test facultatifs.
# Configuration des options avancées d'un groupe de déploiement
Lorsque vous créez ou mettez à jour un groupe de déploiement, vous pouvez configurer un certain nombre d'options pour fournir plus de contrôle et de surveillance sur les déploiements pour ce groupe de déploiement.
Utilisez les informations sur cette page pour vous aider à configurer des options avancées lorsque vous employez des groupes de déploiement dans les rubriques suivantes :
+ [Créez une application avec CodeDeploy](applications-create.md)
+ [Créez un groupe de déploiement avec CodeDeploy](deployment-groups-create.md)
+ [Modifiez les paramètres du groupe de déploiement avec CodeDeploy](deployment-groups-edit.md)
**Déclencheurs de notification Amazon SNS** : vous pouvez ajouter des déclencheurs à un groupe de CodeDeploy déploiement pour recevoir des notifications concernant les événements liés aux déploiements dans ce groupe de déploiement. Ces notifications sont envoyées aux destinataires abonnés à une rubrique Amazon SNS que vous avez intégrée à l'action du déclencheur.
Vous devez déjà avoir configuré la rubrique Amazon SNS vers laquelle ce déclencheur pointera, et vous CodeDeploy devez être autorisé à publier sur cette rubrique à partir de ce groupe de déploiement. Si vous n'avez pas encore terminé ces étapes de configuration, vous pouvez ajouter ultérieurement des déclencheurs au groupe de déploiement.
Si vous souhaitez créer un déclencheur pour recevoir des notifications sur les événements de déploiement et d'instance dans le groupe de déploiement pour cette application, choisissez **Create trigger**.
Si votre déploiement concerne une instance Amazon EC2, vous pouvez créer des notifications pour les instances et en recevoir à leur sujet.
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).
** CloudWatch Alarmes Amazon** : vous pouvez créer une CloudWatch alarme qui surveille une seule métrique sur une période que vous spécifiez et exécute une ou plusieurs actions en fonction de la valeur de la métrique par rapport à un seuil donné sur un certain nombre de périodes. Pour un déploiement Amazon EC2, vous pouvez créer une alarme pour une instance ou un groupe Amazon EC2 Auto Scaling que vous utilisez dans le cadre de vos opérations. CodeDeploy Pour un déploiement AWS Lambda et Amazon ECS, vous pouvez créer une alarme en cas d'erreur dans une fonction Lambda.
Vous pouvez configurer un déploiement pour qu'il s'arrête lorsqu'une CloudWatch alarme Amazon détecte qu'une métrique est tombée en dessous ou dépasse un seuil défini.
Vous devez déjà avoir créé l'alarme CloudWatch avant de pouvoir l'ajouter à un groupe de déploiement.
1. Pour ajouter la surveillance d'alarmes au groupe de déploiement, dans **Alarmes**, choisissez **Ajouter une alarme**.
1. Entrez le nom d'une CloudWatch alarme que vous avez déjà configurée pour surveiller ce déploiement.
Vous devez saisir l' CloudWatch alarme exactement telle qu'elle a été créée CloudWatch. Pour afficher la liste des alarmes, ouvrez la CloudWatch console à l'adresse[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/), puis choisissez **ALARM**.
Options supplémentaires :
+ Si vous souhaitez que les déploiements continuent sans tenir compte des alarmes vous avez ajoutées, choisissez **Ignore alarm configuration**.
Ce choix s'avère utile lorsque vous voulez désactiver temporairement la surveillance des alarmes d'un groupe de déploiement sans devoir ajouter des mêmes alarmes plus tard.
+ (Facultatif) Si vous souhaitez que les déploiements se poursuivent en cas d'impossibilité de récupérer l'état de l'alarme auprès d'Amazon CloudWatch, choisissez **Poursuivre les déploiements même si le statut de l'alarme n'est** pas disponible. CodeDeploy
**Note**
Cette option correspond **ignorePollAlarmFailure** à l'[AlarmConfiguration](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_AlarmConfiguration.html)objet de l' CodeDeploy API.
Pour de plus amples informations, veuillez consulter [Surveillance des déploiements avec des CloudWatch alarmes dans CodeDeploy](monitoring-create-alarms.md).
**Automatic rollbacks** : Vous pouvez configurer un groupe de déploiement ou un déploiement pour être restauré automatiquement lorsqu'un déploiement échoue, ou lorsqu'un seuil de surveillance que vous spécifiez est atteint. Dans ce cas, la dernière version correcte connue d'une révision de l'application est déployée. Vous pouvez configurer des paramètres facultatifs pour un groupe de déploiement lorsque vous utilisez la console pour créer une application, créer un groupe de déploiement ou mettre à jour un groupe de déploiement. Lorsque vous créez un nouveau déploiement, vous pouvez également choisir de remplacer la configuration de la restauration automatique qui a été spécifiée pour le groupe de déploiement.
+ Vous pouvez activer la restauration par les déploiements de la plus récente révision correcte connue en cas de problème en choisissant l'un et/ou l'autre des éléments suivants :
+ **Rétrogradez en cas d'échec d'un déploiement**. CodeDeploy redéploiera la dernière bonne révision connue en tant que nouveau déploiement.
+ **Roll back when alarm thresholds are met**. Si vous avez ajouté une alarme à cette application à l'étape précédente, la dernière version correcte connue CodeDeploy sera redéployée lorsqu'une ou plusieurs des alarmes spécifiées seront activées.
**Note**
Pour ignorer temporairement une configuration de restauration, choisissez **Disable rollbacks**. Ce choix s'avère utile lorsque vous voulez désactiver temporairement des restaurations automatiques sans avoir besoin de mettre en place la même configuration ultérieurement.
Pour de plus amples informations, veuillez consulter [Redéployez et annulez un déploiement avec CodeDeploy](deployments-rollback-and-redeploy.md).
**Mises à jour automatiques des instances obsolètes** : dans certaines circonstances, vous CodeDeploy pouvez déployer une version obsolète de votre application sur vos instances Amazon EC2. Par exemple, si vos instances EC2 sont lancées dans un groupe Auto Scaling (ASG) alors qu'un CodeDeploy déploiement est en cours, ces instances reçoivent l'ancienne version de votre application au lieu de la dernière. Pour mettre ces instances à jour, lance CodeDeploy automatiquement un déploiement de suivi (immédiatement après le premier) afin de mettre à jour les instances obsolètes. Si vous souhaitez modifier ce comportement par défaut afin de conserver les instances EC2 obsolètes dans l'ancienne version, vous pouvez le faire via l' CodeDeploy API ou la AWS Command Line Interface (CLI).
Pour configurer les mises à jour automatiques des instances obsolètes via l'API, incluez le paramètre de `outdatedInstancesStrategy` requête dans l'`CreateDeploymentGroup`action `UpdateDeploymentGroup` ou. Pour plus de détails, consultez la *référence de AWS CodeDeploy l'API*.
Pour configurer les mises à jour automatiques via le AWS CLI, utilisez l'une des commandes suivantes :
`aws deploy update-deployment-group arguments --outdated-instances-strategy UPDATE|IGNORE`
Ou...
`aws deploy create-deployment-group arguments --outdated-instances-strategy UPDATE|IGNORE`
... où *arguments* est remplacé par les arguments requis pour votre déploiement, et *UPDATE\$1IGNORE* est remplacé par soit pour activer les mises `UPDATE` à jour automatiques, soit `IGNORE` pour les désactiver.
Exemple :
`aws deploy update-deployment-group --application-name "MyApp" --current-deployment-group-name "MyDG" --region us-east-1 --outdated-instances-strategy IGNORE`
Pour plus de détails sur ces AWS CLI commandes, consultez la *référence des AWS CLI commandes*.
# Supprimer un groupe de déploiement avec CodeDeploy
Vous pouvez utiliser la CodeDeploy console AWS CLI, le ou le CodeDeploy APIs pour supprimer les groupes de déploiement associés à votre AWS compte.
**Avertissement**
Si vous supprimez un groupe de déploiement, tous les détails associés à ce groupe de déploiement seront également supprimés CodeDeploy. Les instances utilisées dans le groupe de déploiement restent inchangées. Cette action ne peut pas être annulée.
**Topics**
+ [
## Supprimer un groupe de déploiement (console)
](#deployment-groups-delete-console)
+ [
## Supprimer un groupe de déploiement (CLI)
](#deployment-groups-delete-cli)
## Supprimer un groupe de déploiement (console)
Pour utiliser la CodeDeploy console afin de supprimer un groupe de déploiement :
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 liste des applications, choisissez le nom de l'application associée au groupe de déploiement.
1. Sur la page **Détails de l'application**, sur l'onglet **Groupes de déploiement**, choisissez le nom du groupe de déploiement que vous souhaitez supprimer.
1. Sur la page **Détails du déploiement**, choisissez **Supprimer**.
1. A l'invite, tapez le nom du groupe de déploiement pour confirmer que vous souhaitez le supprimer, puis choisissez **Supprimer**.
## Supprimer un groupe de déploiement (CLI)
AWS CLI Pour supprimer un groupe de déploiement, appelez la [delete-deployment-group](https://docs.aws.amazon.com/cli/latest/reference/deploy/delete-deployment-group.html)commande en spécifiant :
+ Le nom de l'application associée au groupe de déploiement. 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)
+ Le nom du groupe de déploiement associé à l'application. Pour afficher la liste des noms des groupes de déploiement, appelez la commande [list-deployment-groups](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-groups.html).