Mise à jour des paramètres d’un service Amazon ECS

Indique s’il faut utiliser le rééquilibrage des zones de disponibilité pour le service.

Vous pouvez modifier ce paramètre pour les déploiements propagés.

Détails d'une stratégie de fournisseur de capacité. Vous pouvez définir un fournisseur de capacité lorsque vous créez un cluster, exécutez une tâche ou mettez à jour un service.

Lorsque vous utilisez Fargate, les fournisseurs de capacité sont FARGATE ou FARGATE_SPOT.

Lorsque vous utilisez Amazon EC2, les fournisseurs de capacité sont les groupes Amazon EC2 Auto Scaling.

Vous pouvez changer de fournisseur de capacité pour les déploiements propagés et les déploiements bleu/vert.

La liste suivante fournit les transitions valides :

Vous ne pouvez pas changer le nom du cluster.

La configuration de déploiement inclut les CloudWatch alarmes, le disjoncteur utilisé pour détecter les défaillances et la configuration requise.

La disjoncteur de circuit de déploiement détermine si un déploiement de service échoue dans le cas où le service ne parvient pas à atteindre un état stable. Si vous utilisez le disjoncteur de déploiement, le déploiement d’un service passera à un état d’échec et cessera de lancer de nouvelles tâches. Si vous utilisez l’option de restauration, lorsqu’un déploiement de service échoue, le service est restauré à la dernière version qui a été déployée avec succès.

Lorsque vous mettez à jour un service qui utilise le disjoncteur Amazon ECS, Amazon ECS crée un déploiement de service et une révision de service. Ces ressources vous permettent de consulter des informations détaillées sur l’historique des services. Pour de plus amples informations, veuillez consulter Afficher l'historique des services à l'aide des déploiements de services Amazon ECS.

Le planificateur de service utilise les paramètres de pourcentage minimum d'instances saines et de pourcentage maximal (dans la configuration de déploiement pour le service) afin de déterminer la stratégie de déploiement.

Si un service utilise le type de déploiement de mise à jour propagée (ECS), le pourcentage minimum sain représente la limite inférieure du nombre de tâches d’un service qui doivent rester dans l’état RUNNING pendant un déploiement, exprimé en pourcentage du nombre de tâches souhaité (arrondi à l’entier supérieur). Le paramètre s'applique également lorsque toutes les instances de conteneur sont dans l'DRAININGétat si le service contient des tâches utilisant EC2. Utilisez ce paramètre pour procéder au déploiement sans avoir recours à une capacité de cluster supplémentaire. Par exemple, si votre service comporte un nombre souhaité de tâches égal à quatre et un pourcentage minimum d'instances saines de 50 pour cent, le planificateur pourra arrêter deux tâches existantes afin de libérer de la capacité de cluster avant de lancer deux nouvelles tâches. Le service considère les tâches comme saines pour les services qui n’utilisent pas d’équilibreur de charge si elles sont dans l’état RUNNING. Le service considère que les tâches sont saines pour les services qui utilisent un équilibreur de charge si elles sont dans l’état RUNNING et si elles sont signalées comme saines par l’équilibreur de charge. La valeur par défaut pour le pourcentage minimum d'instances saines est 100 pour cent.

Si un service utilise le type de déploiement de mise à jour propagée (ECS), le paramètre pourcentage maximal représente une limite supérieure du nombre de tâches dans un service autorisées à avoir l’état PENDING, RUNNING ou STOPPING pendant un déploiement, en tant que pourcentage du nombre de tâches souhaité (arrondi à l’entier le plus proche). Le paramètre s'applique également lorsque toutes les instances de conteneur sont dans l'DRAININGétat si le service contient des tâches utilisant EC2. Utilisez ce paramètre pour définir la taille des lots de déploiement. Par exemple, si votre service a un nombre souhaité de quatre tâches et une valeur de pourcentage maximum de 200 pour cent, le planificateur peut lancer quatre nouvelles tâches avant d'arrêter les quatre tâches plus anciennes. Cela s'applique à condition que les ressources de cluster nécessaires à cette opération soient disponibles. La valeur par défaut pour le pourcentage maximal est 200 pour cent.

Lorsque le planificateur de service remplace une tâche pendant une mise à jour, si un équilibreur de charge est utilisé par le service, ce dernier supprime tout d'abord la tâche de l'équilibreur de charge (le cas échéant) et attend que les connexions s'épuisent. Ensuite, l'équivalent de docker stop est émis pour les conteneurs en cours d'exécution dans la tâche. Cela se traduit par un signal SIGTERM et un délai de 30 secondes, après quoi SIGKILL est envoyé et les conteneurs sont arrêtés de force. Si le conteneur gère le signal SIGTERM normalement et s'arrête dans les 30 secondes suivant sa réception, aucun signal SIGKILL n'est envoyé. Le planificateur de service lance et arrête les tâches selon les modalités définies dans vos paramètres de pourcentage minimum d'instances saines et de pourcentage maximal.

Le planificateur de services remplace également les tâches jugées défectueuses après l'échec d'une surveillance de l'état du conteneur ou du groupe cible de l'équilibreur de charge. Ce remplacement dépend des paramètres de définition du service maximumPercent et desiredCount. Si une tâche est marquée comme défectueuse, le planificateur de services lance d'abord une tâche de remplacement. Ensuite, voici ce qui se passe.

Si le paramètre maximumPercent empêche le planificateur de démarrer d'abord une tâche de remplacement, le planificateur arrête une par une les tâches défectueuses au hasard pour libérer de la capacité, puis lance une tâche de remplacement. Le processus de démarrage et d'arrêt se poursuit jusqu'à ce que toutes les tâches défectueuses soient remplacées par des tâches saines. Une fois que toutes les tâches défectueuses ont été remplacées et que seules les tâches saines sont en cours d'exécution, si le nombre total de tâches dépasse le desiredCount, les tâches saines sont arrêtées au hasard jusqu'à ce que le nombre total de tâches soit égal à desiredCount. Pour plus d'informations sur maximumPercent et desiredCount, veuillez consulter Paramètres de définition de service (langue française non garantie).

Le contrôleur de déploiement à utiliser pour le service. Il existe trois types de contrôleurs de déploiement disponibles :

Lorsque vous mettez à jour un service, vous pouvez mettre à jour le contrôleur de déploiement qu’il utilise. La liste suivante fournit les transitions valides :

Tenez compte des informations suivantes lorsque vous faites la mise à jour du contrôleur de déploiement d’un service :

Lorsque vous mettez à jour le contrôleur de déploiement pour un service utilisant CloudFormation, tenez compte des points suivants en fonction du type de migration que vous effectuez.

Le nombre d’instanciations de la tâche à placer et à maintenir en cours d’exécution dans votre service.

Si vous souhaitez arrêter temporairement votre service, définissez cette valeur sur zéro. Ensuite, lorsque vous êtes prêt à démarrer le service, mettez-le à jour avec la valeur d’origine.

Vous pouvez modifier ce paramètre pour les déploiements propagés et les déploiements bleu/vert.

Indique s’il convient d’activer les balises gérées par Amazon ECS pour les tâches dans le service.

Seules les tâches lancées après la mise à jour refléteront la mise à jour. Pour mettre à jour les balises de toutes les tâches, utilisez l’option de déploiement forcé.

Vous pouvez modifier ce paramètre pour les déploiements propagés et les déploiements bleu/vert.

Détermine si Amazon ECS Exec est utilisé.

Si vous ne souhaitez pas remplacer la valeur définie lors de la création du service, vous pouvez la définir sur null lorsque vous effectuez cette action.

Vous pouvez modifier ce paramètre pour les déploiements propagés.

Durée, en secondes, pendant laquelle le planificateur de services Amazon ECS ignore les vérifications de l'état de santé des conteneurs, d'un ELB ou d'un VPC Lattice défectueux après le premier démarrage d'une tâche. Si vous ne spécifiez pas de valeur de période de grâce pour le bilan de santé, la valeur par défaut de 0 est utilisée. Si vous n’utilisez aucune des surveillances de l’état, cela signifie que healthCheckGracePeriodSeconds n’est pas utilisé.

Si les tâches de votre service mettent du temps à démarrer et à répondre, vous pouvez spécifier une période de grâce pour la surveillance de l’état pouvant aller jusqu’à 2 147 483 647 secondes (environ 69 ans). Pendant ce temps, le planificateur du service Amazon ECS ignore le statut de la vérification de l'état. La période de grâce peut empêcher le planificateur de service de marquer les tâches comme étant non saines et de les arrêter avant qu'elles aient le temps de s'exécuter.

Vous pouvez modifier ce paramètre pour les déploiements propagés et les déploiements bleu/vert.

Vous devez utiliser un rôle lié à un service lorsque vous mettez à jour un équilibreur de charge.

Liste des objets de l'équilibreur de charge ELB. Il contient le nom de l’équilibreur de charge, le nom du conteneur et le port du conteneur pour permettre l’accès à partir de l’équilibreur de charge. Le nom du conteneur est tel qu’il apparaît dans une définition de conteneur.

Amazon ECS ne met pas automatiquement à jour les groupes de sécurité associés aux équilibreurs de charge ELB ou aux instances de conteneur Amazon ECS.

Lorsque vous ajoutez, mettez à jour ou supprimez une configuration d'équilibreur de charge, Amazon ECS démarre de nouvelles tâches avec la configuration ELB mise à jour, puis arrête les anciennes tâches lorsque les nouvelles tâches sont en cours d'exécution.

Pour les services qui utilisent des mises à jour continues, vous pouvez ajouter, mettre à jour ou supprimer des groupes cibles ELB. Vous pouvez passer d’un groupe cible unique à plusieurs groupes cibles et inversement.

Pour les services qui utilisent blue/green des déploiements, vous pouvez mettre à jour les groupes cibles ELB en utilisant CreateDeployment through. CodeDeploy Notez que les groupes cibles multiples ne sont pas pris en charge pour les blue/green déploiements. Pour de plus amples informations, consultez la section Enregistrement de plusieurs groupes cibles auprès d’un service.

Pour les services qui utilisent le contrôleur de déploiement externe, vous pouvez ajouter, mettre à jour ou supprimer des équilibreurs de charge en utilisant CreateTaskSet. Notez que les groupes cibles multiples ne sont pas pris en charge pour les déploiements externes. Pour de plus amples informations, consultez la section Enregistrement de plusieurs groupes cibles auprès d’un service.

Passez une liste vide pour supprimer les équilibreurs de charge.

Vous pouvez modifier ce paramètre pour les déploiements propagés.

La configuration réseau du service.

Vous pouvez modifier ce paramètre pour les déploiements propagés.

Un tableau d’objets de contrainte de placement des tâches permettant de mettre à jour le service à utiliser. Si aucune valeur n’est spécifiée, les contraintes de placement existantes pour le service resteront inchangées. Si cette valeur est spécifiée, elle remplace toutes les contraintes de placement existantes définies pour le service. Pour supprimer toutes les contraintes de placement existantes, spécifiez un tableau vide.

Vous pouvez spécifier un maximum de 10 contraintes par tâche. Cette limite inclut les contraintes de la définition de tâche et celles spécifiées lors de l'exécution.

Vous pouvez modifier ce paramètre pour les déploiements propagés et les déploiements bleu/vert.

Les objets de stratégie de placement permettant de mettre à jour le service à utiliser. Si aucune valeur n’est spécifiée, la stratégie de placement existante pour le service restera inchangée. Si cette valeur est spécifiée, elle remplace la stratégie de placement existante définie pour le service. Pour supprimer une stratégie de placement existante, spécifiez un objet vide.

Vous pouvez modifier ce paramètre pour les déploiements propagés et les déploiements bleu/vert.

La version de plateforme Fargate sur laquelle votre service s’exécute.

Un service utilisant une version de plateforme Linux ne peut pas être mis à jour pour utiliser une version de plateforme Windows et vice versa.

Vous pouvez modifier ce paramètre pour les déploiements propagés.

Indique si la propagation des balises à la tâche doit se faire à partir de la définition de tâche ou à partir du service. Si aucune valeur n'est spécifiée, les balises ne sont pas propagées.

Seules les tâches lancées après la mise à jour refléteront la mise à jour. Pour mettre à jour les balises sur toutes les tâches, définissez forceNewDeployment sur true afin qu’Amazon ECS démarre de nouvelles tâches avec les balises mises à jour.

Vous pouvez modifier ce paramètre pour les déploiements propagés et les déploiements bleu/vert.

La configuration pour Amazon ECS Service Connect. Ce paramètre détermine la manière dont le service se connecte aux autres services de votre application.

Vous pouvez modifier ce paramètre pour les déploiements propagés.

Vous devez utiliser un rôle lié à un service lorsque vous mettez à jour les enregistrements de service.

Les détails des enregistrements de découverte de service à attribuer à ce service. Pour de plus amples informations, veuillez consulter Découverte de service.

Lorsque vous ajoutez, mettez à jour ou supprimez la configuration des enregistrements de service, Amazon ECS lance de nouvelles tâches avec la configuration mise à jour des enregistrements de service, puis arrête les anciennes tâches lorsque les nouvelles sont en cours d’exécution.

Transmettez une liste vide pour supprimer les enregistrements de service.

Vous pouvez modifier ce paramètre pour les déploiements propagés.

La définition et révision de la tâche à utiliser pour le service.

Si vous modifiez les ports utilisés par les conteneurs d’une définition de tâche, vous devrez mettre à jour vos groupes de sécurité d’instances de conteneur afin de fonctionner avec les ports mis à jour.

Si vous mettez à jour la définition de tâche pour le service, le nom et le port de conteneur spécifiés dans la configuration de l'équilibreur de charge doivent rester dans la définition de tâche.

Le comportement d’extraction de l’image du conteneur diffère selon les options de calcul. Pour plus d’informations, consultez :

Vous pouvez modifier ce paramètre pour les déploiements propagés.

Les détails du volume qui était configuredAtLaunch. Lorsque configuredAtLaunch est défini sur true dans la définition de la tâche, ce paramètre de service configure un volume Amazon EBS pour chaque tâche du service à créer et à associer lors du déploiement. Vous pouvez configurer la taille, le type de volume, les IOPS, le débit, le snapshot et le chiffrement dans Configuration. ServiceManaged EBSVolume Le name du volume doit correspondre au name indiqué dans la définition de la tâche. S’il est défini sur null, aucun nouveau déploiement n’est déclenché. Dans le cas contraire, si cette configuration diffère de celle existante, cela déclenche un nouveau déploiement.

Vous pouvez modifier ce paramètre pour les déploiements propagés.

La configuration de VPC Lattice pour votre de service. Cela définit la manière dont votre service s'intègre à VPC Lattice pour la communication. service-to-service

Vous pouvez modifier ce paramètre pour les déploiements propagés.