Prérequis Étape 1 : créer une image et la transférer vers un référentiel Amazon ECR Étape 2 : Création de fichiers AppSpec source et de définition de tâches, puis transfert vers un CodeCommit référentiel Étape 3 : Créer votre équilibreur de charge d'application et vos groupes cibles Étape 4 : créer votre cluster et votre service Amazon ECS Étape 5 : Créer l'application CodeDeploy et le groupe de déploiement (plateforme de calcul ECS)Étape 6 : Créer le pipeline Étape 7 : Modifier le pipeline et vérifier le déploiement

Tutoriel : Création d'un pipeline avec une source Amazon ECR et ECS-to-deployment CodeDeploy

Dans ce didacticiel, vous configurez un pipeline dans AWS CodePipeline, qui déploie des applications de conteneur à l'aide d'un déploiement bleu/vert qui prend en charge des images Docker. Dans un déploiement bleu/vert, vous pouvez lancer la nouvelle version de votre application avec l'ancienne version, et tester la nouvelle version avant de rediriger le trafic. Vous pouvez également surveiller le processus de déploiement et revenir rapidement en arrière en cas de problème.

Note

Ce didacticiel est destiné à l'action de déploiement d'Amazon ECS vers le CodeDeploy bleu/vert pour. CodePipeline Pour un didacticiel utilisant l'action de déploiement standard d'Amazon ECS dans CodePipeline, consultezTutoriel : Déploiement standard d'Amazon ECS avec CodePipeline.

Le pipeline terminé détecte les modifications apportées à votre image, qui est stockée dans un référentiel d'images tel qu'Amazon ECR, et utilisée CodeDeploy pour acheminer et déployer le trafic vers un cluster Amazon ECS et un équilibreur de charge. CodeDeploy utilise un écouteur pour rediriger le trafic vers le port du conteneur mis à jour spécifié dans le AppSpec fichier. Pour plus d'informations sur la façon dont l'équilibreur de charge, l'écouteur de production, les groupes cibles et votre application Amazon ECS sont utilisés dans un déploiement bleu/vert, consultez Tutoriel : Déployer un service Amazon ECS.

Le pipeline est également configuré pour utiliser un emplacement source CodeCommit, tel que l'endroit où votre définition de tâche Amazon ECS est stockée. Dans ce didacticiel, vous allez configurer chacune de ces AWS ressources, puis créer votre pipeline avec des étapes contenant des actions pour chaque ressource.

Votre pipeline de livraison continue créera et déploiera automatiquement des images de conteneur chaque fois que le code source est modifié ou qu'une nouvelle image de base est téléchargée sur Amazon ECR.

Ce flux utilise les artefacts suivants :

Un fichier image Docker qui spécifie le nom du conteneur et l'URI du référentiel de votre référentiel d'images Amazon ECR.
Définition de tâche Amazon ECS répertoriant le nom de votre image Docker, le nom du conteneur, le nom du service Amazon ECS et la configuration de votre équilibreur de charge.
CodeDeploy AppSpec Fichier qui spécifie le nom du fichier de définition de tâche Amazon ECS, le nom du conteneur de l'application mise à jour et le port du conteneur où le trafic de production est CodeDeploy redirigé. Il peut également spécifier la configuration du réseau et les fonctions Lambda facultatifs que vous pouvez exécuter durant les hooks d'événement de cycle de vie de déploiement.

Note

Lorsque vous validez une modification dans votre référentiel d'images Amazon ECR, l'action de la source du pipeline crée un imageDetail.json fichier pour cette validation. Pour de plus amples informations concernant le fichier imageDetail.json, veuillez consulter Fichier imageDetail.json bleu/vert pour les actions de déploiement Amazon ECS.

Lorsque vous créez ou modifiez votre pipeline et mettez à jour ou spécifiez des artefacts source pour votre étape de déploiement, assurez-vous pour qu'il pointe vers la source des artefacts avec le nom et la version les plus récents que vous souhaitez utiliser. Une fois que vous avez configuré votre pipeline, au fur et à mesure que vous apportez des modifications à votre image ou à une définition de tâche, il se peut que vous ayez besoin de mettre à jour vos fichiers d'artefact source dans vos référentiels, puis de modifier l'étape de déploiement dans votre pipeline.

Rubriques

Prérequis
Étape 1 : créer une image et la transférer vers un référentiel Amazon ECR
Étape 2 : Création de fichiers AppSpec source et de définition de tâches, puis transfert vers un CodeCommit référentiel
Étape 3 : Créer votre équilibreur de charge d'application et vos groupes cibles
Étape 4 : créer votre cluster et votre service Amazon ECS
Étape 5 : Créer l'application CodeDeploy et le groupe de déploiement (plateforme de calcul ECS)
Étape 6 : Créer le pipeline
Étape 7 : Modifier le pipeline et vérifier le déploiement

Prérequis

Vous devez avoir déjà créé les ressources suivantes :

Un CodeCommit référentiel. Vous pouvez utiliser le référentiel AWS CodeCommit que vous avez créé dans Didacticiel : Création d'un pipeline simple (référentiel CodeCommit).
Lancez une instance Linux Amazon EC2 et installez Docker pour créer une image, comme indiqué dans ce didacticiel. Si vous avez déjà une image que vous souhaitez utiliser, vous pouvez ignorer cette condition préalable.

Étape 1 : créer une image et la transférer vers un référentiel Amazon ECR

Dans cette section, vous utilisez Docker pour créer une image, puis vous l'utilisez AWS CLI pour créer un référentiel Amazon ECR et transférer l'image vers le référentiel.

Note

Si vous avez déjà une image que vous souhaitez utiliser, vous pouvez ignorer cette étape.

Pour créer une image

Connectez-vous à votre instance Linux dans laquelle Docker est installé.

Retirez une image pour nginx. Cette commande fournit l'nginx:latestimage :
```
docker pull nginx
```
Exécutez docker images. Vous devez voir l'image dans la liste.
```
docker images
```

Pour créer un référentiel Amazon ECR et publier votre image

Créez un référentiel Amazon ECR pour stocker votre image . Notez l'repositoryUri dans la sortie.


aws ecr create-repository --repository-name nginx

Sortie :


{
    "repository": {
        "registryId": "aws_account_id",
        "repositoryName": "nginx",
        "repositoryArn": "arn:aws:ecr:us-east-1:aws_account_id:repository/nginx",
        "createdAt": 1505337806.0,
        "repositoryUri": "aws_account_id.dkr.ecr.us-east-1.amazonaws.com/nginx"
    }
}

Balisez l'image avec la valeur repositoryUri de l'étape précédente.


docker tag nginx:latest aws_account_id.dkr.ecr.us-east-1.amazonaws.com/nginx:latest

Exécutez la aws ecr get-login-password commande, comme indiqué dans cet exemple pour la us-west-2 région et l'ID de compte 111122223333.


aws ecr get-login-password --region us-west-2 | docker login --username AWS --password-stdin 111122223333.dkr.ecr.us-west-2.amazonaws.com/nginx

Transférez l'image vers Amazon ECR à l'aide repositoryUri de l'étape précédente.
```
docker push 111122223333.dkr.ecr.us-east-1.amazonaws.com/nginx:latest
```

Étape 2 : Création de fichiers AppSpec source et de définition de tâches, puis transfert vers un CodeCommit référentiel

Dans cette section, vous allez créer un fichier JSON de définition de tâche et l'enregistrer auprès d'Amazon ECS. Vous créez ensuite un AppSpec fichier pour votre client Git CodeDeploy et vous l'utilisez pour transférer les fichiers vers votre CodeCommit dépôt.

Pour créer une définition de tâche pour votre image

Créez un fichier nommé taskdef.json avec les contenus suivants. Pour image, saisissez votre nom d'image, par exemple nginx. Cette valeur est mise à jour lorsque votre pipeline est exécuté.

Note

Assurez-vous que le rôle d'exécution spécifié dans la définition de tâche contient la stratégie AmazonECSTaskExecutionRolePolicy. Pour plus d'informations, consultez Amazon ECS Task Execution IAM Role dans le manuel du développeur Amazon ECS.


{
    "executionRoleArn": "arn:aws:iam::account_ID:role/ecsTaskExecutionRole",
    "containerDefinitions": [
        {
            "name": "sample-website",
            "image": "nginx",
            "essential": true,
            "portMappings": [
                {
                    "hostPort": 80,
                    "protocol": "tcp",
                    "containerPort": 80
                }
            ]
        }
    ],
    "requiresCompatibilities": [
        "FARGATE"
    ],
    "networkMode": "awsvpc",
    "cpu": "256",
    "memory": "512",
    "family": "ecs-demo"
}

Enregistrez votre définition de tâche dans le fichier taskdef.json.


aws ecs register-task-definition --cli-input-json file://taskdef.json

Une fois la définition de tâche enregistrée, modifiez votre fichier afin de supprimer le nom et d'inclure le texte d'espace réservé <IMAGE1_NAME> dans le champ de l'image.


{
    "executionRoleArn": "arn:aws:iam::account_ID:role/ecsTaskExecutionRole",
    "containerDefinitions": [
        {
            "name": "sample-website",
            "image": "<IMAGE1_NAME>",
            "essential": true,
            "portMappings": [
                {
                    "hostPort": 80,
                    "protocol": "tcp",
                    "containerPort": 80
                }
            ]
        }
    ],
    "requiresCompatibilities": [
        "FARGATE"
    ],
    "networkMode": "awsvpc",
    "cpu": "256",
    "memory": "512",
    "family": "ecs-demo"
}

Pour créer un AppSpec fichier

Le AppSpec fichier est utilisé pour les CodeDeploy déploiements. Le fichier, qui inclut des champs facultatifs, utilise ce format :


version: 0.0
Resources:
  - TargetService:
      Type: AWS::ECS::Service
      Properties:
        TaskDefinition: "task-definition-ARN"
        LoadBalancerInfo:
          ContainerName: "container-name"
          ContainerPort: container-port-number
# Optional properties
        PlatformVersion: "LATEST"
        NetworkConfiguration:
            AwsvpcConfiguration:
              Subnets: ["subnet-name-1", "subnet-name-2"]
              SecurityGroups: ["security-group"]
              AssignPublicIp: "ENABLED"
Hooks:
- BeforeInstall: "BeforeInstallHookFunctionName"
- AfterInstall: "AfterInstallHookFunctionName"
- AfterAllowTestTraffic: "AfterAllowTestTrafficHookFunctionName"
- BeforeAllowTraffic: "BeforeAllowTrafficHookFunctionName"
- AfterAllowTraffic: "AfterAllowTrafficHookFunctionName"

Pour plus d'informations sur le AppSpec fichier, notamment des exemples, consultez la section Référence CodeDeploy AppSpec du fichier.

Créez un fichier nommé appspec.yaml avec les contenus suivants. Pour TaskDefinition, ne modifiez pas le texte d'espace réservé <TASK_DEFINITION>. Cette valeur est mise à jour lorsque votre pipeline est exécuté.


version: 0.0
Resources:
  - TargetService:
      Type: AWS::ECS::Service
      Properties:
        TaskDefinition: <TASK_DEFINITION>
        LoadBalancerInfo:
          ContainerName: "sample-website"
          ContainerPort: 80

Pour transférer des fichiers vers votre CodeCommit dépôt

Envoyez ou téléchargez les fichiers dans votre CodeCommit dépôt. Ces fichiers constituent l'artefact source créé par l'assistant Create Pipeline (Création de pipeline) pour votre action de déploiement dans CodePipeline. Vos fichiers doivent être similaires à ce qui suit dans votre répertoire local :
```
/tmp
  |my-demo-repo
    |-- appspec.yaml
    |-- taskdef.json
```
Choisissez la méthode que vous souhaitez utiliser pour charger vos fichiers :
1. Pour utiliser la ligne de commande Git à partir d'un référentiel cloné sur votre ordinateur local :
  1. Modifiez les répertoires vers votre référentiel local :
```
(For Linux, macOS, or Unix) cd /tmp/my-demo-repo
(For Windows) cd c:\temp\my-demo-repo
```
  2. Exécutez la commande suivante pour organiser tous vos fichiers à la fois :
```
git add -A
```
  3. Exécutez la commande suivante pour valider les fichiers avec un message de validation :
```
git commit -m "Added task definition files"
```
  4. Exécutez la commande suivante pour transférer les fichiers de votre dépôt local vers votre CodeCommit dépôt :
```
git push
```
2. Pour télécharger vos fichiers à l' CodeCommit aide de la console, procédez comme suit :
  1. Ouvrez la CodeCommit console et choisissez votre dépôt dans la liste des référentiels.
  2. Choisissez Ajouter un fichier, puis choisissez Charger le fichier.
  3. Sélectionnez Choisir un fichier, puis recherchez votre fichier. Validez la modification en entrant votre nom d'utilisateur et votre adresse e-mail. Choisissez Valider les modifications.
  4. Répétez cette étape pour chaque fichier que vous souhaitez charger.

Étape 3 : Créer votre équilibreur de charge d'application et vos groupes cibles

Dans cette section, vous allez créer un Amazon EC2 Application Load Balancer. Vous utiliserez les noms de sous-réseaux et les valeurs de groupe cible que vous créerez avec votre équilibreur de charge ultérieurement, lorsque vous créerez votre service Amazon ECS. Vous pouvez créer un équilibreur de charge d'application ou un Network Load Balancer. L'équilibreur de charge doit utiliser un VPC avec deux sous-réseaux publics dans différentes zones de disponibilité. Au cours de ces étapes, vous devez confirmer votre VPC par défaut, créer un équilibreur de charge, puis créer deux groupes cible pour votre équilibreur de charge. Pour plus d'informations, consultez Groupes cibles pour vos équilibreurs de charge du réseau.

Pour vérifier votre VPC par défaut et les sous-réseaux publics

Connectez-vous à la AWS Management Console et ouvrez la console Amazon VPC à l'adresse https://console.aws.amazon.com/vpc/.
Vérifiez le VPC par défaut à utiliser. Dans le panneau de navigation, sélectionnez Your VPCs (Vos VPC). Notez que le VPC affiche Oui dans la colonne VPC par défaut. Il s'agit du VPC par défaut. Il contient des sous-réseaux par défaut que vous pouvez sélectionner.
Choisissez Sous-réseaux. Choisissez deux sous-réseaux qui contiennent Oui dans la colonne Sous-réseau par défaut.

Note
Prenez note de vos ID de sous-réseaux. Vous en aurez besoin ultérieurement dans ce didacticiel.
Choisissez les sous-réseaux, puis choisissez l'onglet Description. Vérifiez que les sous-réseaux que vous souhaitez utiliser sont dans des zones de disponibilité différentes.
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 de passerelle est incluse dans la table de routage.

Pour créer un Amazon EC2 Application Load Balancer

Connectez-vous à la AWS Management Console et ouvrez la console Amazon EC2 à l’adresse https://console.aws.amazon.com/ec2/.
Dans le volet de navigation, choisissez Load Balancers.
Sélectionnez Create Load Balancer (Créer un équilibreur de charge).
Choisissez Équilibreur de charge d'application, puis choisissez Créer.
Dans Nom, entrez le nom de votre équilibreur de charge.
Dans Méthode, choisissez Accessible sur Internet.
Dans Type d'adresse IP, choisissez ipv4.
Configurez deux ports d'écoute pour votre équilibreur de charge :
1. Sous Protocole d'écoute de l'équilibreur de charge, choisissez HTTP. Sous Port de l'équilibreur de charge, entrez 80.
2. Choisissez Add listener (Ajouter un écouteur).
3. Sous Protocole de l'équilibreur de charge pour le deuxième écouteur, choisissez HTTP. Sous Port de l'équilibreur de charge, entrez 8080.
Sous Zones de disponibilité, dans VPC, choisissez le VPC par défaut. Ensuite, choisissez deux sous-réseaux par défaut que vous souhaitez utiliser.
Choisissez Next: Configure Security Settings (Suivant : Configurer les paramètres de sécurité).
Choisissez Next: Configure Security Groups (Suivant : Configurer des groupes de sécurité).
Choisissez Sélectionner un groupe de sécurité existant et prenez note de l'ID du groupe de sécurité.
Choisissez Next: Configure Routing (Suivant :Configurer le routage).
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).
2. Dans Type cible, choisissez IP.
3. Dans Protocole, choisissez HTTP. Dans Port, entrez 80.
4. Choisissez Next: Register Targets (Suivant : Enregistrer des cibles).
Choisissez Suivant : Vérification, puis Créer.

Pour créer un deuxième groupe cible pour votre équilibreur de charge

Une fois votre équilibreur de charge configuré, ouvrez la console Amazon EC2. Dans le volet de navigation, sélectionnez Groupes cibles.
Sélectionnez Créer un groupe cible.
Dans Nom, entrez un nom de groupe cible (par exemple, target-group-2).
Dans Type cible, choisissez IP.
Dans Protocole, choisissez HTTP. Dans Port, entrez 8080.
Dans VPC, choisissez le VPC par défaut.
Choisissez Créer.

Note
Vous devez avoir deux groupes cibles créés pour votre équilibreur de charge afin de permettre l'exécution du déploiement. Vous devez uniquement noter l'ARN de votre premier groupe cible. Cet ARN est utilisé dans le fichier JSON create-service au cours de l'étape suivante.

Pour mettre à jour votre équilibreur de charge de façon à inclure votre deuxième groupe cible

Ouvrez la console Amazon EC2. Dans le volet de navigation, choisissez Load Balancers.
Choisissez l'équilibreur de charge, puis choisissez l'onglet Ecouteurs. Choisissez l'écouteur avec le port 8080, puis choisissez Modifier.
Choisissez l'icône en forme de crayon en regard de Réacheminer vers. Choisissez votre deuxième groupe cible, puis choisissez la coche. Choisissez Mettre à jour pour mettre à jour les mises à jour.

Étape 4 : créer votre cluster et votre service Amazon ECS

Dans cette section, vous créez un cluster et un service Amazon ECS qui CodeDeploy acheminent le trafic pendant le déploiement (vers un cluster Amazon ECS plutôt que vers des instances EC2). Pour créer votre service Amazon ECS, vous devez utiliser les noms de sous-réseaux, le groupe de sécurité et la valeur du groupe cible que vous avez créés avec votre équilibreur de charge pour créer votre service.

Note

Lorsque vous suivez ces étapes pour créer votre cluster Amazon ECS, vous utilisez le modèle de cluster Networking only, qui approvisionne les conteneurs AWS Fargate. AWS Fargate est une technologie qui gère votre infrastructure d'instance de conteneur pour vous. Vous n'avez pas besoin de choisir ou de créer manuellement des instances Amazon EC2 pour votre cluster Amazon ECS.

Pour créer un nouveau cluster Amazon ECS

Ouvrez la console classique Amazon ECS à partir de l'adresse https://console.aws.amazon.com/ecs/.
Dans le panneau de navigation, choisissez Clusters.
Choisissez Créer un cluster.
Choisissez le modèle de cluster Networking only qui utilise AWS Fargate, puis choisissez Next step.
Saisissez le nom d'un cluster sur la page Configure cluster (Configurer le cluster). Vous pouvez ajouter une balise facultative pour votre ressource. Choisissez Créer.

Pour créer un service Amazon ECS

Utilisez le AWS CLI pour créer votre service dans Amazon ECS.

Créez un fichier JSON et nommez-le create-service.json. Collez ce qui suit dans le fichier JSON.

Pour le taskDefinition champ, lorsque vous enregistrez une définition de tâche dans Amazon ECS, vous lui attribuez une famille. Il s'agit d'un élément similaire à un nom pour plusieurs versions de la définition de tâche, spécifié avec un numéro de révision. Dans cet exemple, utilisez « ecs-demo:1 » comme famille et numéro de révision dans votre fichier. Utilisez les noms des sous-réseau, le groupe de sécurité et la valeur du groupe cible créés avec l'équilibreur de charge dans Étape 3 : Créer votre équilibreur de charge d'application et vos groupes cibles .

Note
Vous devez inclure votre ARN de groupe cible dans ce fichier. Ouvrez la console Amazon EC2 et dans le volet de navigation, sous LOAD BALANCING, sélectionnez Target Groups. Choisissez votre premier groupe cible. Copiez votre ARN à partir de l'onglet Description.
```
{
    "taskDefinition": "family:revision-number",
    "cluster": "my-cluster",
    "loadBalancers": [
        {
            "targetGroupArn": "target-group-arn",
            "containerName": "sample-website",
            "containerPort": 80
        }
    ],
    "desiredCount": 1,
    "launchType": "FARGATE",
    "schedulingStrategy": "REPLICA",
    "deploymentController": {
        "type": "CODE_DEPLOY"
    },
    "networkConfiguration": {
        "awsvpcConfiguration": {
            "subnets": [
                "subnet-1",
                "subnet-2"
            ],
            "securityGroups": [
                "security-group"
            ],
            "assignPublicIp": "ENABLED"
        }
    }
}
```
Exécutez la commande create-service, en spécifiant le fichier JSON :

Important
N'oubliez pas d'inclure file:// devant le nom du fichier. Il est nécessaire dans cette commande.

Cet exemple crée un service nommé my-service.

Note
Cet exemple de commande crée un service nommé my-service. Si vous avez déjà un service portant ce nom, la commande renvoie une erreur.
```
aws ecs create-service --service-name my-service --cli-input-json file://create-service.json
```
La sortie renvoie les champs de description pour votre service.
Exécutez la commande describe-services pour vérifier que le service a été créé.
```
aws ecs describe-services --cluster cluster-name --services service-name
```

Étape 5 : Créer l'application CodeDeploy et le groupe de déploiement (plateforme de calcul ECS)

Lorsque vous créez une CodeDeploy application et un groupe de déploiement pour la plate-forme de calcul Amazon ECS, l'application est utilisée lors d'un déploiement pour référencer le groupe de déploiement, les groupes cibles, les écouteurs et le comportement de réacheminement du trafic appropriés.

Pour créer une CodeDeploy application

Ouvrez la CodeDeploy console et choisissez Create application.
Dans Nom de l'application, entrez le nom que vous souhaitez utiliser.
Dans Plateforme de calcul, choisissez Amazon ECS.
Choisissez Créer une application.

Pour créer un groupe CodeDeploy de déploiement

Sur la page de votre application, dans l'onglet Groupe de déploiement, choisissez Créer un groupe de déploiement.
Dans Nom du groupe de déploiement, entrez un nom décrivant le groupe de déploiement.
Dans Rôle de service, choisissez un rôle de service qui accorde CodeDeploy l'accès à Amazon ECS. Pour créer un rôle de service, procédez comme suit :
1. Ouvrez la console IAM à l'adresse https://console.aws.amazon.com/iam/).
2. Dans le tableau de bord de la console, choisissez Rôles.
3. Sélectionnez Créer un rôle.
4. Sous Sélectionner le type d'entité de confiance, sélectionnez Service AWS. Sous Choisir un cas d'utilisation, sélectionnez CodeDeploy. Sous Sélectionnez votre cas d'utilisation, sélectionnez CodeDeploy - ECS. Sélectionnez Next: Permissions (Étape suivante : autorisations). La stratégie gérée AWSCodeDeployRoleForECS est déjà attachée au rôle.
5. Choisissez Suivant : Balises, puis Suivant : Vérification.
6. Entrez un nom pour le rôle (par exemple, CodeDeployECSRole), puis choisissez Créer un rôle.
Dans Configuration de l'environnement, choisissez le nom de votre cluster Amazon ECS et le nom du service.
Dans Équilibreurs de charge, choisissez le nom de l'équilibreur de charge qui achemine le trafic vers votre service Amazon ECS.
Dans Port d'écoute de production, choisissez le port et le protocole de l'écouteur qui transmet le trafic de production à votre service Amazon ECS. Dans Test listener port (Port de l'écouteur de test), choisissez le port et le protocole de l'écouteur de test.
À partir de Nom du groupe cible 1 et Nom du groupe cible 2, choisissez les groupes cible utilisés pour acheminer le trafic au cours de votre déploiement. Assurez-vous que ce sont les groupes cibles que vous avez créés pour votre équilibreur de charge.
Choisissez Réacheminer le trafic immédiatement pour déterminer le délai après un déploiement réussi pour rediriger le trafic vers votre tâche Amazon ECS mise à jour.
Choisissez Créer un groupe de déploiement.

Étape 6 : Créer le pipeline

Dans cette section, vous créez un pipeline avec les actions suivantes :

CodeCommit Action dans laquelle les artefacts sources sont la définition de la tâche et le AppSpec fichier.
Un stage source avec une action de source Amazon ECR où l'artefact source est le fichier image.
Une phase de déploiement avec une action de déploiement Amazon ECS au cours de laquelle le déploiement s'exécute avec une CodeDeploy application et un groupe de déploiement.

Pour créer un pipeline à deux étapes avec l'assistant

Connectez-vous à la CodePipeline console AWS Management Console et ouvrez-la à l'adresse http://console.aws.amazon.com/codesuite/codepipeline/home.
Sur la page Bienvenue, la page Démarrez ou la page Pipelines, choisissez Créer un pipeline.
Dans l'Étape 1 : Choisir les paramètres d'un pipeline, dans Nom du pipeline, saisissez MyImagePipeline.
Dans Type de pipeline, choisissez V1 pour les besoins de ce didacticiel. Vous pouvez également choisir la V2 ; toutefois, notez que les types de pipelines diffèrent en termes de caractéristiques et de prix. Pour plus d'informations, consultez Types de pipelines.
Dans Rôle de service, choisissez Nouveau rôle de service pour autoriser CodePipeline à créer un rôle de service dans IAM.
Laissez les paramètres sous Advanced settings (Paramètres avancés) à leurs valeurs par défaut, puis choisissez Suivant.
Dans Étape 2 : Ajouter une étape source, dans Fournisseur de source, choisissez AWS CodeCommit. Dans Nom du référentiel, choisissez le nom du référentiel CodeCommit que vous avez créé dans Étape 1 : Création d'un CodeCommit référentiel. Dans Nom de branche, choisissez le nom de la branche qui contient votre dernière mise à jour du code.

Choisissez Suivant.
Dans Step 3: Add build stage (Étape 3 : Ajouter une étape de génération), choisissez Skip build stage (Ignorer l'étape de génération) et acceptez le message d'avertissement en choisissant à nouveau Skip (Ignorer). Choisissez Suivant.
Dans Étape 4 : Ajouter une étape de déploiement :
1. Dans Fournisseur de déploiement, choisissez Amazon ECS (Bleu/vert). Dans Nom de l'application, entrez ou choisissez le nom de l'application dans la liste, comme codedeployapp. Dans Groupe de déploiement, saisissez ou choisissez le nom du groupe de déploiement dans la liste, comme codedeploydeplgroup.
  
  Note
  « Déploiement » est le nom donné par défaut à l'étape du pipeline créée lors de l'Étape 4 : Déploiement tout comme « Source » est le nom donné à la première étape du pipeline.
2. Sous Définition de tâche Amazon ECS, sélectionnez SourceArtifact. Dans le champ, entrez taskdef.json.
3. Sous AWS CodeDeploy AppSpec fichier, sélectionnez SourceArtifact. Dans le champ, entrez appspec.yaml.
  
  Note
  À ce stade, ne renseignez aucune information sous Mettre à jour l'image de la définition de tâche de manière dynamique.
4. Choisissez Suivant.
Dans Step 5: Review, vérifiez les informations puis choisissez Create pipeline.

Pour ajouter une action source Amazon ECR à votre pipeline

Consultez votre pipeline et ajoutez une action source Amazon ECR à votre pipeline.

Choisissez votre pipeline. Dans le coin supérieur gauche, choisissez Modifier.
Dans la phase source, choisissez Modifier l'étape.
Ajoutez une action parallèle en choisissant + Ajouter une action à côté de votre action CodeCommit source.
Dans Nom d'action, saisissez un nom pour le pipeline (par exemple, Image).
Dans Fournisseur d'action, choisissez Amazon ECR.
Dans Nom du référentiel, choisissez le nom de votre référentiel Amazon ECR.
Dans Balise d'image, spécifiez le nom et la version de l'image, s'ils sont différents des précédents.
Dans Artefacts de sortie, choisissez l'artefact de sortie par défaut (par exemple, MyImage) qui contient les informations de nom d'image et d'URI de référentiel que l'étape suivante doit utiliser.
Choisissez Save (Enregistrer) sur l'écran de l'action. Choisissez Done (Terminé) sur l'écran de l'étape. Choisissez Save (Enregistrer) sur le pipeline. Un message indique la règle Amazon CloudWatch Events à créer pour l'action source Amazon ECR.

Pour relier vos artefacts source à l'action de déploiement

Choisissez Modifier lors de votre phase de déploiement et choisissez l'icône pour modifier l'action Amazon ECS (bleu/vert).
Faites défiler jusqu'au bas du panneau. Dans Artefacts d'entrée, choisissez Ajouter. Ajoutez l'artefact source depuis votre nouveau référentiel Amazon ECR (par exemple,MyImage).
Dans Définition de tâche, sélectionnez SourceArtifact, puis vérifiez que la saisie taskdef.json est effectuée.
Dans AWS CodeDeploy AppSpec Fichier, sélectionnez SourceArtifact, puis vérifiez que la saisie appspec.yaml est effectuée.
Dans Mettre à jour dynamiquement l'image de définition de tâche, dans Artifact d'entrée avec URI d'image MyImage, choisissez, puis entrez le texte de l'espace réservé utilisé dans le taskdef.json fichier :. IMAGE1_NAME Choisissez Enregistrer.

Dans le volet AWS CodePipeline, choisissez Enregistrer les modifications du pipeline, puis Enregistrer la modification. Affichez votre pipeline mis à jour.

Une fois cet exemple de pipeline créé, la configuration d'action pour les entrées de la console s'affiche dans la structure du pipeline, comme suit :


"configuration": {
  "AppSpecTemplateArtifact": "SourceArtifact",
  "AppSpecTemplatePath": "appspec.yaml",
  "TaskDefinitionTemplateArtifact": "SourceArtifact",
  "TaskDefinitionTemplatePath": "taskdef.json",
  "ApplicationName": "codedeployapp",
  "DeploymentGroupName": "codedeploydeplgroup",
  "Image1ArtifactName": "MyImage",
  "Image1ContainerName": "IMAGE1_NAME"
},

Pour soumettre vos modifications et lancer la génération d'un pipeline, choisissez Changement de version, puis Publication.
Choisissez l'action de déploiement pour la visualiser CodeDeploy et suivre la progression du transfert du trafic.

Note
Il se peut qu'une étape de déploiement affiche un temps d'attente facultatif. Par défaut, CodeDeploy attend une heure après un déploiement réussi avant de mettre fin à l'ensemble de tâches initial. Vous pouvez utiliser ce temps pour revenir en arrière ou mettre fin à la tâche. Sinon, votre déploiement prend fin lorsque l’ensemble de tâches est terminé.

Étape 7 : Modifier le pipeline et vérifier le déploiement

Apportez une modification à votre image, puis transférez la modification dans votre référentiel Amazon ECR. Cela déclenche l'exécution de votre pipeline. Vérifiez que la modification de la source de l'image est déployée.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Tutoriel : Déploiement standard d'Amazon ECS avec CodePipeline

Didacticiel : Création d'un pipeline qui déploie un kit Amazon Alexa Skill

Tutoriel : Création d'un pipeline avec une source Amazon ECR et ECS-to-deployment CodeDeploy

Note

Note

Rubriques

Prérequis

Étape 1 : créer une image et la transférer vers un référentiel Amazon ECR

Note

Pour créer une image

Pour créer un référentiel Amazon ECR et publier votre image

Étape 2 : Création de fichiers AppSpec source et de définition de tâches, puis transfert vers un CodeCommit référentiel

Pour créer une définition de tâche pour votre image

Note

Pour créer un AppSpec fichier

Pour transférer des fichiers vers votre CodeCommit dépôt

Étape 3 : Créer votre équilibreur de charge d'application et vos groupes cibles

Pour vérifier votre VPC par défaut et les sous-réseaux publics

Note

Pour créer un Amazon EC2 Application Load Balancer

Pour créer un deuxième groupe cible pour votre équilibreur de charge

Note

Pour mettre à jour votre équilibreur de charge de façon à inclure votre deuxième groupe cible

Étape 4 : créer votre cluster et votre service Amazon ECS

Note

Pour créer un nouveau cluster Amazon ECS

Pour créer un service Amazon ECS

Note

Important

Note

Étape 5 : Créer l'application CodeDeploy et le groupe de déploiement (plateforme de calcul ECS)

Pour créer une CodeDeploy application

Pour créer un groupe CodeDeploy de déploiement

Étape 6 : Créer le pipeline

Pour créer un pipeline à deux étapes avec l'assistant

Note

Note

Pour ajouter une action source Amazon ECR à votre pipeline

Pour relier vos artefacts source à l'action de déploiement

Note

Étape 7 : Modifier le pipeline et vérifier le déploiement