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.
Mettre à jour un service Amazon ECS
Après avoir créé un service, il peut arriver que vous deviez mettre à jour les paramètres du service, par exemple le nombre de tâches.
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.
Prérequis
Avant de mettre à jour un service, vérifiez quels paramètres de service peuvent être modifiés pour votre type de déploiement. Pour obtenir une liste complète de paramètres modifiables, consultez la section Mise à jour des paramètres d’un service Amazon ECS.
Procédure
- Console
-
Ouvrez la console à la https://console.aws.amazon.com/ecs/version 2
. -
Sur la page Clusters, choisissez le cluster.
-
Sur la page des détails du cluster, dans la section Services, cochez la case à côté du service, puis choisissez Mettre à jour.
-
Pour que votre service démarre un nouveau déploiement, sélectionnez Force new deployment (Forcer un nouveau déploiement).
-
Pour Définition de tâche, choisissez la famille et la révision de définition de tâche.
Important
La console vérifie que la famille et la révision de définition de tâche sélectionnées sont compatibles avec la configuration de calcul définie. Si vous recevez un avertissement, vérifiez la compatibilité de votre définition de tâche et la configuration de calcul que vous avez sélectionnée.
-
Si vous choisissez Replica pour Desired tasks (Tâches souhaitées), saisissez le nombre de tâches à lancer et à conserver dans le service.
-
Si vous avez choisi Replica, pour qu’Amazon ECS surveille la répartition des tâches entre les zones de disponibilité et les redistribue en cas de déséquilibre, sous Rééquilibrage des services entre zones de disponibilité, sélectionnez Rééquilibrage des services entre zones de disponibilité.
-
Pour Min running tasks (Minimum de tâches en cours d'exécution), saisissez la limite inférieure pour le nombre de tâches du service qui doivent rester à l'état
RUNNINGlors d'un déploiement, en tant que pourcentage de nombre souhaité de tâches (arrondi au nombre entier supérieur le plus proche). Pour plus d'informations, consultez Deployment configuration (Configuration de déploiement). -
Pour Max running tasks (Maximum de tâches en cours d'exécution), saisissez la limite supérieure pour le nombre de tâches du service qui peuvent rester à l'état
RUNNINGouPENDINGlors d'un déploiement, en tant que pourcentage de nombre souhaité de tâches (arrondi au nombre entier inférieur le plus proche). -
Pour configurer la manière dont les tâches sont déployées pour votre service, développez Options de déploiement, puis configurez vos options.
-
Pour Type de contrôleur de déploiement, spécifiez le contrôleur de déploiement de service. La console Amazon ECS prend en charge les types de contrôleurs suivants :
ECS. -
Pour Stratégie de déploiement, choisissez la stratégie utilisée par Amazon ECS pour déployer les nouvelles versions du service.
-
Selon la Stratégie de déploiement choisie, procédez comme suit :
Stratégie de déploiement Étapes Mise à jour continue
-
Pour Pourcentage minimal de tâches en cours d’exécution, spécifiez une valeur minimale en pourcentage du nombre de tâches qui doivent être exécutées pendant le déploiement d’un service. Pour de plus amples informations, veuillez consulter Déployez les services Amazon ECS en remplaçant les tâches.
-
Pour Pourcentage maximal de tâches en cours d’exécution, spécifiez une valeur maximale en pourcentage du nombre de tâches qui peuvent être exécutées pendant le déploiement d’un service. Pour de plus amples informations, veuillez consulter Déployez les services Amazon ECS en remplaçant les tâches.
Bleu/vert
Pour Durée de l’intégration, spécifiez une durée, en minutes, pendant laquelle les révisions de service bleues et vertes doivent être exécutées simultanément. Pour de plus amples informations, veuillez consulter blue/green Déploiements Amazon ECS.
-
Pour exécuter des fonctions Lambda pour une étape du cycle de vie, sous Hooks de cycle de vie du déploiement, procédez comme suit pour chaque fonction Lambda unique :
Choisissez Ajouter.
Répétez l’opération pour chaque fonction que vous souhaitez exécuter.
Pour Fonction Lambda, saisissez le nom de la fonction.
Pour Rôle, choisissez le rôle que vous avez créé dans les prérequis avec les blue/green autorisations.
Pour de plus amples informations, veuillez consulter Autorisations requises pour les fonctions Lambda dans les déploiements Amazon ECS blue/green .
Pour Étapes du cycle de vie, sélectionnez les étapes exécutées par la fonction Lambda.
(Facultatif) Pour Détails du hook, saisissez une paire clé-valeur fournissant des informations sur le hook.
-
-
Pour configurer la manière dont Amazon ECS détecte et gère les échecs de déploiement, développez Deployment failure detection (Détection des échecs de déploiement), puis choisissez vos options.
-
Pour arrêter un déploiement lorsque les tâches ne peuvent pas démarrer, sélectionnez Use the Amazon ECS deployment circuit breaker (Utiliser le disjoncteur de déploiement Amazon ECS).
Pour que le logiciel restaure automatiquement le dernier état de déploiement terminé lorsque le disjoncteur de déploiement définit le déploiement comme ayant échoué, sélectionnez Restauration en cas d’échec.
-
Pour arrêter un déploiement en fonction des métriques de l'application, sélectionnez Utiliser une ou plusieurs CloudWatch alarmes. Ensuite, à partir du nom de l'CloudWatch alarme, choisissez les alarmes. Pour créer une nouvelle alarme, rendez-vous sur la CloudWatch console.
Pour que le logiciel annule automatiquement le déploiement au dernier état de déploiement terminé lorsqu'une CloudWatch alarme indique que le déploiement a échoué, sélectionnez Annulation en cas d'échec.
-
-
Pour modifier les options de calcul, développez Configuration du calcul, puis procédez comme suit :
-
Pour les services sur AWS Fargate, pour la version de la plateforme, choisissez la nouvelle version.
-
Pour les services qui utilisent une stratégie de fournisseur de capacité, pour Stratégie de fournisseur de capacité, procédez comme suit :
-
Pour ajouter un fournisseur de capacité supplémentaire, choisissez Ajouter plus. Ensuite, pour Fournisseur de capacité, choisissez le fournisseur de capacité.
-
Pour supprimer un fournisseur de capacité, à droite du fournisseur de capacité, choisissez Supprimer.
Un service qui utilise un fournisseur de capacité de groupe Amazon EC2 Auto Scaling ne peut pas être mis à jour pour utiliser un fournisseur de capacité Fargate. Un service qui utilise un fournisseur de capacité Fargate ne peut pas être mis à jour pour utiliser un fournisseur de capacité du groupe Amazon EC2 Auto Scaling.
-
-
-
(Facultatif) Pour configurer le service Amazon EC2 Auto Scaling, développez Service auto scaling, puis spécifiez les paramètres suivants. Pour utiliser Predicte Auto Scaling, qui examine les données de charge passées issues des flux de trafic, configurez-le après avoir créé le service. Pour de plus amples informations, veuillez consulter Utilisez des modèles historiques pour faire évoluer les services Amazon ECS grâce à une mise à l'échelle prédictive.
-
Pour utiliser la mise à l'échelle automatique du service, sélectionnez Service Auto Scaling (mise à l'échelle automatique du service).
-
Pour Nombre minimum de tâches, saisissez la limite inférieure du nombre de tâches à utiliser pour l’autoscaling du service. Le nombre souhaité ne sera pas inférieur à ce nombre.
-
Pour Nombre maximal de tâches, saisissez la limite supérieure du nombre de tâches à utiliser par l’autoscaling du service. Le nombre souhaité ne sera pas supérieur à ce nombre.
-
Choisissez le type de stratégie. Sous Type de stratégie de mise à l’échelle, choisissez l’une des options suivantes.
Pour utiliser ce type de stratégie Faites ceci Suivi des cibles
-
Pour Scaling policy type (Type de politique de mise à l'échelle), choisissez Target tracking (Suivi de cible).
-
Pour Policy name (Nom de la politique), saisissez un nom de politique.
-
Pour Métrique de service ECS, sélectionnez l'une des métriques suivantes.
-
ECSServiceMoyenne CPUUtilization : utilisation moyenne du processeur par le service.
-
ECSServiceAverageMemoryUtilization— Utilisation moyenne de la mémoire du service.
-
ALBRequestCountPerTarget— Nombre de demandes traitées par cible dans un groupe cible d'Application Load Balancer.
-
-
PourTarget value (Valeur cible), entrez la valeur conservée par le service pour la métrique sélectionnée.
-
Pour Temps de stabilisation de la montée en puissance, saisissez la durée, en secondes, devant s’écouler entre la fin d’une activité d’augmentation horizontale et le début d’une autre.
-
Pour Temps de stabilisation de la mise à l’échelle horizontale, saisissez la durée, en secondes, devant s’écouler entre la fin d’une activité de réduction horizontale et le début d’une autre.
-
Pour empêcher la politique d'effectuer une activité de mise à l'échelle horizontale, sélectionnez Turn off scale-in (Désactiver la mise à l'échelle horizontale).
-
• (Facultatif) Sélectionnez Désactiver la mise à l’échelle horizontale si vous souhaitez que votre stratégie de mise à l’échelle augmente horizontalement en cas de hausse du trafic, mais ne doive pas réduire horizontalement lorsque le trafic diminue
Mise à l'échelle par étapes -
Pour Scaling policy type (Type de politique de mise à l'échelle), choisissez Mise à l'échelle par étapes.
-
Pour Nom de la stratégie, saisissez un nom de stratégie.
-
Pour Alarm name (Nom de l'alarme), entrez un nom unique pour l'alarme.
-
Pour Métrique de service Amazon ECS, sélectionnez la métrique à utiliser pour l'alarme.
-
Pour Statistique, choisissez la statistique d'alarme.
-
Pour Période, choisissez la période de l'alarme.
-
Pour Condition d'alarme, choisissez comment comparer la métrique sélectionnée au seuil défini.
-
Pour Seuil de comparaison des métriques et Période d'évaluation pour déclencher l'alarme, saisissez le seuil utilisé pour l'alarme et la durée d'évaluation du seuil.
-
Sous Actions de mise à l'échelle, procédez comme suit :
-
Pour Action, sélectionnez si vous souhaitez ajouter, supprimer ou définir un nombre spécifique souhaité pour votre service.
-
Si vous avez choisi d’ajouter ou de supprimer des tâches, pour Valeur, saisissez le nombre de tâches (ou le pourcentage de tâches existantes) à ajouter ou à soustraire lors du lancement de l’action de mise à l’échelle. Si vous avez choisi de spécifier le nombre souhaité, saisissez le nombre de tâches. Pour Type, indiquez si la Valeur est un entier ou un pourcentage du nombre souhaité existant.
-
Pour Limite inférieure et Limite supérieure, saisissez les limites inférieure et supérieure de votre ajustement de mise à l'échelle par étapes. Par défaut, la limite inférieure pour l’ajout d’une politique est le seuil de l’alarme et la limite supérieure est l’infini positif (+). Par défaut, la limite supérieure pour la suppression d’une politique est le seuil de l’alarme et la limite inférieure est l’infini négatif (-).
-
(Facultatif) Ajoutez des options de mise à l'échelle supplémentaires. Choisissez Ajouter une nouvelle action de mise à l’échelle, puis répétez les étapes de l’Action de mise à l’échelle.
-
Pour Temps de stabilisation, saisissez la durée, en secondes, à attendre avant qu’une activité de mise à l’échelle précédente ne prenne effet. Pour une stratégie d’ajout, il s’agit du délai après une activité d’augmentation horizontale pendant lequel la stratégie de mise à l’échelle bloque les activités de réduction horizontale et limite le nombre de tâches pouvant augmenter horizontalement simultanément. Pour une politique de suppression, il s’agit du délai qui doit s’écouler après une activité de réduction horizontale avant qu’une autre activité de réduction puisse commencer.
-
-
-
-
(Facultatif) Pour utiliser Service Connect, sélectionnez Turn on Service Connect (Activer Service Connect), puis spécifiez les informations suivantes :
-
Sous Service Connect configuration (Configuration de Service Connect), spécifiez le mode client.
-
Si votre service exécute une application client réseau qui doit uniquement se connecter à d’autres services de l’espace de noms, sélectionnez Côté client uniquement.
-
Si votre service exécute une application réseau ou un service Web et doit fournir des points de terminaison pour ce service, et se connecte à d'autres services dans l'espace de noms, choisissez Client and server (Client et serveur).
-
-
Pour utiliser un espace de noms qui n'est pas l'espace de noms de cluster par défaut, dans Namespace (Espace de noms), choisissez l'espace de noms du service. Il peut s'agir d'un espace de noms créé séparément dans le même espace Région AWS dans votre région Compte AWS ou d'un espace de noms dans la même région qui est partagé avec votre compte en utilisant AWS Resource Access Manager ()AWS RAM. Pour plus d'informations sur les espaces de AWS Cloud Map noms partagés, voir Partage d'espaces de AWS Cloud Map noms entre comptes dans le guide du développeur AWS Cloud Map
-
(Facultatif) Spécifiez une configuration de journal. Sélectionnez Utiliser la collecte de journaux. L'option par défaut envoie les journaux du conteneur à CloudWatch Logs. Les autres options du pilote de journal sont configurées à l'aide de AWS FireLens. Pour de plus amples informations, veuillez consulter Envoyer les journaux Amazon ECS à un AWS service ou AWS Partner.
Voici une description plus détaillée de chaque destination de journal de conteneur.
-
Amazon CloudWatch — Configurez la tâche pour envoyer les journaux des conteneurs à CloudWatch Logs. Les options du pilote de journal par défaut sont fournies, ce qui permet de créer un groupe de CloudWatch journaux en votre nom. Pour spécifier un autre nom de groupe de journaux, modifiez les valeurs des options de pilote.
-
Amazon Data Firehose : configurez la tâche pour envoyer des journaux de conteneur à Firehose. Les options par défaut du pilote de journalisation sont fournies. Elles envoient les journaux vers un flux de livraison Firehose. Pour spécifier un autre nom de flux de diffusion, modifiez les valeurs des options de pilote.
-
Amazon Kinesis Data Streams : configurez la tâche pour envoyer des journaux de conteneur à Kinesis Data Streams. Les options par défaut du pilote de journalisation sont fournies. Elles permettent d’envoyer les journaux vers un flux Kinesis Data Streams. Pour spécifier un autre nom de flux, modifiez les valeurs des options de pilote.
-
Amazon OpenSearch Service — Configurez la tâche pour envoyer les journaux des conteneurs vers un domaine OpenSearch de service. Les options de pilote de journal doivent être fournies.
-
Simple Storage Service (Amazon S3) : configurez la tâche pour envoyer des journaux de conteneur à un compartiment Simple Storage Service (Amazon S3). Les options de pilote de journal par défaut sont fournies, mais vous devez spécifier un nom de compartiment Simple Storage Service (Amazon S3) valide.
-
Pour activer les journaux d'accès, procédez comme suit :
-
Développez la configuration du journal d'accès. Pour Format, choisissez JSON ou
TEXT. Pour inclure les paramètres de requête dans les journaux d'accès, sélectionnez Inclure les paramètres de requête.
Note
Pour désactiver les journaux d'accès, dans Format, sélectionnez Aucun.
-
-
-
Si votre tâche utilise un volume de données compatible avec la configuration lors du déploiement, vous pouvez configurer le volume en développant Volume.
Le nom et le type de volume sont configurés lorsque vous créez une révision de définition de tâche et ne peuvent pas être modifiés lorsque vous mettez à jour un service. Pour mettre à jour le nom et le type du volume, vous devez créer une révision de définition de tâche et mettre à jour un service à l’aide de la nouvelle révision.
Pour configurer ce type de volume Faites ceci Amazon EBS
-
Pour Type de volume EBS, choisissez le type de volume EBS que vous souhaitez attacher à votre tâche.
-
Pour Taille (Gio), saisissez une valeur valide pour la taille du volume en gibioctets (Gio). Vous pouvez spécifier une taille de volume minimale de 1 Gio et maximale de 16 384 Gio. Cette valeur est obligatoire sauf si vous fournissez un ID d’instantané.
-
Pour les IOPS, entrez le nombre maximum d' input/output opérations (IOPS) que le volume doit fournir. Cette valeur n’est configurable que pour les types de volume
io1,io2etgp3. -
Pour Débit (Mib/s), entrez le débit que le volume doit fournir, en mégaoctets par seconde (ou Mib/s). MiBps Cette valeur n’est configurable que pour le type de volume
gp3. -
Pour ID d’instantané, choisissez un instantané de volume Amazon EBS existant ou saisissez l’ARN d’un instantané si vous souhaitez créer un volume à partir d’un instantané. Vous pouvez également créer un volume vide en ne choisissant ni ne saisissant aucun ID d’instantané.
-
Si vous spécifiez un ID d’instantané, vous pouvez spécifier un taux d’initialisation du volume (Mbits/s). Saisissez une valeur comprise entre 100 et 300 Miops, qui déterminera la vitesse de chargement des données à partir de l’instantané spécifié à l’aide de l’ID d’instantané pour la création du volume.
-
Pour Type de système de fichiers, choisissez le type de système de fichiers qui sera utilisé pour le stockage et la récupération des données sur le volume. Vous pouvez choisir le système d’exploitation par défaut ou un type de système de fichiers spécifique. La valeur par défaut pour Linux est
XFS. Pour les volumes créés à partir d'un instantané, vous devez spécifier le même type de système de fichiers que celui utilisé par le volume lors de la création de l'instantané. Si le type de système de fichiers ne correspond pas, la tâche ne démarrera pas. -
Pour Rôle d’infrastructure, choisissez un rôle IAM doté des autorisations nécessaires pour permettre à Amazon ECS de gérer les volumes Amazon EBS pour les tâches. Vous pouvez associer la politique gérée
AmazonECSInfrastructureRolePolicyForVolumesau rôle, ou vous pouvez utiliser la politique comme guide pour créer et associer votre propre politique avec des autorisations répondant à vos besoins spécifiques. Pour plus d’informations sur les autorisations nécessaires, consultez Rôle IAM dans l'infrastructure Amazon ECS. -
Pour Chiffrement, sélectionnez Par défaut si vous souhaitez utiliser le chiffrement Amazon EBS par défaut. Si le chiffrement est configuré par défaut sur votre compte, le volume sera chiffré avec la clé AWS Key Management Service (AWS KMS) spécifiée dans le paramètre. Si vous choisissez Par défaut et que le chiffrement par défaut d’Amazon EBS n’est pas activé, le volume ne sera pas chiffré.
Si vous choisissez Personnalisé, vous pouvez spécifier celui AWS KMS key de votre choix pour le chiffrement du volume.
Si vous choisissez Aucun, le volume ne sera pas chiffré, sauf si le chiffrement par défaut est configuré ou si vous créez un volume à partir d’un instantané chiffré.
-
Si vous avez choisi Personnalisé pour le chiffrement, vous devez spécifier celui AWS KMS key que vous souhaitez utiliser. Pour la clé KMS, choisissez une AWS KMS key ou saisissez un ARN. Si vous choisissez de chiffrer votre volume à l'aide d'une clé symétrique gérée par le client, assurez-vous que vous disposez des autorisations appropriées définies dans votre AWS KMS key politique. Pour plus d’informations, consultez la section Chiffrement des données pour les volumes Amazon EBS.
-
(Facultatif) Sous Balises, vous pouvez ajouter des balises à votre volume Amazon EBS soit en propageant des balises à partir de la définition de la tâche ou du service, soit en fournissant vos propres balises.
Si vous souhaitez propager des balises à partir de la définition de tâche, choisissez Définition de tâche pour Propager des balises à partir de. Si vous souhaitez propager des balises depuis le service, choisissez Service pour Propager des balises à partir de. Si vous choisissez Ne pas propager ou si vous ne choisissez aucune valeur, les balises ne sont pas propagées.
Si vous souhaitez fournir vos propres balises, choisissez Ajouter une balise, puis indiquez la clé et la valeur pour chaque balise que vous ajoutez.
Pour plus d’informations sur la création d’es volumes Amazon EBS, consultez la section Étiquetage d’un volume Amazon EBS.
-
-
(Facultatif) Pour vous aider à identifier votre service, développez Tags (Balises), puis configurez vos balises.
-
[Ajouter une balise] Choisissez Ajouter une balise et procédez comme suit :
-
Pour Clé, saisissez le nom de la clé.
-
Pour Valeur, saisissez la valeur de clé.
-
-
[Supprimer une balise] En regard de la balise, choisissez Supprimer la balise.
-
-
Choisissez Mettre à jour.
- AWS CLI
-
-
Exécutez
update-service. Pour plus d'informations sur l'exécution de la commande, voir update-service dans la AWS Command Line Interface référence.L’exemple
update-servicesuivant met à jour le nombre de tâches souhaité du servicemy-http-servicesur deux.Remplacez le
user-inputpar vos valeurs.aws ecs update-service \ --clusterMyCluster\ --servicemy-http-service\ --desired-count 2
-
Étapes suivantes
Suivez votre déploiement et consultez l’historique des services pour les services qui utilisent le disjoncteur Amazon ECS. Pour de plus amples informations, veuillez consulter Afficher l'historique des services à l'aide des déploiements de services Amazon ECS.