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.
CodeDeploy blue/green déploiements pour Amazon ECS
Nous vous recommandons d'utiliser Amazon ECS blue/green déploiement. Pour plus d’informations, consultez Création d'un Amazon ECS blue/green déploiement.
Le blue/green le type de déploiement utilise le blue/green modèle de déploiement contrôlé par CodeDeploy. Ce type de déploiement permet de vérifier un nouveau déploiement d'un service avant d'y envoyer du trafic de production. Pour plus d'informations, voir Qu'est-ce que CodeDeploy dans le AWS CodeDeploy Guide de l'utilisateur.Validez l'état d'un service Amazon ECS avant le déploiement
Le trafic peut changer de trois manières au cours d'une blue/green déploiement :
-
Canary : le trafic est transféré en deux incréments. Vous pouvez choisir parmi les options canary prédéfinies qui définissent le pourcentage de trafic déplacé vers l'ensemble de tâches mises à jour dans le premier incrément, et l'intervalle (en minutes) avant que le trafic restant soit déplacé dans le second incrément.
-
Linéaire : le trafic est transféré en incréments égaux, avec un nombre de minutes égal entre chaque incrément. Vous pouvez choisir parmi les options linéaires prédéfinies qui définissent le pourcentage de trafic déplacé pour chaque incrément et le nombre de minutes entre chaque incrément.
-
All-at-once — Tout le trafic est transféré de l'ensemble de tâches d'origine à l'ensemble de tâches mis à jour en une seule fois.
Les éléments suivants sont des composants de CodeDeploy qu'Amazon ECS utilise lorsqu'un service utilise le blue/green type de déploiement :
- CodeDeploy application
-
Une collection de CodeDeploy ressources. Comprend un ou plusieurs groupes de déploiement.
- CodeDeploy groupe de déploiement
-
Paramètres de déploiement. Regroupe les éléments suivants :
-
Cluster et service Amazon ECS
-
Groupe cible de l’équilibreur de charge et informations sur l’écouteur
-
Stratégie de restauration du déploiement
-
Paramètres de réacheminement du trafic
-
Paramètres d’arrêt de la révision initiale
-
Configuration de déploiement
-
CloudWatch configuration des alarmes qui peut être configurée pour arrêter les déploiements
-
SNS ou CloudWatch Paramètres des événements pour les notifications
Pour de plus amples informations, veuillez consulter Utilisation des groupes de déploiement dans CodeDeploy dans le Guide de l'utilisateur AWS CodeDeploy .
-
- CodeDeploy configuration de déploiement
-
Spécifie comment CodeDeploy achemine le trafic de production vers votre ensemble de tâches de remplacement lors d'un déploiement. Les configurations de déploiement linéaire et canary prédéfinies suivantes sont disponibles. Vous pouvez également créer des déploiements canary et linéaires personnalisés. Pour obtenir de plus amples informations, consultez Utilisation des configurations de déploiement dans le Guide de l'utilisateur AWS CodeDeploy .
-
CodeDeployDefault.ECSAllAtOnce: déplace tout le trafic vers le conteneur Amazon ECS mis à jour en une seule fois
-
CodeDeployDefault.ECSLinear10PercentEvery1Minutes: déplace 10 % du trafic toutes les minutes jusqu'à ce que tout le trafic soit modifié.
-
CodeDeployDefault.ECSLinear10PercentEvery3Minutes: déplace 10 % du trafic toutes les 3 minutes jusqu'à ce que tout le trafic soit modifié.
-
CodeDeployDefault.ECSCanary10Percent5Minutes: déplace 10 % du trafic lors du premier incrément. Les 90 % restants sont déployés cinq minutes plus tard.
-
CodeDeployDefault.ECSCanary10Percent15Minutes: déplace 10 % du trafic lors du premier incrément. Les 90 % restants sont déployés 15 minutes plus tard.
-
- Révision
-
Une révision est CodeDeploy fichier de spécifications de l'application (AppSpec fichier). Dans le AppSpec fichier, vous spécifiez l'ARN complet de la définition de tâche ainsi que le conteneur et le port de votre ensemble de tâches de remplacement où le trafic doit être acheminé lors de la création d'un nouveau déploiement. Le nom du conteneur doit être un des noms de conteneur référencés dans votre définition de tâche. Si la configuration réseau ou la version de la plate-forme ont été mises à jour dans la définition du service, vous devez également spécifier ces détails dans le AppSpec dossier. Vous pouvez également spécifier les fonctions Lambda à exécuter au cours des événements de cycle de vie du déploiement. Les fonctions Lambda vous permettent d'exécuter des tests et de renvoyer des métriques pendant le déploiement. Pour plus d'informations, voir AppSpec Référence du dossier dans le AWS CodeDeploy Guide de l'utilisateur.
Considérations
Tenez compte des points suivants lorsque vous utilisez le blue/green type de déploiement :
-
Lorsqu'un service Amazon ECS utilisant le blue/green Le type de déploiement est initialement créé, un ensemble de tâches Amazon ECS est créé.
-
Vous devez configurer le service pour utiliser un équilibreur de charge Application Load Balancer ou un Network Load Balancer. Les exigences de l'équilibreur de charge sont les suivantes :
-
Vous devez ajouter un port d'écoute de production à l'équilibreur de charge, utilisé pour acheminer le trafic de production.
-
Vous pouvez également ajouter à l'équilibreur de charge un port d'écoute de test, utilisé pour acheminer le trafic de test. Si vous spécifiez un écouteur de test, CodeDeploy achemine votre trafic de test vers la tâche de remplacement définie lors d'un déploiement.
-
Les ports d'écoute de production et de test doivent appartenir au même équilibreur de charge.
-
Vous devez définir un groupe cible pour l'équilibreur de charge. Le groupe cible achemine le trafic vers la tâche initiale dans un service via le port d'écoute de production.
-
Lorsqu'un Network Load Balancer est utilisé, seule la configuration de déploiement
CodeDeployDefault.ECSAllAtOnceest prise en charge.
-
-
Pour les services configurés pour utiliser la mise à l'échelle automatique des services et blue/green type de déploiement, la mise à l'échelle automatique n'est pas bloquée pendant un déploiement, mais le déploiement peut échouer dans certaines circonstances. Ce comportement est décrit plus en détail ci-dessous.
-
Si un service évolue et qu'un déploiement démarre, l'ensemble de tâches vert est créé et CodeDeploy attendra jusqu'à une heure pour que la tâche verte atteigne un état stable et ne modifiera pas le trafic tant que ce n'est pas le cas.
-
Si un service est en cours de traitement blue/green lors du déploiement et d'un événement de dimensionnement, le trafic continuera de changer pendant 5 minutes. Si le service n'atteint pas un état stable dans les 5 minutes, CodeDeploy arrêtera le déploiement et le marquera comme ayant échoué.
-
-
Les tâches qui utilisent Fargate ou les types de contrôleur de déploiement
CODE_DEPLOYne prennent pas en charge la stratégie de planificationDAEMON. -
Lorsque vous créez pour la première fois un CodeDeploy application et groupe de déploiement, vous devez spécifier les éléments suivants :
-
Vous devez définir deux groupes cibles pour l'équilibreur de charge. L'un d'eux doit être le groupe cible initial défini pour l'équilibreur de charge lors de la création du service Amazon ECS service. La seule exigence relative au second groupe cible est qu'il ne peut pas être associé à un autre équilibreur de charge que celui utilisé par le service.
-
-
Lorsque vous créez un CodeDeploy déploiement pour un service Amazon ECS, CodeDeploy crée un ensemble de tâches de remplacement (ou ensemble de tâches vert) lors du déploiement. Si vous avez ajouté un écouteur de test à l'équilibreur de charge, CodeDeploy achemine votre trafic de test vers l'ensemble de tâches de remplacement. Cela indique le moment où vous pouvez exécuter les tests de validation. Ensuite, CodeDeploy réachemine le trafic de production depuis l'ensemble de tâches initial vers l'ensemble des tâches de remplacement en fonction des paramètres de redirection du trafic définis pour le groupe de déploiement.
Autorisations IAM requises
Blue/green les déploiements sont rendus possibles par une combinaison d'Amazon ECS et CodeDeploy API. Les utilisateurs doivent disposer des autorisations appropriées pour ces services avant de pouvoir utiliser Amazon ECS blue/green déploiements dans Console de gestion AWS ou avec AWS CLI ou des kits de développement logiciel.
En plus des autorisations IAM standard nécessaires à la création et à la mise à jour de services, Amazon ECS exige les autorisations suivantes. Ces autorisations ont été ajoutées à la politique IAM AmazonECS_FullAccess. Pour plus d’informations, consultez Amazon ECS_FullAccess.
codedeploy:CreateApplicationcodedeploy:CreateDeploymentcodedeploy:CreateDeploymentGroupcodedeploy:GetApplicationcodedeploy:GetDeploymentcodedeploy:GetDeploymentGroupcodedeploy:ListApplicationscodedeploy:ListDeploymentGroupscodedeploy:ListDeploymentscodedeploy:StopDeploymentcodedeploy:GetDeploymentTargetcodedeploy:ListDeploymentTargetscodedeploy:GetDeploymentConfigcodedeploy:GetApplicationRevisioncodedeploy:RegisterApplicationRevisioncodedeploy:BatchGetApplicationRevisionscodedeploy:BatchGetDeploymentGroupscodedeploy:BatchGetDeploymentscodedeploy:BatchGetApplicationscodedeploy:ListApplicationRevisionscodedeploy:ListDeploymentConfigscodedeploy:ContinueDeploymentsns:ListTopicscloudwatch:DescribeAlarmslambda:ListFunctions
Outre les autorisations Amazon ECS standard nécessaires pour exécuter des tâches et des services, les utilisateurs doivent également disposer d'autorisations iam:PassRole pour pouvoir utiliser les rôles IAM dans le cadre des tâches.
CodeDeploy a besoin d'autorisations pour appeler les API Amazon ECS, modifier votre Elastic Load Balancing, invoquer les fonctions Lambda et décrire CloudWatch des alarmes, ainsi que des autorisations pour modifier le nombre souhaité de votre service en votre nom. Avant de créer un service Amazon ECS qui utilise le blue/green type de déploiement, vous devez créer un rôle IAM (ecsCodeDeployRole). Pour plus d’informations, consultez Amazon ECS CodeDeploy Rôle IAM.