View a markdown version of this page

Création d'un Amazon ECS blue/green déploiement - Amazon Elastic Container Service

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Création d'un Amazon ECS blue/green déploiement

En utilisant Amazon ECS blue/green lors de déploiements, vous pouvez apporter et tester des modifications de service avant de les implémenter dans un environnement de production.

Conditions préalables

Effectuez les opérations suivantes avant de démarrer blue/green déploiement.

  1. Configurez les autorisations appropriées.

  2. (Facultatif) Pour le transfert de trafic géré, configurez l'une des ressources suivantes. Si votre service est sans interface (pas d'équilibreur de charge, de Service Connect ou de VPC Lattice), vous pouvez ignorer cette étape. Amazon ECS ne gère pas automatiquement le transfert de trafic pour les services headless.

  3. Décidez si vous souhaitez exécuter des fonctions Lambda pour les étapes du cycle de vie.

    • PRE_SCALE_UP

    • POST_SCALE_UP

    • TEST_TRAFFIC_SHIFT

    • POST_TEST_TRAFFIC_SHIFT

    • PRODUCTION_TRAFFIC_SHIFT

    • POST_PRODUCTION_TRAFFIC_SHIFT

    Pour plus d’informations sur l’utilisation de Lambda, consultez la section Créer une fonction Lambda avec la console dans le Guide du développeur AWS Lambda .

Procédure

Vous pouvez utiliser la console ou AWS CLI pour créer un Amazon ECS blue/green service.

Console
  1. Ouvrez la console à https://console.aws.amazon.com/ecs/v2.

  2. Déterminez la ressource à partir de laquelle vous lancez le service.

    Pour démarrer un service à partir de Étapes

    Clusters

    1. Sur la page Clusters, sélectionnez le cluster dans lequel créer le service.

      La page des détails du cluster s’ouvre.

    2. Dans l'onglet Services choisissez Create (Créer).

    Définition de tâche
    1. Sur la page Définitions de tâche, sélectionnez la définition de tâche.

    2. Dans le menu Déployer, choisissez Créer un service.

    La page Créer un service s’affiche.

  3. Sous Détails du service, procédez comme suit :

    1. Pour Famille de définition de tâche, choisissez la définition de tâche à utiliser. Ensuite, pour Révision de définition de tâche, saisissez la révision à utiliser.

    2. Pour Service name (Nom du service), saisissez un nom pour votre service.

  4. Pour exécuter le service dans un cluster existant, pour Cluster existant, sélectionnez le cluster. Pour exécuter le service dans un nouveau cluster, choisissez Créer un cluster

  5. Choisissez comment vos tâches sont distribuées dans votre infrastructure de cluster. Sous Configuration de calcul, choisissez votre option.

    Options de calcul Étapes

    Stratégie de fournisseur de capacité

    1. Sous Options de calcul, choisissez Stratégie de fournisseur de capacité.

    2. Choisissez une stratégie :

      • Pour utiliser une stratégie de fournisseur de capacité, choisissez Use cluster default (Utiliser la stratégie par défaut du cluster).

      • Si votre cluster ne possède pas de stratégie de fournisseur de capacité par défaut ou si vous souhaitez utiliser une stratégie personnalisée, sélectionnez Utiliser une stratégie personnalisée ou Ajouter une stratégie de fournisseur de capacité et définissez votre stratégie de fournisseur de capacité personnalisée en spécifiant une Base, un Fournisseur de capacité et un Poids.

    Note

    Pour utiliser un fournisseur de capacité dans une stratégie, le fournisseur de capacité doit être associé au cluster.

    Type de lancement
    1. Dans Compute options (Options de calcul), sélectionnez Launch type (Type de lancement).

    2. Pour Launch type (Type de lancement), choisissez un type de lancement.

    3. (Facultatif) Lorsque Fargate est spécifié, pour Version de plateforme, spécifiez la version de plateforme à utiliser. Si vous ne spécifiez aucune version de plateforme, la version LATEST est utilisée.

  6. Sous Configuration du déploiement, procédez comme suit :

    1. Pour Type de service, choisissez Replica.

    2. Pour Desired tasks (Tâches souhaitées), saisissez le nombre de tâches à lancer et à conserver dans le service.

    3. 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é.

    4. Pour Période de grâce pour la surveillance de l’état, saisissez la durée (en secondes) pendant laquelle le planificateur de service ignore les surveillances de l’état de Elastic Load Balancing, VPC Lattice et des conteneurs qui ne sont pas saines après le démarrage initial d’une tâche. Si vous ne spécifiez aucune valeur pour la période de grâce de surveillance de l’état, la valeur par défaut 0 est utilisée.

    1. Pour Durée de l’intégration, saisissez le nombre de minutes pendant lesquelles les révisions de service bleues et vertes seront exécutées simultanément avant que la révision bleue ne soit résiliée. Cela laisse le temps de procéder à des vérifications et à des tests.

    2. (Facultatif) Configurez les hooks du cycle de vie pour qu'ils s'exécutent à des étapes spécifiques du déploiement. En dessous Crochets liés au cycle de vie, choisissez Ajouter.

      Pour les crochets Lambda :

      • Pour Type de cible, choisissez Lambda.

      • Pour Fonction Lambda, saisissez le nom ou l’ARN de la fonction.

      • Pour Rôle, sélectionnez le rôle IAM qui dispose de l’autorisation requise pour invoquer la fonction Lambda.

      • Pour Étapes du cycle de vie, sélectionnez les étapes dans lesquelles la fonction Lambda doit être exécutée.

      Pour les crochets de pause :

      • Pour Type de cible, choisissez Pause.

      • Pour étapes du cycle de vie, sélectionnez les étapes pendant lesquelles le déploiement doit être suspendu.

      • (Facultatif) Pour Délai d'attente, configurez la durée et l'action du délai d'attente.

  7. 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.

    1. 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.

    2. Pour arrêter un déploiement en fonction des statistiques de l'application, sélectionnez Utiliser CloudWatch alarme (s). Puis, à partir de CloudWatch nom de l'alarme, choisissez les alarmes. Pour créer une nouvelle alarme, accédez au CloudWatch console.

      Pour que le logiciel ramène automatiquement le déploiement au dernier état de déploiement terminé lorsqu'un CloudWatch l'alarme met le déploiement en état d'échec, sélectionnez Annulation en cas de panne.

  8. (Facultatif) Pour interconnecter votre service à l’aide de Service Connect, développez Service Connect, puis spécifiez les éléments suivants :

    1. Sélectionnez Activer Service Connect.

    2. 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).

    3. 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 Région AWS dans votre Compte AWS ou un espace de noms dans la même région qui est partagé avec votre compte à l'aide de AWS Resource Access Manager (AWS RAM). Pour plus d'informations sur le partage AWS Cloud Map espaces de noms, voir Cross-account AWS Cloud Map partage d'espaces de noms dans le AWS Cloud Map Guide du développeur.

    4. (Facultatif) Configurer les règles d'en-tête de trafic de test pour blue/green déploiements. Sous Routage du trafic de test, spécifiez les éléments suivants :

      1. Sélectionnez Activer les règles d’en-tête du trafic de test pour acheminer des requêtes spécifiques vers la révision de service verte pendant les tests.

      2. Pour Règles de correspondance des en-têtes, configurez les critères de routage du trafic de test suivants :

        • Nom de l’en-tête : saisissez le nom de l’en-tête HTTP correspondant (par exemple, X-Test-Version ou User-Agent).

        • Type de correspondance : choisissez les critères de correspondance :

          • Correspondance exacte : acheminer les requêtes dont la valeur d’en-tête correspond exactement à la valeur spécifiée

          • En-tête présent : acheminer les requêtes contenant l’en-tête spécifié, quelle que soit sa valeur

          • Correspondance de modèle : acheminer les requêtes dont la valeur d’en-tête correspond à un modèle spécifié

        • Valeur d’en-tête (si vous utilisez une correspondance exacte ou une correspondance de modèle) : saisissez la valeur ou le modèle à comparer.

        Vous pouvez ajouter plusieurs règles de correspondance d’en-têtes pour créer une logique de routage complexe. Les requêtes correspondant à l’une des règles configurées seront acheminées vers la version verte du service à des fins de test.

      3. Choisissez Ajouter une règle d’en-tête pour configurer des conditions de correspondance d’en-tête supplémentaires.

      Note

      Les règles d’en-tête du trafic de test vous permettent de valider les nouvelles fonctionnalités avec un trafic contrôlé avant de procéder au déploiement complet. Cela vous permet de tester la révision de service verte avec des requêtes spécifiques (telles que celles provenant d’outils de test internes ou d’utilisateurs bêta) tout en maintenant un flux de trafic normal vers la révision de service bleue.

    5. (Facultatif) Spécifiez une configuration de journal. Sélectionnez Utiliser la collecte de journaux. L'option par défaut envoie les journaux des conteneurs à CloudWatch Journaux. Les autres options du pilote de journalisation sont configurées à l'aide de AWS FireLens. Pour plus d’informations, consultez 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 à laquelle envoyer les journaux des conteneurs CloudWatch Journaux. Les options du pilote de journal par défaut sont fournies, ce qui crée un CloudWatch connectez-vous à un groupe 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 à un OpenSearch Domaine 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 du pilote de journal par défaut sont définies par défaut, mais vous devez spécifier un nom de compartiment Amazon S3 valide.

  9. (Facultatif) Configurer équilibrage de charge pour blue/green déploiement.

    Types Elastic Load Balancing Étapes

    Application Load Balancer

    1. Pour Type d’équilibreur de charge, choisissez Application Load Balancer.

    2. Choisissez Create a new load balancer (Créer un équilibreur de charge) pour créer un équilibreur de charge Application Load Balancer ou Use an existing load balancer (Utiliser un équilibreur de charge existant) pour sélectionner un équilibreur de charge Application Load Balancer existant.

    3. Pour Conteneur, choisissez le conteneur qui héberge le service.

    4. Pour Load balancer name (nom d'équilibreur de charge), saisissez un nom unique.

    5. Pour Listener (Écouteur), saisissez un port et un protocole sur lesquels Application Load Balancer doit écouter les demandes de connexion. Par défaut, l'équilibreur de charge est configuré pour utiliser le port 80 et HTTP.

      • Pour Règle de production, saisissez l’ordre d’évaluation et le modèle de chemin de la règle.

        Cette règle concerne le trafic de révision de votre service de production.

      • Pour Règle de test, saisissez l’ordre d’évaluation et le modèle de chemin de la règle.

        Cette règle concerne le trafic de révision de votre service de test.

    6. Pour Groupe cible, configurez les éléments suivants :

      • Pour Target group name (Nom du groupe cible), saisissez un nom et un protocole pour le groupe cible vers lequel Application Load Balancer achemine les requêtes.

      • Pour Protocole, choisissez le protocole pour le groupe cible vers lequel Application Load Balancer achemine les requêtes. Par défaut, le groupe cible achemine les requêtes vers le premier conteneur défini dans votre définition de tâche.

      • Pour Délai de désinscription, entrez le nombre de secondes pendant lequel l'équilibreur de charge doit changer l'état cible en UNUSED. La durée par défaut est 300 secondes.

      • Pour Health check path (Chemin de surveillance de l'état), saisissez un chemin qui existe dans votre conteneur où Application Load Balancer doit envoyer périodiquement des requêtes pour vérifier l'état de la connexion entre Application Load Balancer et le conteneur. Le répertoire par défaut est le répertoire racine (/).

      • Dans Nom de groupe alternatif, saisissez le nom du groupe cible pour votre révision de service de test (vert).

    Network Load Balancer
    1. Pour Load balancer type (Type d'équilibreur de charge), sélectionnez Network Load Balancer.

    2. Dans le champ Load Balancer (Équilibreur de charge), choisissez Attacher à un Network Load Balancer existant.

    3. Pour Choose container to load balance (Choisissez le conteneur pour équilibrer la charge), choisissez le conteneur qui héberge le service.

    4. Pour Écouteur de production, choisissez le port d’écouteur de production et le protocole d’écouteur de production.

      Il s'agit de l'écouteur pour le trafic de révision de votre service de production.

    5. Pour Port de l’écouteur de test, choisissez le port de l’écouteur de test et le protocole de l’écouteur de test.

      Il s'agit de l'écouteur pour le trafic de révision de votre service de test.

    6. Pour Groupe cible, configurez les éléments suivants :

      • Pour Target group name (Nom du groupe cible), saisissez un nom et un protocole pour le groupe cible vers lequel Network Load Balancer achemine les requêtes.

      • Pour Protocole, choisissez le protocole pour le groupe cible vers lequel Network Load Balancer achemine les requêtes. Par défaut, le groupe cible achemine les requêtes vers le premier conteneur défini dans votre définition de tâche.

      • Pour Délai de désinscription, entrez le nombre de secondes pendant lequel l'équilibreur de charge doit changer l'état cible en UNUSED. La durée par défaut est 300 secondes.

      • Pour Health check path (Chemin de surveillance de l'état), saisissez un chemin qui existe dans votre conteneur où Application Load Balancer doit envoyer périodiquement des requêtes pour vérifier l'état de la connexion entre Application Load Balancer et le conteneur. Le répertoire par défaut est le répertoire racine (/).

      • Dans Nom de groupe alternatif, saisissez le nom du groupe cible pour votre révision de service de test (vert).

  10. (Facultatif) Pour utiliser VPC Lattice pour gérer le transfert de trafic pendant blue/green déploiements, extension Réseau en PVC - facultatif et sélectionnez Utiliser VPC Lattice, puis procédez comme suit :

    1. Pour VPC, choisissez le VPC pour vos ressources VPC Lattice. Il doit s'agir du même VPC que votre service Fargate.

    2. Pour Rôle de l'infrastructure, choisissez le rôle IAM de l'infrastructure Amazon ECS qu'Amazon ECS utilise pour gérer les ressources de votre VPC Lattice, ou choisissez Création d'un nouveau rôle d'infrastructure.

    3. Pour Nom du port du conteneur, choisissez le nom du port dans la définition de tâche qui correspond au port de conteneur qui reçoit le trafic de VPC Lattice.

    4. Pour Service VPC Lattice, choisissez Créer un nouveau service ou Utiliser un service existant. Pour Nom du service, entrez un nom unique pour le service.

    5. Pour auditeur, choisissez Créer un nouvel auditeur ou Utiliser un écouteur existant. Pour Port, entrez un port compris entre 1 et 65535. Pour Protocole, choisissez le protocole (par exemple, HTTP).

    6. En dessous Règle relative à l'auditeur de production, entrez un Nom, une Priorité de 1 à 100, et un Schéma de trajectoire (maximum 200 caractères). Amazon ECS utilise cette règle pour acheminer le trafic de production.

    7. (Facultatif, recommandé) Sous Règle de test pour les auditeurs, entrez un Nom, une Priorité de 1 à 100, et un Schéma de trajectoire. Amazon ECS utilise cette règle pour acheminer le trafic de test vers la révision du service vert.

    8. Pour Groupes cibles, choisissez Création de deux nouveaux groupes cibles, Créez un groupe cible vert, ou Utiliser deux groupes cibles existants. Pour un nouveau groupe cible, entrez un Nom du groupe cible, choisissez un Protocole, entrez un Port de 1 à 65535, choisissez Protocole de bilan de santé, et entrez un Parcours de contrôle de santé. Pour Nom du groupe cible en vert, entrez un nom ; le groupe cible vert utilise la même configuration que le groupe cible bleu.

  11. (Facultatif) Pour vous aider à identifier votre service et vos tâches, développez Tags (balises), puis configurez vos balises.

    Pour qu'Amazon ECS balise automatiquement toutes les tâches nouvellement lancées avec le nom du cluster et les balises de définition des tâches, sélectionnez Activer les balises gérées Amazon ECS, puis pour Propager des balises à partir de, choisissez Définitions de tâches.

    Pour qu'Amazon ECS balise automatiquement toutes les tâches nouvellement lancées avec le nom du cluster et les balises d'un service, sélectionnez Activer les balises gérées Amazon ECS, puis pour Propager des balises à partir de, choisissez Service.

    Ajoutez ou supprimez une balise.

    • [Ajouter une balise] Choisissez Add tag (Ajouter une balise), puis 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.

  12. Cliquez sur Créer.

AWS CLI
  1. Créez un fichier nommé service-definition.json avec le contenu suivant.

    Remplacez le user-input avec tes valeurs.

    { "serviceName": "myBlueGreenService", "cluster": "arn:aws:ecs:us-west-2:123456789012:cluster/sample-fargate-cluster", "taskDefinition": "sample-fargate:1", "desiredCount": 5, "launchType": "FARGATE", "networkConfiguration": { "awsvpcConfiguration": { "subnets": [ "subnet-09ce6e74c116a2299", "subnet-00bb3bd7a73526788", "subnet-0048a611aaec65477" ], "securityGroups": [ "sg-09d45005497daa123" ], "assignPublicIp": "ENABLED" } }, "deploymentController": { "type": "ECS" }, "deploymentConfiguration": { "strategy": "BLUE_GREEN", "maximumPercent": 200, "minimumHealthyPercent": 100, "bakeTimeInMinutes": 2, "alarms": { "alarmNames": [ "myAlarm" ], "rollback": true, "enable": true }, "lifecycleHooks": [ { "hookTargetArn": "arn:aws:lambda:us-west-2:7123456789012:function:checkExample", "roleArn": "arn:aws:iam::123456789012:role/ECSLifecycleHookInvoke", "lifecycleStages": [ "PRE_SCALE_UP" ], "hookDetails": { "MY_CONFIG_KEY": "my-config-value" } } ] }, "loadBalancers": [ { "targetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/blue-target-group/54402ff563af1197", "containerName": "fargate-app", "containerPort": 80, "advancedConfiguration": { "alternateTargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/green-target-group/cad10a56f5843199", "productionListenerRule": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-blue-green-demo/32e0e4f946c3c05b/9cfa8c482e204f7d/831dbaf72edb911", "roleArn": "arn:aws:iam::123456789012:role/LoadBalancerManagementforECS" } } ] }
  2. Exécutez create-service.

    Remplacez le user-input avec tes valeurs.

    aws ecs create-service --cli-input-json file://service-definition.json

    Vous pouvez également utiliser l'exemple suivant qui crée un blue/green service de déploiement avec une configuration d'équilibreur de charge :

    aws ecs create-service \ --cluster "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster" \ --service-name "blue-green-example-service" \ --task-definition "nginxServer:1" \ --launch-type "FARGATE" \ --network-configuration "awsvpcConfiguration={subnets=[subnet-12345,subnet-67890,subnet-abcdef,subnet-fedcba],securityGroups=[sg-12345],assignPublicIp=ENABLED}" \ --desired-count 3 \ --deployment-controller "type=ECS" \ --deployment-configuration "strategy=BLUE_GREEN,maximumPercent=200,minimumHealthyPercent=100,bakeTimeInMinutes=0" \ --load-balancers "targetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/MyBGtg1/abcdef1234567890,containerName=nginx,containerPort=80,advancedConfiguration={alternateTargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/MyBGtg2/0987654321fedcba,productionListenerRule=arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/MyLB/1234567890abcdef/1234567890abcdef,roleArn=arn:aws:iam::123456789012:role/ELBManagementRole}"

    Vous pouvez également utiliser l'exemple suivant qui crée un blue/green service de déploiement avec une configuration VPC Lattice :

    aws ecs create-service \ --cluster "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster" \ --service-name "blue-green-example-service" \ --task-definition "nginxServer:1" \ --launch-type "FARGATE" \ --network-configuration "awsvpcConfiguration={subnets=[subnet-12345,subnet-67890,subnet-abcdef,subnet-fedcba],securityGroups=[sg-12345],assignPublicIp=ENABLED}" \ --desired-count 3 \ --deployment-controller "type=ECS" \ --deployment-configuration "strategy=BLUE_GREEN,maximumPercent=200,minimumHealthyPercent=100,bakeTimeInMinutes=0" \ --vpc-lattice-configurations "portName=web,roleArn=arn:aws:iam::111122223333:role/ecs-vpc-lattice-role,targetGroupArn=arn:aws:vpc-lattice:us-west-2:111122223333:targetgroup/primary-target-group/abcdef123456,advancedConfiguration={alternateTargetGroupArn=arn:aws:vpc-lattice:us-west-2:111122223333:targetgroup/alternate-target-group/ghijkl789012,productionListenerRule=arn:aws:vpc-lattice:us-west-2:111122223333:service/svc-0123456789abcdef0/listener/listener-0123456789abcdef0/rule/rule-0123456789abcdef0,testListenerRule=arn:aws:vpc-lattice:us-west-2:111122223333:service/svc-0123456789abcdef0/listener/listener-0123456789abcdef0/rule/rule-abcdef01234567890}"

Étapes suivantes

  • Mettez à jour le service pour démarrer le déploiement. Pour plus d’informations, consultez Mettre à jour un service Amazon ECS.

  • Surveillez le processus de déploiement pour vous assurer qu'il respecte les blue/green motif :

    • La révision de service verte est créée et augmentée horizontalement

    • Le trafic de test est acheminé vers la révision verte (si elle est configurée)

    • Le trafic de production est transféré vers la révision verte

    • Au terme de la durée de l’intégration, la révision bleue est résiliée