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.
# Travailler avec des déploiements dans CodeDeploy
Dans CodeDeploy, un déploiement est le processus, et les composants impliqués dans le processus, d'installation de contenu sur une ou plusieurs instances. Ce contenu peut être constitué de code, de fichiers Web et de configuration, d'exécutables, de packages, de scripts, etc. CodeDeploy déploie le contenu stocké dans un référentiel source, conformément aux règles de configuration que vous spécifiez.
Si vous utilisez la plate-forme de calcul EC2/sur site, deux déploiements sur le même ensemble d'instances peuvent s'exécuter simultanément.
CodeDeploy propose deux types de déploiement, les déploiements sur place et les déploiements bleu/vert.
+ **Déploiement sur place** : l'application de chaque instance du groupe de déploiement est arrêtée, la dernière révision de l'application est installée et la nouvelle version de l'application est démarrée et validée. Vous pouvez utiliser un équilibreur de charge afin que chaque instance soit désenregistrée pendant son déploiement, puis remise en service une fois le déploiement terminé. Seuls les déploiements qui utilisent la plate-forme informatique EC2/sur site peuvent utiliser des déploiements sur place. Pour plus d'informations sur les déploiements sur place, consultez [Vue d'ensemble d'un déploiement sur place](welcome.md#welcome-deployment-overview-in-place).
+ **Déploiement bleu/vert** : le comportement de votre déploiement dépend de la plateforme informatique que vous utilisez :
+ **Blue/green on an EC2/On-Plateforme de calcul sur site** : les instances d'un groupe de déploiement (l'environnement d'origine) sont remplacées par un ensemble d'instances différent (l'environnement de remplacement) en suivant les étapes suivantes :
+ Les instances sont provisionnées pour l'environnement de remplacement.
+ La dernière version de l'application est installée sur les instances de remplacement.
+ Un temps d'attente facultatif se produit pour des activités telles que les tests d'applications et la vérification du système.
+ Les instances de l'environnement de remplacement sont enregistrées auprès d'un ou de plusieurs équilibreurs de charge Elastic Load Balancing, ce qui entraîne le reroutage du trafic vers celles-ci. Les instances de l'environnement d'origine sont désenregistrées et peuvent être résiliées ou maintenues en cours d'exécution pour d'autres utilisations.
**Note**
Si vous utilisez une plate-forme de calcul EC2/sur site, sachez que les blue/green déploiements fonctionnent uniquement avec les instances Amazon EC2.
+ **Bleu/vert sur une plateforme de calcul AWS Lambda Amazon ECS** ou Amazon ECS : le trafic est décalé par incréments en fonction d'une configuration **canarienne**, **linéaire** ou **all-at-once**de déploiement.
+ **Déploiements bleu/vert via CloudFormation : le** trafic est transféré de vos ressources actuelles vers vos ressources mises à jour dans le cadre d'une CloudFormation mise à jour de la pile. Actuellement, seuls les blue/green déploiements ECS sont pris en charge.
Pour plus d'informations sur les blue/green déploiements, consultez[Vue d'ensemble d'un blue/green déploiement](welcome.md#welcome-deployment-overview-blue-green).
Pour plus d'informations sur le déploiement automatique depuis Amazon S3, consultez [Déploiement automatique depuis Amazon S3 à l'aide](https://aws.amazon.com/blogs/devops/automatically-deploy-from-amazon-s3-using-aws-codedeploy/) de CodeDeploy.
**Topics**
+ [Création d’un déploiement](deployments-create.md)
+ [Afficher les détails du déploiement](deployments-view-details.md)
+ [Afficher les données du journal de déploiement](deployments-view-logs.md)
+ [Arrêter un déploiement](deployments-stop.md)
+ [Redéploiement et annulation d'un déploiement](deployments-rollback-and-redeploy.md)
+ [Déployer une application dans un autre AWS compte](deployments-cross-account.md)
+ [Valider un package de déploiement sur une machine locale](deployments-local.md)
# Créez un déploiement avec CodeDeploy
Vous pouvez utiliser la CodeDeploy console AWS CLI, les API ou les CodeDeploy API pour créer un déploiement qui installe les révisions d'applications que vous avez déjà transférées vers Amazon S3 ou, si votre déploiement concerne une plateforme de calcul EC2/sur site GitHub, sur les instances d'un groupe de déploiement.
Le processus de création d'un déploiement dépend de la plate-forme de calcul utilisée par votre déploiement.
**Topics**
+ [Conditions préalables au déploiement](deployments-create-prerequisites.md)
+ [Création d'un déploiement d'Amazon ECS Compute Platform (console)](deployments-create-console-ecs.md)
+ [Création d'un déploiement de plateforme de calcul AWS Lambda (console)](deployments-create-console-lambda.md)
+ [Création d'un déploiement de plate-forme de calcul EC2/sur site (console)](deployments-create-console.md)
+ [Création d'un déploiement de plate-forme de calcul Amazon ECS (CLI)](deployments-create-ecs-cli.md)
+ [Création d'un déploiement de plateforme de calcul AWS Lambda (CLI)](deployments-create-lambda-cli.md)
+ [Création d'un déploiement de plate-forme de calcul EC2/sur site (CLI)](deployments-create-cli.md)
+ [Créez un blue/green déploiement Amazon ECS via CloudFormation](deployments-create-ecs-cfn.md)
# Conditions préalables au déploiement
Assurez-vous d'effectuer les étapes suivantes avant de lancer un déploiement.
## Conditions préalables au déploiement sur une plateforme AWS Lambda informatique
+ Créez une application qui inclut au moins un groupe de déploiement. Pour plus d’informations, consultez [Créez une application avec CodeDeploy](applications-create.md) et [Créez un groupe de déploiement avec CodeDeploy](deployment-groups-create.md).
+ Préparez la révision de l'application, également appelée AppSpec fichier, qui spécifie la version de la fonction Lambda que vous souhaitez déployer. Le AppSpec fichier peut également spécifier des fonctions Lambda pour valider votre déploiement. Pour de plus amples informations, veuillez consulter [Travailler avec les révisions d'applications pour CodeDeploy](application-revisions.md).
+ Si vous souhaitez utiliser une configuration de déploiement personnalisée pour votre déploiement, créez-la avant de commencer le processus de déploiement. Pour plus d'informations, consultez [Créez une configuration de déploiement avec CodeDeploy](deployment-configurations-create.md).
## Conditions préalables au déploiement sur une plate-forme informatique EC2/sur site
+ Pour un déploiement sur place, créez ou configurez les instances sur lesquelles vous souhaitez effectuer le déploiement. Pour plus d'informations, consultez [Utilisation d'instances pour CodeDeploy](instances.md). Pour un blue/green déploiement, vous avez soit un groupe Amazon EC2 Auto Scaling existant à utiliser comme modèle pour votre environnement de remplacement, soit une ou plusieurs instances ou groupes Amazon EC2 Auto Scaling que vous spécifiez comme environnement d'origine. Pour plus d’informations, consultez [Tutoriel : CodeDeploy À utiliser pour déployer une application dans un groupe Auto Scaling](tutorials-auto-scaling-group.md) et [Intégration CodeDeploy à Amazon EC2 Auto Scaling](integrations-aws-auto-scaling.md).
+ Créez une application qui inclut au moins un groupe de déploiement. Pour plus d’informations, consultez [Créez une application avec CodeDeploy](applications-create.md) et [Créez un groupe de déploiement avec CodeDeploy](deployment-groups-create.md).
+ Préparez la révision d'application que vous souhaitez déployer vers les instances de votre groupe de déploiement. Pour plus d'informations, consultez [Travailler avec les révisions d'applications pour CodeDeploy](application-revisions.md).
+ Si vous souhaitez utiliser une configuration de déploiement personnalisée pour votre déploiement, créez-la avant de commencer le processus de déploiement. Pour plus d'informations, consultez [Créez une configuration de déploiement avec CodeDeploy](deployment-configurations-create.md).
+ Si vous déployez la révision de votre application à partir d'un compartiment Amazon S3, celui-ci se trouve dans la même AWS région que les instances de votre groupe de déploiement.
+ Si vous déployez la révision de votre application à partir d'un compartiment Amazon S3, une politique de compartiment Amazon S3 a été appliquée au compartiment. Cette stratégie accorde à vos instances les autorisations requises pour télécharger la révision d'application.
Par exemple, la politique de compartiment Amazon S3 suivante permet à toute instance Amazon EC2 associée à un profil d'instance IAM contenant l'ARN de `arn:aws:iam::444455556666:role/CodeDeployDemo` télécharger n'importe où dans le compartiment Amazon S3 nommé : `amzn-s3-demo-bucket`
```
{
"Statement": [
{
"Action": [
"s3:Get*",
"s3:List*"
],
"Effect": "Allow",
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*",
"Principal": {
"AWS": [
"arn:aws:iam::444455556666:role/CodeDeployDemo"
]
}
}
]
}
```
La politique de compartiment Amazon S3 suivante permet à toute instance sur site associée à un utilisateur IAM contenant l'ARN de `arn:aws:iam::444455556666:user/CodeDeployUser` télécharger depuis n'importe quel emplacement du compartiment Amazon S3 nommé : `amzn-s3-demo-bucket`
```
{
"Statement": [
{
"Action": [
"s3:Get*",
"s3:List*"
],
"Effect": "Allow",
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*",
"Principal": {
"AWS": [
"arn:aws:iam::444455556666:user/CodeDeployUser"
]
}
}
]
}
```
Pour plus d'informations sur la façon de générer et d'associer une politique de compartiment Amazon S3, consultez les [exemples de politique de compartiment](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html).
+ Si vous créez un blue/green déploiement, ou si vous avez spécifié un Classic Load Balancer, une Application Load Balancer ou un Network Load Balancer en option dans le groupe de déploiement pour un déploiement sur place, vous avez créé un VPC à l'aide d'Amazon VPC contenant au moins deux sous-réseaux. (CodeDeploy utilise Elastic Load Balancing, qui exige que toutes les instances d'un groupe d'équilibreurs de charge se trouvent dans un seul VPC.)
Si vous n'avez pas encore créé de VPC, consultez le guide de [démarrage Amazon VPC.](https://docs.aws.amazon.com/AmazonVPC/latest/GettingStartedGuide/ExerciseOverview.html)
+ Si vous créez un blue/green déploiement, vous avez configuré au moins un Classic Load Balancer, un Application Load Balancer ou un Network Load Balancer dans Elastic Load Balancing et vous l'avez utilisé pour enregistrer les instances qui constituent votre environnement d'origine.
**Note**
Les instances de votre environnement de remplacement sont inscrites auprès de l'équilibreur de charge plus tard.
Pour plus d'informations sur la configuration d'un équilibreur de charge[Configuration d'un équilibreur de charge dans Elastic Load Balancing pour les déploiements CodeDeploy Amazon EC2](deployment-groups-create-load-balancer.md), reportez-vous aux sections et[Configuration d'un équilibreur de charge, de groupes cibles et d'écouteurs pour les déploiements CodeDeploy Amazon ECS](deployment-groups-create-load-balancer-for-ecs.md).
## Conditions préalables au déploiement pour un blue/green déploiement via CloudFormation
+ Votre modèle n'a pas besoin de modéliser les ressources d'une CodeDeploy application ou d'un groupe de déploiement.
+ Votre modèle doit inclure des ressources pour un VPC utilisant Amazon VPC contenant au moins deux sous-réseaux.
+ Votre modèle doit inclure des ressources pour un ou plusieurs équilibreurs de charge classiques, applicatifs ou équilibreurs de charge réseau dans Elastic Load Balancing utilisés pour diriger le trafic vers vos groupes cibles.
# Création d'un déploiement d'Amazon ECS Compute Platform (console)
Cette rubrique explique comment déployer un service Amazon ECS à l'aide de la console. Pour plus d’informations, consultez [Tutoriel : Déployer une application dans Amazon ECS](tutorial-ecs-deployment.md) et [Tutoriel : Déployer un service Amazon ECS avec un test de validation](tutorial-ecs-deployment-with-hooks.md).
1. Connectez-vous à la CodeDeploy console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/codedeploy.](https://console.aws.amazon.com/codedeploy)
**Note**
Connectez-vous avec le même utilisateur que celui que vous avez configuré[Commencer avec CodeDeploy](getting-started-codedeploy.md).
1. Effectuez l’une des actions suivantes :
+ Si vous souhaitez déployer une application, dans le volet de navigation, développez **Déployer**, puis choisissez **Applications**. Choisissez le nom de l'application que vous souhaitez déployer. Assurez-vous que la colonne **Plateforme de calcul** de votre application est **Amazon ECS**.
+ Si vous souhaitez redéployer un déploiement dans le volet de navigation, développez **Déployer**, puis choisissez **Déploiements**. Choisissez le déploiement que vous souhaitez redéployez et, dans la colonne **Application**, choisissez le nom de son application. Assurez-vous que la colonne **Plateforme de calcul** de votre déploiement est **Amazon ECS**.
1. Sur l'onglet **Déploiements**, choisissez **Créer un déploiement**.
**Note**
Votre application doit disposer d'un groupe de déploiement avant de pouvoir être déployée. Si votre application ne possède pas de groupe de déploiement, dans l'onglet **Groupes de déploiement**, choisissez **Créer un groupe de déploiement**. Pour de plus amples informations, veuillez consulter [Créez un groupe de déploiement avec CodeDeploy](deployment-groups-create.md).
1. Dans **Groupe de déploiement**, choisissez un groupe de déploiement à utiliser pour ce déploiement.
1. En regard de **Emplacement de la révision**, choisissez l'emplacement où est stockée votre révision :
+ **Mon application est stockée dans Amazon S3**. Pour plus d'informations, reportez-vous à l'étape 6[Spécifiez les informations relatives à une révision stockée dans un compartiment Amazon S3](deployments-create-console-s3.md), puis revenez à cette étape.
+ **Utiliser l' AppSpec éditeur** : sélectionnez JSON ou YAML, puis entrez votre AppSpec fichier dans l'éditeur. Vous pouvez enregistrer le AppSpec fichier en choisissant **Enregistrer sous forme de fichier texte**. Lorsque vous choisissez **Déployer** à la fin de ces étapes, vous recevez une erreur si votre code JSON ou YAML n'est pas valide. Pour plus d'informations sur la création d'un AppSpec fichier, consultez[Ajouter un fichier de spécification d'application à une révision pour CodeDeploy](application-revisions-appspec-file.md).
1. (Facultatif) Dans la zone **Description du déploiement**, entrez une description pour ce déploiement.
1. (Facultatif) Dans **Remplacements de la configuration de restauration**, vous pouvez spécifier pour ce déploiement des options de restauration automatique différentes de celles spécifiées pour le groupe de déploiement, le cas échéant.
Pour plus d'informations sur les annulations CodeDeploy, reportez-vous aux sections [Redéploiements et annulations de déploiements](deployment-steps-lambda.md#deployment-rollback-lambda) et[Redéployez et annulez un déploiement avec CodeDeploy](deployments-rollback-and-redeploy.md).
Choisissez parmi les options suivantes :
+ **Annulation en cas d'échec d'un déploiement** : CodeDeploy redéploie la dernière révision valide connue en tant que nouveau déploiement.
+ **Annulation lorsque les seuils d'alarme sont atteints** : si des alarmes ont été ajoutées au groupe de déploiement, CodeDeploy redéploie la dernière révision valide connue lorsqu'une ou plusieurs des alarmes spécifiées sont activées.
+ **Désactiver les annulations** : n'effectuez pas de annulations pour ce déploiement.
1. Choisissez **Créer un déploiement**.
Pour suivre le statut de votre déploiement, consultez [Afficher les détails CodeDeploy du déploiement](deployments-view-details.md).
# Création d'un déploiement de plateforme de calcul AWS Lambda (console)
Cette rubrique explique comment déployer une fonction Lambda à l'aide de la console.
1. Connectez-vous à la CodeDeploy console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/codedeploy.](https://console.aws.amazon.com/codedeploy)
**Note**
Connectez-vous avec le même utilisateur que celui que vous avez configuré[Commencer avec CodeDeploy](getting-started-codedeploy.md).
1. Effectuez l’une des actions suivantes :
+ Si vous souhaitez déployer une application, dans le volet de navigation, développez **Déployer**, puis choisissez **Applications**. Choisissez le nom de l'application que vous souhaitez déployer. Assurez-vous que la colonne **Plateforme de calcul** de votre application est **AWS Lambda**.
+ Si vous souhaitez redéployer un déploiement dans le volet de navigation, développez **Déployer**, puis choisissez **Déploiements**. Choisissez le déploiement que vous souhaitez redéployez et, dans la colonne **Application**, choisissez le nom de son application. Assurez-vous que la colonne **Plateforme de calcul** de votre déploiement est **AWS Lambda**.
1. Sur l'onglet **Déploiements**, choisissez **Créer un déploiement**.
**Note**
Votre application doit disposer d'un groupe de déploiement avant de pouvoir être déployée. Si votre application ne possède pas de groupe de déploiement, dans l'onglet **Groupes de déploiement**, choisissez **Créer un groupe de déploiement**. Pour de plus amples informations, veuillez consulter [Créez un groupe de déploiement avec CodeDeploy](deployment-groups-create.md).
1. Dans **Groupe de déploiement**, choisissez un groupe de déploiement à utiliser pour ce déploiement.
1. En regard de **Emplacement de la révision**, choisissez l'emplacement où est stockée votre révision :
+ **Mon application est stockée dans Amazon S3**. Pour plus d'informations, reportez-vous à l'étape 6[Spécifiez les informations relatives à une révision stockée dans un compartiment Amazon S3](deployments-create-console-s3.md), puis revenez à cette étape.
+ **Utiliser l' AppSpec éditeur** : sélectionnez JSON ou YAML, puis entrez votre AppSpec fichier dans l'éditeur. Vous pouvez enregistrer le AppSpec fichier en choisissant **Enregistrer sous forme de fichier texte**. Lorsque vous choisissez **Déployer** à la fin de ces étapes, vous recevez une erreur si votre code JSON ou YAML n'est pas valide. Pour plus d'informations sur la création d'un AppSpec fichier, consultez[Ajouter un fichier de spécification d'application à une révision pour CodeDeploy](application-revisions-appspec-file.md).
1. (Facultatif) Dans la zone **Description du déploiement**, entrez une description pour ce déploiement.
1. (Facultatif) Développez les **remplacements des groupes** de déploiement pour choisir une configuration de déploiement afin de contrôler la manière dont le trafic est transféré vers la version de la fonction Lambda différente de celle spécifiée dans le groupe de déploiement.
Pour de plus amples informations, veuillez consulter [Configurations de déploiement sur une plateforme AWS Lambda informatique](deployment-configurations.md#deployment-configuration-lambda).
1. (Facultatif) Dans **Remplacements de la configuration de restauration**, vous pouvez spécifier pour ce déploiement des options de restauration automatique différentes de celles spécifiées pour le groupe de déploiement, le cas échéant.
Pour plus d'informations sur les annulations CodeDeploy, reportez-vous aux sections [Redéploiements et annulations de déploiements](deployment-steps-lambda.md#deployment-rollback-lambda) et[Redéployez et annulez un déploiement avec CodeDeploy](deployments-rollback-and-redeploy.md).
Choisissez parmi les options suivantes :
+ **Annulation en cas d'échec d'un déploiement** : CodeDeploy redéploie la dernière révision valide connue en tant que nouveau déploiement.
+ **Annulation lorsque les seuils d'alarme sont atteints** : si des alarmes ont été ajoutées au groupe de déploiement, CodeDeploy redéploie la dernière révision valide connue lorsqu'une ou plusieurs des alarmes spécifiées sont activées.
+ **Désactiver les annulations** : n'effectuez pas de annulations pour ce déploiement.
1. Choisissez **Créer un déploiement**.
Pour suivre le statut de votre déploiement, consultez [Afficher les détails CodeDeploy du déploiement](deployments-view-details.md).
# Création d'un déploiement de plate-forme de calcul EC2/sur site (console)
Cette rubrique explique comment déployer une application sur un serveur Amazon EC2 ou sur site à l'aide de la console.
1. Connectez-vous à la CodeDeploy console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/codedeploy.](https://console.aws.amazon.com/codedeploy)
**Note**
Connectez-vous avec le même utilisateur que celui que vous avez configuré[Commencer avec CodeDeploy](getting-started-codedeploy.md).
1. Effectuez l’une des actions suivantes :
+ Si vous souhaitez déployer une application, dans le volet de navigation, développez **Déployer**, puis choisissez **Applications**. Choisissez le nom de l'application que vous souhaitez déployer. Assurez-vous que la colonne **Plateforme de calcul** de votre application est **EC2/On-premises**.
+ Si vous souhaitez redéployer un déploiement dans le volet de navigation, développez **Déployer**, puis choisissez **Déploiements**. Recherchez le déploiement que vous souhaitez redéployez, puis choisissez le nom de son application dans la colonne **Application**. Assurez-vous que la colonne **Plateforme de calcul** de votre déploiement est **EC2/on-premises**.
1. Sur l'onglet **Déploiements**, choisissez **Créer un déploiement**.
**Note**
Votre application doit disposer d'un groupe de déploiement avant de pouvoir être déployée. Si votre application ne possède pas de groupe de déploiement, dans l'onglet **Groupes de déploiement**, choisissez **Créer un groupe de déploiement**. Pour de plus amples informations, veuillez consulter [Créez un groupe de déploiement avec CodeDeploy](deployment-groups-create.md).
1. Dans **Groupe de déploiement**, choisissez un groupe de déploiement à utiliser pour ce déploiement.
1. En regard de **Type de référentiel**, choisissez le type de référentiel dans lequel la révision est stockée :
+ **Mon application est stockée dans Amazon S3**. Pour plus d'informations, reportez-vous à l'étape 6[Spécifiez les informations relatives à une révision stockée dans un compartiment Amazon S3](deployments-create-console-s3.md), puis revenez à cette étape.
+ **Ma demande est stockée dans GitHub** — Pour plus d'informations, reportez-vous à l'étape 6[Spécifier les informations relatives à une révision stockée dans un GitHub référentiel](deployments-create-console-github.md), puis revenez à l'étape 6.
1. (Facultatif) Dans la zone **Description du déploiement**, entrez une description pour ce déploiement.
1. (Facultatif) Développez la **configuration de déploiement Override** pour choisir une configuration de déploiement différente de celle spécifiée dans le groupe de déploiement afin de contrôler la manière dont le trafic est transféré vers le serveur Amazon EC2 ou sur site.
Pour de plus amples informations, veuillez consulter [Utilisation des configurations de déploiement dans CodeDeploy](deployment-configurations.md).
1.
1. Sélectionnez **Ne pas échouer le déploiement si l'événement du ApplicationStop cycle de vie échoue** si vous souhaitez que le déploiement sur une instance réussisse en cas d'échec de l'événement `ApplicationStop` du cycle de vie.
1. Développez **les paramètres de comportement de déploiement supplémentaires** pour spécifier CodeDeploy le mode de gestion des fichiers dans un emplacement cible de déploiement qui ne faisaient pas partie du déploiement réussi précédent.
Choisissez parmi les options suivantes :
+ **Échec du déploiement** : une erreur est signalée et l'état du déploiement est changé en`Failed`.
+ **Remplacer le contenu** : si un fichier du même nom existe à l'emplacement cible, la version de la révision de l'application le remplace.
+ **Conserver le contenu** : si un fichier du même nom existe à l'emplacement cible, le fichier est conservé et la version de la révision de l'application n'est pas copiée sur l'instance.
Pour de plus amples informations, veuillez consulter [Comportement d'annulation avec du contenu existant](deployments-rollback-and-redeploy.md#deployments-rollback-and-redeploy-content-options).
1. (Facultatif) Dans **Remplacements de la configuration de restauration**, vous pouvez spécifier pour ce déploiement des options de restauration automatique différentes de celles spécifiées pour le groupe de déploiement, le cas échéant.
Pour plus d'informations sur les annulations CodeDeploy, reportez-vous aux sections [Redéploiements et annulations de déploiements](deployment-steps-server.md#deployment-rollback) et[Redéployez et annulez un déploiement avec CodeDeploy](deployments-rollback-and-redeploy.md).
Choisissez parmi les options suivantes :
+ **Annulation en cas d'échec d'un déploiement** : CodeDeploy redéploie la dernière révision valide connue en tant que nouveau déploiement.
+ **Annulation lorsque les seuils d'alarme sont atteints** : si des alarmes ont été ajoutées au groupe de déploiement, CodeDeploy déploie la dernière révision correcte connue lorsqu'une ou plusieurs des alarmes spécifiées sont activées.
+ **Désactiver les annulations** : n'effectuez pas de annulations pour ce déploiement.
1. Choisissez **Démarrer le déploiement**.
Pour suivre le statut de votre déploiement, consultez [Afficher les détails CodeDeploy du déploiement](deployments-view-details.md).
**Topics**
+ [Spécifiez les informations relatives à une révision stockée dans un compartiment Amazon S3](deployments-create-console-s3.md)
+ [Spécifier les informations relatives à une révision stockée dans un GitHub référentiel](deployments-create-console-github.md)
# Spécifiez les informations relatives à une révision stockée dans un compartiment Amazon S3
Si vous suivez les étapes décrites dans[Création d'un déploiement de plate-forme de calcul EC2/sur site (console)](deployments-create-console.md), suivez ces étapes pour ajouter des informations sur une révision d'application stockée dans un compartiment Amazon S3.
1. Copiez le lien Amazon S3 de votre révision dans l'**emplacement de la révision**. Pour trouver la valeur du lien :
1. Dans un onglet de navigateur distinct :
Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
Recherchez et choisissez votre révision.
1. Si le volet **Propriétés** n'est pas visible, choisissez le bouton **Propriétés**.
1. Dans le volet **Propriétés**, copiez la valeur du champ **Lien** dans le champ **Emplacement des révisions** de la CodeDeploy console.
Pour spécifier un ETag (une somme de contrôle de fichier) dans le cadre de l'emplacement des révisions :
+ Si la valeur du champ **Lien** se termine par**?versionId=*versionId***, ajoutez **&etag=** et ETag à la fin de la valeur du champ **Lien**.
+ Si la valeur du champ **Lien** ne spécifie pas d'ID de version, ajoutez **?etag=** et ETag à la fin de la valeur du champ **Lien**.
**Note**
Cela n'est pas aussi aisé que de copier la valeur du champ **Lien**, mais vous pouvez également entrer l'emplacement de la révision dans l'un des formats suivants :
**s3://*bucket-name*/*folders*/*objectName***
**s3://*bucket-name*/*folders*/*objectName*?versionId=*versionId***
**s3://*bucket-name*/*folders*/*objectName*?etag=*etag***
**s3://*bucket-name*/*folders*/*objectName*?versionId=*versionId*&etag=*etag***
***bucket-name*.s3.amazonaws.com/*folders*/*objectName***
1. Si un message s'affiche dans la liste **Type de fichier**, indiquant que le type de fichier n'a pas pu être détecté, choisissez le type de fichier de la révision. Sinon, acceptez le type de fichier détecté.
# Spécifier les informations relatives à une révision stockée dans un GitHub référentiel
Si vous suivez les étapes décrites dans[Création d'un déploiement de plate-forme de calcul EC2/sur site (console)](deployments-create-console.md), procédez comme suit pour ajouter des informations sur une révision d'application stockée dans un GitHub référentiel.
1. Dans **Connect to GitHub**, effectuez l'une des opérations suivantes :
+ Pour créer une connexion entre CodeDeploy les applications et un GitHub compte, dans un autre onglet du navigateur Web, déconnectez-vous GitHub. Dans le **GitHub compte**, entrez un nom pour identifier cette connexion, puis choisissez **Connect to GitHub**. La page Web vous invite CodeDeploy à autoriser l'interaction avec GitHub votre application. Passez à l'étape 2.
+ Pour utiliser une connexion que vous avez déjà créée, dans le **GitHubcompte**, sélectionnez son nom, puis choisissez **Connect to GitHub**. Passez à l'étape 4.
+ Pour créer une connexion à un autre GitHub compte, dans un autre onglet du navigateur Web, déconnectez-vous GitHub. Choisissez **Se connecter à un autre GitHub compte**, puis sélectionnez **Connect to GitHub**. Passez à l'étape 2.
1. Si vous êtes invité à vous connecter à GitHub, suivez les instructions de la page **de connexion**. Connectez-vous à l'aide de votre nom GitHub d'utilisateur ou de votre adresse e-mail et de votre mot de passe.
1. Si une page **Authorize application** s'affiche, choisissez **Authorize application**.
1. Sur la page **Créer un déploiement**, dans le champ **Nom du référentiel**, entrez le nom de l' GitHub utilisateur ou de l'organisation contenant la révision, suivi d'une barre oblique (`/`), puis du nom du référentiel contenant la révision. Si vous n'êtes pas sûr de la valeur à saisir :
1. Dans un autre onglet de navigateur Web, accédez à votre [GitHubtableau de bord](https://github.com/dashboard).
1. Dans **Your repositories**, placez le pointeur de la souris sur le nom du référentiel cible. Une infobulle apparaît, affichant le nom de l' GitHub utilisateur ou de l'organisation, suivi d'une barre oblique (`/`), puis du nom du référentiel. Saisissez la valeur affichée dans la zone **Nom du référentiel**.
**Note**
Si le nom du référentiel cible n'est pas visible dans **Vos référentiels**, utilisez la GitHub zone de **recherche** pour trouver le nom du référentiel cible et le nom de GitHub l'utilisateur ou de l'organisation.
1. Dans la zone **ID de validation**, saisissez l'ID de la validation qui fait référence à la révision figurant dans le référentiel. Si vous n'êtes pas sûr de la valeur à saisir :
1. Dans un autre onglet de navigateur Web, accédez à votre [GitHubtableau de bord](https://github.com/dashboard).
1. Dans **Your repositories**, choisissez le nom de référentiel qui contient la validation cible.
1. Dans la liste des validations, recherchez et copiez l'ID de validation qui fait référence à la révision figurant dans le référentiel. Cet ID contient généralement 40 caractères et se compose de lettres et de chiffres. (N'utilisez pas la version courte de l'ID de validation, qui correspond généralement aux 10 premiers caractères de la version longue.)
1. Collez l'ID de validation dans la zone **ID de validation**.
# Création d'un déploiement de plate-forme de calcul Amazon ECS (CLI)
Après avoir créé l'application et la révision (dans les déploiements Amazon ECS, il s'agit du AppSpec fichier) :
Appelez la commande [create-deployment](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html) en spécifiant :
+ Un nom d'application. Pour afficher la liste des noms d'applications, appelez la commande [list-applications.](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-applications.html)
+ Un nom de groupe de déploiement. Pour afficher la liste des noms des groupes de déploiement, appelez la commande [list-deployment-groups](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-groups.html).
+ Des informations sur la révision à déployer :
Pour les révisions stockées dans Amazon S3 :
+ Le nom du compartiment Amazon S3 qui contient la révision.
+ Le nom de la révision chargée.
+ (Facultatif) L'identifiant de version Amazon S3 pour la révision. (Si l'identifiant de version n'est pas spécifié, CodeDeploy utilise la version la plus récente.)
+ (Facultatif) Le ETag pour la révision. (Si le n' ETag est pas spécifié, CodeDeploy ignore la validation de l'objet.)
Pour les révisions stockées dans un fichier qui ne figure pas dans Amazon S3, vous avez besoin du nom du fichier et de son chemin. Votre fichier de révision est écrit en JSON ou YAML, il est donc très probable que son extension soit .json ou .yaml.
+ (Facultatif) Une description du déploiement.
Le fichier de révision peut être spécifié sous forme de fichier chargé dans un compartiment Amazon S3 ou sous forme de chaîne. La syntaxe des deux options dans le cadre d'une utilisation de la commande **create-deployment** est :
+ Compartiment Amazon S3 :
La `version` et l'`eTag` sont facultatifs.
```
--s3-location bucket=string,key=string,bundleType=JSON|YAML,version=string,eTag=string
```
+ Chaîne :
```
--revision '{"revisionType": "String", "string": {"content":"revision-as-string"}}'
```
**Note**
La commande **create-deployment** permet de charger une révision à partir d'un fichier. Pour de plus amples informations, veuillez consulter [Chargement des paramètres à partir d'un fichier](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html#cli-using-param-file).
Pour les modèles de révision de AWS Lambda déploiement, voir[Ajouter un AppSpec fichier pour un déploiement AWS Lambda](application-revisions-appspec-file.md#add-appspec-file-lambda). Pour obtenir un exemple de révision, consultez [AppSpec Exemple de fichier pour un déploiement AWS Lambda](reference-appspec-file-example.md#appspec-file-example-lambda).
Pour suivre le statut de votre déploiement, consultez [Afficher les détails CodeDeploy du déploiement](deployments-view-details.md).
# Création d'un déploiement de plateforme de calcul AWS Lambda (CLI)
Après avoir créé l'application et la révision (dans les déploiements AWS Lambda, il s'agit du AppSpec fichier) :
Appelez la commande [create-deployment](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html) en spécifiant :
+ Un nom d'application. Pour afficher la liste des noms d'applications, appelez la commande [list-applications.](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-applications.html)
+ Un nom de groupe de déploiement. Pour afficher la liste des noms des groupes de déploiement, appelez la commande [list-deployment-groups](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-groups.html).
+ Des informations sur la révision à déployer :
Pour les révisions stockées dans Amazon S3 :
+ Le nom du compartiment Amazon S3 qui contient la révision.
+ Le nom de la révision chargée.
+ (Facultatif) L'identifiant de version Amazon S3 pour la révision. (Si l'identifiant de version n'est pas spécifié, CodeDeploy utilise la version la plus récente.)
+ (Facultatif) Le ETag pour la révision. (Si le n' ETag est pas spécifié, CodeDeploy ignore la validation de l'objet.)
Pour les révisions stockées dans un fichier qui ne figure pas dans Amazon S3, vous avez besoin du nom du fichier et de son chemin. Votre fichier de révision est écrit en JSON ou YAML, il est donc très probable que son extension soit .json ou .yaml.
+ (Facultatif) Le nom d'une configuration de déploiement à utiliser. Pour afficher la liste des configurations de déploiement, appelez la commande [list-deployment-configs](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-configs.html). (Si ce n'est pas spécifié, CodeDeploy utilise une configuration de déploiement par défaut spécifique.)
+ (Facultatif) Une description du déploiement.
Le fichier de révision peut être spécifié sous forme de fichier chargé dans un compartiment Amazon S3 ou sous forme de chaîne. La syntaxe des deux options dans le cadre d'une utilisation de la commande **create-deployment** est :
+ Compartiment Amazon S3 :
La `version` et l'`eTag` sont facultatifs.
```
--s3-location bucket=string,key=string,bundleType=JSON|YAML,version=string,eTag=string
```
+ Chaîne :
```
--revision '{"revisionType": "String", "string": {"content":"revision-as-string"}}'
```
**Note**
La commande **create-deployment** permet de charger une révision à partir d'un fichier. Pour de plus amples informations, veuillez consulter [Chargement des paramètres à partir d'un fichier](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html#cli-using-param-file).
Pour les modèles de révision de AWS Lambda déploiement, voir[Ajouter un AppSpec fichier pour un déploiement AWS Lambda](application-revisions-appspec-file.md#add-appspec-file-lambda). Pour obtenir un exemple de révision, consultez [AppSpec Exemple de fichier pour un déploiement AWS Lambda](reference-appspec-file-example.md#appspec-file-example-lambda).
Pour suivre le statut de votre déploiement, consultez [Afficher les détails CodeDeploy du déploiement](deployments-view-details.md).
# Création d'un déploiement de plate-forme de calcul EC2/sur site (CLI)
Pour utiliser le AWS CLI pour déployer une révision de la plate-forme de calcul EC2/sur site :
1. Une fois que vous avez préparé les instances, créé l'application et transmis la révision, effectuez l'une des actions suivantes :
+ Si vous souhaitez déployer une révision à partir d'un compartiment Amazon S3, passez à l'étape 2 dès maintenant.
+ Si vous souhaitez déployer une révision à partir d'un GitHub référentiel, suivez d'abord les étapes décrites[Connect une CodeDeploy application à un GitHub référentiel](deployments-create-cli-github.md), puis passez à l'étape 2.
1. Appelez la commande [create-deployment](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html) en spécifiant :
+ `--application-name`: nom de l'application. Pour afficher la liste des noms d'applications, appelez la commande [list-applications.](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-applications.html)
+ `--deployment-group-name`: nom du groupe de déploiement Amazon EC2. Pour afficher la liste des noms des groupes de déploiement, appelez la commande [list-deployment-groups](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-groups.html).
+ `--revision`: Informations sur la révision à déployer :
Pour les révisions stockées dans Amazon S3 :
+ `s3Location`: le nom du compartiment Amazon S3 qui contient la révision.
+ `s3Location --> key`: nom de la révision téléchargée.
+ `s3Location --> bundleType`: le type de fichier de la révision téléchargée.
**Note**
Les formats de fichier d'archive tar et tar compressé (.tar et .tar.gz) ne sont pas pris en charge pour les instances Windows Server.
+ `s3Location --> version`: (Facultatif) L'identifiant de version Amazon S3 pour la révision. (Si l'identifiant de version n'est pas spécifié, CodeDeploy utilise la version la plus récente.)
+ `s3Location --> eTag`: (Facultatif) Le ETag pour la révision. (Si le n' ETag est pas spécifié, CodeDeploy ignore la validation de l'objet.)
Pour les révisions stockées dans GitHub :
+ `gitHubLocation --> repository`: nom GitHub d'utilisateur ou de groupe attribué au référentiel contenant la révision, suivi d'une barre oblique (`/`), puis du nom du référentiel.
+ `gitHubLocation --> commitId`: ID de validation pour la révision.
+ `--deployment-config-name`: (Facultatif) Le nom de la configuration de déploiement à utiliser. Pour afficher la liste des configurations de déploiement, appelez la commande [list-deployment-configs](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-configs.html). (Si ce n'est pas spécifié, CodeDeploy utilise une configuration de déploiement par défaut spécifique.)
+ `--ignore-application-stop-failures | --no-ignore-application-stop-failures`: (Facultatif) Si vous souhaitez que le déploiement sur une instance se poursuive jusqu'à l'événement du cycle de vie du `BeforeInstall` déploiement en cas d'échec de l'événement du cycle de vie du `ApplicationStop` déploiement.
+ `--description`: (Facultatif) Description du déploiement.
+ `--file-exists-behavior`: (Facultatif) Dans le cadre du processus de déploiement, l' CodeDeploy agent supprime de chaque instance tous les fichiers installés lors du déploiement le plus récent. Choisissez ce qui se passe lorsque des fichiers qui ne faisaient pas partie d'un déploiement précédent apparaissent dans les emplacements de déploiement cibles.
+ `--target-instances`: pour blue/green les déploiements, informations sur les instances appartenant à l'environnement de remplacement dans un blue/green déploiement, y compris les noms d'un ou de plusieurs groupes Amazon EC2 Auto Scaling, ou la clé de filtre de balise, le type et la valeur utilisés pour identifier les instances Amazon EC2.
**Note**
Utilisez cette syntaxe dans le cadre de l'**create-deployment**appel pour spécifier les informations relatives à une révision dans Amazon S3 directement sur la ligne de commande. (`version` et `eTag` sont facultatifs.)
```
--s3-location bucket=string,key=string,bundleType=tar|tgz|zip,version=string,eTag=string
```
Utilisez cette syntaxe dans le cadre de l'**create-deployment**appel pour spécifier les informations relatives à une révision GitHub directement sur la ligne de commande :
```
--github-location repository=string,commitId=string
```
Pour obtenir des informations sur les révisions qui ont déjà été transmises en mode push, appelez la commande [list-application-revisions](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-application-revisions.html).
Pour suivre le statut de votre déploiement, consultez [Afficher les détails CodeDeploy du déploiement](deployments-view-details.md).
## référence de commande create-deployment
Vous trouverez ci-dessous la structure de commande et les options de la `create-deployment` commande. Pour plus d'informations, consultez la référence de [création et de déploiement](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html) dans la référence des *AWS CLI commandes*.
```
create-deployment
--application-name
[--deployment-group-name ]
[--revision ]
[--deployment-config-name ]
[--description ]
[--ignore-application-stop-failures | --no-ignore-application-stop-failures]
[--target-instances ]
[--auto-rollback-configuration ]
[--update-outdated-instances-only | --no-update-outdated-instances-only]
[--file-exists-behavior ]
[--s3-location ]
[--github-location ]
[--cli-input-json ]
[--generate-cli-skeleton ]
```
# Connect une CodeDeploy application à un GitHub référentiel
Avant de déployer une application à partir d'un GitHub référentiel pour la première fois à l'aide du AWS CLI, vous devez d'abord CodeDeploy autoriser l'interaction GitHub au nom de votre GitHub compte. Cette étape doit être effectuée une fois pour chaque application utilisant la CodeDeploy console.
1. Connectez-vous à la CodeDeploy console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/codedeploy.](https://console.aws.amazon.com/codedeploy)
**Note**
Connectez-vous avec le même utilisateur que celui que vous avez configuré[Commencer avec CodeDeploy](getting-started-codedeploy.md).
1. Choisissez **Applications**.
1. Dans **Applications**, choisissez l'application que vous souhaitez associer à votre compte GitHub utilisateur, puis choisissez **Déployer l'application**.
**Note**
Vous ne créez pas de déploiement. C'est actuellement le seul moyen de donner CodeDeploy l'autorisation d'interagir avec vous GitHub au nom de votre compte GitHub utilisateur.
1. À côté de **Type de référentiel**, choisissez **Ma révision d'application est stockée dans GitHub**.
1. Choisissez **Connect to GitHub**.
**Note**
Si le lien **Connect to a different account (Connexion à un autre GitHub compte**) s'affiche :
Vous êtes peut-être déjà autorisé CodeDeploy à interagir avec GitHub l'application au nom d'un autre GitHub compte.
Vous avez peut-être révoqué l'autorisation CodeDeploy d'interagir avec GitHub le compte connecté pour toutes les applications liées à ce GitHub compte. CodeDeploy
Pour de plus amples informations, veuillez consulter [GitHub authentification avec des applications dans CodeDeploy](integrations-partners-github.md#behaviors-authentication).
1. Si vous n'êtes pas encore connecté à GitHub, suivez les instructions de la page **de connexion**.
1. Sur la page **Authorize application**, choisissez **Authorize application**.
1. Maintenant CodeDeploy que vous y êtes autorisé, choisissez **Annuler** et poursuivez les étapes ci-dessous[Création d'un déploiement de plate-forme de calcul EC2/sur site (CLI)](deployments-create-cli.md).
# Créez un blue/green déploiement Amazon ECS via CloudFormation
Vous pouvez l'utiliser AWS CloudFormation pour gérer les blue/green déploiements Amazon ECS via CodeDeploy. Vous générez votre déploiement en définissant vos ressources vertes et bleues et en spécifiant les paramètres de routage et de stabilisation du trafic à utiliser dans CloudFormation. Cette rubrique décrit les différences entre les blue/green déploiements Amazon ECS gérés par CodeDeploy et les déploiements gérés par. CloudFormation
*Pour step-by-step obtenir des instructions sur la manière CloudFormation de gérer vos déploiements bleu/vert Amazon ECS, consultez la section [Automatiser les déploiements bleu/vert d'ECS dans CodeDeploy le guide de l'utilisateur](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/blue-green.html). AWS CloudFormationAWS CloudFormation *
**Note**
La gestion des blue/green déploiements Amazon ECS avec n' CloudFormation est pas disponible dans la région Asie-Pacifique (Osaka).
## Différences entre les blue/green déploiements Amazon ECS via CodeDeploy et CloudFormation
Le modèle de CloudFormation pile modélise les ressources et l'infrastructure liées aux tâches Amazon ECS, ainsi que les options de configuration pour les déploiements. Il existe donc des différences entre les déploiements Amazon ECS standard et blue/green les blue/green déploiements créés via. CloudFormation
Contrairement aux blue/green déploiements Amazon ECS standard, vous ne modélisez ni ne créez manuellement les éléments suivants :
+ Vous ne créez pas une AWS CodeDeploy application en spécifiant un nom qui représente de manière unique ce que vous souhaitez déployer.
+ Vous ne créez pas de groupe AWS CodeDeploy de déploiement.
+ Vous ne spécifiez pas de *fichier de spécification d'application* (AppSpec fichier). Les informations normalement gérées avec le AppSpec fichier, telles que les options de configuration pondérées ou les événements du cycle de vie, sont gérées par le `AWS::CodeDeploy::BlueGreen` hook.
Ce tableau récapitule les différences dans le flux de travail de haut niveau entre les types de déploiement.
****
| Fonction | blue/green Déploiements standard | Déploiements bleu/vert via CloudFormation |
| --- | --- | --- |
| Spécifiez le cluster Amazon ECS, le service Amazon ECS, Application Load Balancer ou Network Load Balancer, l'écouteur de production, l'écouteur de test et deux groupes cibles. | Créez un groupe CodeDeploy de déploiement qui spécifie ces ressources. | Créez un CloudFormation modèle pour modéliser ces ressources. |
| Spécifiez la modification à déployer. | Créez une CodeDeploy application. | Créez un CloudFormation modèle qui spécifie l'image du conteneur. |
| Spécifiez la définition de tâche Amazon ECS, le nom du conteneur et le port du conteneur. | Créez un AppSpec fichier qui spécifie ces ressources. | Créez un CloudFormation modèle pour modéliser ces ressources. |
| Spécifiez les options de déplacement du trafic de déploiement et les hooks d'événements de cycle de vie. | Créez un AppSpec fichier qui spécifie ces options. | Créez un CloudFormation modèle qui utilise les paramètres du AWS::CodeDeploy::BlueGreen hook pour spécifier ces options. |
| CloudWatch alarmes. | Créez une CloudWatch alarme qui déclenche une annulation. | Configurez une CloudWatch alarme au niveau de la CloudFormation pile qui déclenche une annulation. |
| Restauration/redéploiement. | Spécifiez les options de restauration et de redéploiement. | Annulez la mise à jour de la pile dans CloudFormation. |
## Surveillance des blue/green déploiements Amazon ECS via CloudFormation
Vous pouvez surveiller les blue/green déploiements via CloudFormation et. CodeDeploy Pour plus d'informations sur la surveillance via CloudFormation, consultez la section [Surveillance blue/green des événements CloudFormation dans](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/blue-green.html#blue-green-events) le *guide de AWS CloudFormation l'utilisateur*.
**Pour consulter l'état de déploiement des blue/green déploiements dans CodeDeploy**
1. Connectez-vous à la CodeDeploy console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/codedeploy.](https://console.aws.amazon.com/codedeploy)
**Note**
Connectez-vous avec le même utilisateur que celui que vous avez configuré[Commencer avec CodeDeploy](getting-started-codedeploy.md).
1. Dans **Déploiements**, le déploiement qui a été déclenché par la mise à jour de la CloudFormation pile apparaît. Choisissez le déploiement pour afficher l'**historique des déploiements**.
![\[Capture d'écran de la console montrant la section Déploiements et l'historique du déploiement.\]](http://docs.aws.amazon.com/fr_fr/codedeploy/latest/userguide/images/cfn-cd-bg-deplhist.png)
1. Choisissez le déploiement pour afficher l'état de déplacement du trafic. Notez que l'application et le groupe de déploiement ne sont pas créés.
![\[Capture d'écran de la console montrant les détails du déploiement avec l'état de déploiement terminé.\]](http://docs.aws.amazon.com/fr_fr/codedeploy/latest/userguide/images/cfn-cd-bg-deplstatus.png)
1. Les éléments suivants s'appliquent à la restauration ou à l'arrêt du déploiement :
+ Le déploiement réussi apparaît dans CodeDeploy et indique que le déploiement a été initié par CloudFormation.
+ Si vous souhaitez arrêter et annuler le déploiement, vous devez annuler la mise à jour de la pile dans CloudFormation.
# Afficher les détails CodeDeploy du déploiement
Vous pouvez utiliser la CodeDeploy console AWS CLI, le ou le CodeDeploy APIs pour afficher les détails des déploiements associés à votre AWS compte.
**Note**
Vous pouvez consulter les journaux de déploiement EC2/sur site sur vos instances aux emplacements suivants :
Amazon Linux, RHEL et Ubuntu Server : `/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log`
Serveur Windows : C : \$1 ProgramData \$1 Amazon \$1 CodeDeploy \$1 logs \$1 scripts.log
Pour de plus amples informations, veuillez consulter [Analyse des fichiers journaux pour enquêter sur des échecs de déploiement sur les instances](troubleshooting-ec2-instances.md#troubleshooting-deploy-failures).
**Topics**
+ [Afficher les détails du déploiement (console)](#deployments-view-details-console)
+ [Afficher les détails du déploiement (CLI)](#deployments-view-details-cli)
## Afficher les détails du déploiement (console)
Pour consulter les détails du déploiement à l'aide de la CodeDeploy console, procédez comme suit :
1. Connectez-vous à la CodeDeploy console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/codedeploy.](https://console.aws.amazon.com/codedeploy)
**Note**
Connectez-vous avec le même utilisateur que celui que vous avez configuré[Commencer avec CodeDeploy](getting-started-codedeploy.md).
1. Dans le volet de navigation, développez **Deploy**, puis choisissez **Deployments.**
**Note**
Si aucune entrée n'est affichée, assurez-vous que la bonne région est sélectionnée. Dans la barre de navigation, dans le sélecteur de région, choisissez l'une des régions répertoriées dans [Région et Endpoints](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) dans le. *Références générales AWS* CodeDeploy n'est pris en charge que dans ces régions.
1. Pour afficher plus de détails sur un déploiement unique, dans **Historique des déploiements**, choisissez l'ID de déploiement ou le bouton en regard de l'ID de déploiement, puis choisissez **Afficher**.
## Afficher les détails du déploiement (CLI)
Pour utiliser le AWS CLI pour afficher les détails du déploiement, appelez la `get-deployment` commande ou la `batch-get-deployments` commande. Vous pouvez appeler la `list-deployments` commande pour obtenir une liste des déploiements uniques IDs à utiliser comme entrées pour la `get-deployment` commande et la `batch-get-deployments` commande.
Pour afficher les détails d'un seul déploiement, appelez la commande [get-deployment](https://docs.aws.amazon.com/cli/latest/reference/deploy/get-deployment.html), en spécifiant l'identifiant de déploiement unique. Pour obtenir l'ID de déploiement, appelez la commande [list-deployments](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployments.html).
Pour afficher des détails sur plusieurs déploiements, appelez la commande [batch-get-deployments](https://docs.aws.amazon.com/cli/latest/reference/deploy/batch-get-deployments.html), en spécifiant plusieurs identificateurs de déploiement uniques. Pour obtenir le déploiement IDs, appelez la commande [list-deployments](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployments.html).
Pour afficher la liste des déploiements IDs, appelez la commande [list-deployments](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployments.html), en spécifiant :
+ Le nom de l'application associée au déploiement. Pour afficher la liste des noms d'applications, appelez la commande [list-applications.](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-applications.html)
+ Le nom du groupe de déploiement associé au déploiement. Pour afficher la liste des noms des groupes de déploiement, appelez la commande [list-deployment-groups](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-groups.html).
+ Eventuellement, s'il convient d'inclure des détails sur les déploiements en fonction de leur état de déploiement. (Si vous ne spécifiez pas cela, tous les déploiements correspondants sont répertoriés, quel que soit leur état de déploiement.)
+ Eventuellement, s'il convient d'inclure des détails sur les déploiements en fonction de leur heure de début ou de leur heure de fin de création de déploiement, ou des deux. (Si vous ne spécifiez pas cela, tous les déploiements correspondants sont répertoriés, quel que soit leur heure de création.)
# Afficher les données du journal pour les déploiements CodeDeploy EC2/sur site
Vous pouvez consulter les données du journal créées par un CodeDeploy déploiement en configurant l' CloudWatch agent Amazon pour qu'il affiche les données agrégées dans la CloudWatch console ou en vous connectant à une instance individuelle pour consulter le fichier journal.
**Note**
Les journaux ne sont pas pris en charge pour les AWS déploiements Lambda ou Amazon ECS. Ils peuvent être créés uniquement pour les déploiements EC2/sur site.
**Topics**
+ [Afficher les données du fichier journal dans la CloudWatch console Amazon](#deployments-view-logs-cloudwatch)
+ [Afficher les fichiers journaux d'une instance](#deployments-view-logs-instance)
## Afficher les données du fichier journal dans la CloudWatch console Amazon
Lorsque l' CloudWatch agent Amazon est installé sur une instance, les données de déploiement de tous les déploiements sur cette instance peuvent être consultées dans la CloudWatch console. Pour des raisons de simplicité, nous vous recommandons CloudWatch de surveiller les fichiers journaux de manière centralisée au lieu de les afficher instance par instance. Pour de plus amples informations, veuillez consulter [Envoyer les journaux des CodeDeploy agents à CloudWatch](codedeploy-agent-operations-cloudwatch-agent.md).
## Afficher les fichiers journaux d'une instance
Pour afficher les données du journal de déploiement pour une instance individuelle, vous pouvez vous connecter à l'instance et chercher des informations sur les erreurs ou d'autres événements de déploiement.
**Topics**
+ [Pour consulter les fichiers journaux de déploiement sur les instances Amazon Linux, RHEL et Ubuntu Server](#deployments-view-logs-instance-unix)
+ [Pour afficher les fichiers journaux de déploiement sur les instances Windows Server](#deployments-view-logs-instance-windows)
### Pour consulter les fichiers journaux de déploiement sur les instances Amazon Linux, RHEL et Ubuntu Server
Sur les instances Amazon Linux, RHEL et Ubuntu Server, les journaux de déploiement sont stockés à l'emplacement suivant :
`/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log`
Pour consulter ou analyser les journaux de déploiement sur les instances Amazon Linux, RHEL et Ubuntu Server, connectez-vous à l'instance, puis tapez la commande suivante pour ouvrir le fichier journal de l' CodeDeploy agent :
```
less /var/log/aws/codedeploy-agent/codedeploy-agent.log
```
Tapez les commandes suivantes pour parcourir le fichier journal à la recherche des messages d'erreur :
| Commande | Résultat |
| --- | --- |
| & ERROR | Affiche uniquement les messages d'erreur dans le fichier journal. Utilisez un espace simple avant et après le mot ERROR. |
| / ERROR | Recherchez le message d'erreur suivant.¹ |
| ? ERROR | Recherchez le message d'erreur précédent.² Utilisez un seul espace avant et après le mot. ERROR |
| G | Accède à la fin du fichier journal. |
| g | Accède au début du fichier journal. |
| q | Quitte le fichier journal. |
| h | Donne des informations sur les commandes supplémentaires. |
| ¹ Après avoir saisi **/ ERROR ** le texte, saisissez **n** le message d'erreur suivant. Tapez **N** pour le message d'erreur précédent. ² Après avoir **? ERROR ** tapé, saisissez **n** le message d'erreur suivant ou le message d'erreur précédent. **N** |
Vous pouvez également taper la commande suivante pour ouvrir un fichier journal de CodeDeploy scripts :
```
less /opt/codedeploy-agent/deployment-root/deployment-group-ID/deployment-ID/logs/scripts.log
```
Tapez les commandes suivantes pour parcourir le fichier journal à la recherche des messages d'erreur :
| Commande | Résultat |
| --- | --- |
| &stderr | Affiche uniquement les messages d'erreur dans le fichier journal. |
| /stderr | Recherchez le message d'erreur suivant.¹ |
| ?stderr | Recherchez le message d'erreur précédent². |
| G | Accède à la fin du fichier journal. |
| g | Accède au début du fichier journal. |
| q | Quitte le fichier journal. |
| h | Donne des informations sur les commandes supplémentaires. |
| ¹ Après avoir tapé**/stderr**, saisissez le message d'erreur suivant **n** pour le transfert. Tapez **N** pour le message d'erreur précédent vers l'arrière. ² Après avoir tapé**?stderr**, tapez **n** le message d'erreur suivant en arrière. Tapez **N** pour le message d'erreur précédent vers l'avant. |
### Pour afficher les fichiers journaux de déploiement sur les instances Windows Server
**CodeDeploy fichier journal de l'agent** : sur les instances Windows Server, le fichier journal de l' CodeDeploy agent est stocké à l'emplacement suivant :
`C:\ProgramData\Amazon\CodeDeploy\log\codedeploy-agent-log.txt`
Pour consulter ou analyser le fichier journal de l' CodeDeploy agent sur une instance Windows Server, connectez-vous à l'instance, puis tapez la commande suivante pour ouvrir le fichier :
```
notepad C:\ProgramData\Amazon\CodeDeploy\log\codedeploy-agent-log.txt
```
Pour parcourir le fichier journal à la recherche de messages d'erreur, appuyez sur Ctrl\$1F, tapez **ERROR [**, puis appuyez sur Entrée pour rechercher la première erreur.
**CodeDeploy fichiers journaux de scripts** : sur les instances Windows Server, les journaux de déploiement sont stockés à l'emplacement suivant :
`C:\ProgramData\Amazon\CodeDeploy\deployment-group-id\deployment-id\logs\scripts.log`
Où :
+ *deployment-group-id*est une chaîne telle que `examplebf3a9c7a-7c19-4657-8684-b0c68d0cd3c4`
+ *deployment-id*est un identifiant tel que `d-12EXAMPLE`
Tapez la commande suivante pour ouvrir un fichier journal de CodeDeploy scripts :
```
notepad C:\ProgramData\Amazon\CodeDeploy\deployment-group-ID\deployment-ID\logs\scripts.log
```
Pour parcourir le fichier journal à la recherche de messages d'erreur, appuyez sur Ctrl\$1F, tapez **stderr**, puis appuyez sur Entrée pour rechercher la première erreur.
# Arrêtez un déploiement avec CodeDeploy
Vous pouvez utiliser la CodeDeploy console AWS CLI, le ou le CodeDeploy APIs pour arrêter les déploiements associés à votre AWS compte.
**Avertissement**
L'arrêt d'un déploiement EC2 /On-Premises peut laisser certaines ou toutes les instances de vos groupes de déploiement dans un état de déploiement indéterminé. Pour de plus amples informations, veuillez consulter [Déploiements interrompus ou échoués](deployment-steps-server.md#deployment-stop-fail).
**Topics**
+ [Arrêt d'un déploiement (console)](#deployments-stop-console)
+ [Arrêt d'un déploiement (interface CLI)](#deployments-stop-cli)
**Note**
Si votre déploiement est un déploiement bleu/vert CloudFormation, vous ne pouvez pas effectuer cette tâche dans la CodeDeploy console. Accédez à la CloudFormation console pour effectuer cette tâche.
## Arrêt d'un déploiement (console)
1. Connectez-vous à la CodeDeploy console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/codedeploy.](https://console.aws.amazon.com/codedeploy)
**Note**
Connectez-vous avec le même utilisateur que celui que vous avez configuré[Commencer avec CodeDeploy](getting-started-codedeploy.md).
1. Dans le volet de navigation, développez **Deploy**, puis choisissez **Deployments.**
**Note**
Si aucune entrée n'est affichée, assurez-vous que la bonne région est sélectionnée. Dans la barre de navigation, dans le sélecteur de région, choisissez l'une des régions répertoriées dans [Région et Endpoints](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) dans le. *Références générales AWS* CodeDeploy est pris en charge dans ces régions uniquement.
1. Choisissez le déploiement à arrêter effectuez l'une des opérations suivantes :
1. Choisissez **Arrêter le déploiement** pour arrêter le déploiement sans restauration.
1. Choisissez **Arrêter et restaurer le déploiement** pour arrêter et restaurer le déploiement.
Pour de plus amples informations, veuillez consulter [Redéployez et annulez un déploiement avec CodeDeploy](deployments-rollback-and-redeploy.md).
**Note**
Si les options **Arrêter le déploiement** et **Arrêter et restaurer le déploiement** sont indisponibles, le déploiement a progressé jusqu'à un point où il ne peut plus être arrêté.
## Arrêt d'un déploiement (interface CLI)
Appelez la commande [stop-deployment](https://docs.aws.amazon.com/cli/latest/reference/deploy/stop-deployment.html) en spécifiant l'ID de déploiement. Pour afficher la liste des déploiements IDs, appelez la commande [list-deployments](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployments.html).
# Redéployez et annulez un déploiement avec CodeDeploy
CodeDeploy annule les déploiements en redéployant une version précédemment déployée d'une application en tant que nouveau déploiement. Ces déploiements annulés sont des déploiements techniquement nouveaux, avec un nouveau déploiement IDs, plutôt que des versions restaurées d'un déploiement précédent.
Les déploiements peuvent être restaurés automatiquement ou manuellement.
**Topics**
+ [Annulations automatiques](#deployments-rollback-and-redeploy-automatic-rollbacks)
+ [Annulations manuelles](#deployments-rollback-and-redeploy-manual-rollbacks)
+ [Flux de travail de restauration et de redéploiement](#deployments-rollback-and-redeploy-workflow)
+ [Comportement d'annulation avec du contenu existant](#deployments-rollback-and-redeploy-content-options)
## Annulations automatiques
Vous pouvez configurer un groupe de déploiement ou un déploiement pour être restaurés automatiquement lorsqu'un déploiement échoue, ou lorsqu'un seuil de surveillance que vous spécifiez est atteint. Dans ce cas, la dernière version correcte connue d'une révision de l'application est déployée. Vous configurez des restaurations automatiques lorsque vous créez une application ou créez ou mettez à jour un groupe de déploiement.
Lorsque vous créez un nouveau déploiement, vous pouvez également choisir de remplacer la configuration de la restauration automatique qui a été spécifiée pour le groupe de déploiement.
**Note**
Vous pouvez utiliser Amazon Simple Notification Service pour recevoir une notification chaque fois qu'un déploiement est annulé automatiquement. Pour plus d'informations, consultez [Surveillance des déploiements à l'aide des notifications d'événements Amazon SNS](monitoring-sns-event-notifications.md).
Pour plus d'informations sur la configuration de la restauration automatique, consultez [Configuration des options avancées d'un groupe de déploiement](deployment-groups-configure-advanced-options.md).
## Annulations manuelles
Si vous n'avez pas configuré les restaurations automatiques, vous pouvez annuler manuellement un déploiement en créant un nouveau déploiement qui utilise une révision d'application précédemment déployée et en suivant les étapes pour redéployer une révision. Vous pouvez le faire si une application a atteint un état inconnu. Plutôt que de passer beaucoup de temps à résoudre des problèmes, vous pouvez redéployer l'application dans un état de fonctionnement connu. Pour de plus amples informations, veuillez consulter [Créez un déploiement avec CodeDeploy](deployments-create.md).
**Note**
Si vous supprimez une instance d'un groupe de déploiement, CodeDeploy cela ne désinstalle aucun élément susceptible d'avoir déjà été installé sur cette instance.
## Flux de travail de restauration et de redéploiement
Lorsque la restauration automatique est lancée, ou lorsque vous lancez manuellement un redéploiement ou une annulation manuelle, essayez d' CodeDeploy abord de supprimer de chaque instance participante tous les fichiers qui ont été installés avec succès pour la dernière fois. CodeDeploy pour ce faire, vérifiez le fichier de nettoyage :
`/opt/codedeploy-agent/deployment-root/deployment-instructions/deployment-group-ID-cleanup`fichier (pour les instances Amazon Linux, Ubuntu Server et RHEL)
`C:\ProgramData\Amazon\CodeDeploy\deployment-instructions\deployment-group-ID-cleanup`fichier (pour les instances Windows Server)
S'il existe, CodeDeploy utilise le fichier de nettoyage pour supprimer de l'instance tous les fichiers répertoriés avant de démarrer le nouveau déploiement.
Par exemple, les deux premiers fichiers texte et les deux fichiers de script ont déjà été déployés sur une instance Amazon EC2 exécutant Windows Server, et les scripts ont créé deux autres fichiers texte lors des événements du cycle de vie du déploiement :
```
c:\temp\a.txt (previously deployed by CodeDeploy)
c:\temp\b.txt (previously deployed by CodeDeploy)
c:\temp\c.bat (previously deployed by CodeDeploy)
c:\temp\d.bat (previously deployed by CodeDeploy)
c:\temp\e.txt (previously created by c.bat)
c:\temp\f.txt (previously created by d.bat)
```
Le fichier de nettoyage répertorie uniquement les deux premiers fichiers texte et deux fichiers de script :
```
c:\temp\a.txt
c:\temp\b.txt
c:\temp\c.bat
c:\temp\d.bat
```
Avant le nouveau déploiement, seuls les deux premiers fichiers texte et les deux fichiers de script CodeDeploy seront supprimés, les deux derniers étant conservés :
```
c:\temp\a.txt will be removed
c:\temp\b.txt will be removed
c:\temp\c.bat will be removed
c:\temp\d.bat will be removed
c:\temp\e.txt will remain
c:\temp\f.txt will remain
```
Dans le cadre de ce processus, je n' CodeDeploy essaierai pas d'annuler ou de réconcilier les actions entreprises par des scripts lors de déploiements précédents lors de redéploiements ultérieurs, qu'il s'agisse de annulations manuelles ou automatiques. Par exemple, si les `d.bat` fichiers `c.bat` and contiennent une logique empêchant de recréer les `f.txt` fichiers `e.txt` and s'ils existent déjà, les anciennes versions de `e.txt` et `f.txt` resteront inchangées lors des CodeDeploy exécutions `c.bat` et des `d.bat` déploiements ultérieurs. Vous pouvez ajouter une logique à `c.bat` et `d.bat` pour toujours vérifier et supprimer les anciennes versions de `e.txt` et `f.txt` avant d'en créer de nouvelles.
## Comportement d'annulation avec du contenu existant
Dans le cadre du processus de déploiement, l' CodeDeploy agent supprime de chaque instance tous les fichiers installés par le déploiement le plus récent. Si des fichiers qui ne faisaient pas partie d'un déploiement précédent apparaissent dans les emplacements de déploiement cibles, vous pouvez choisir ce qu' CodeDeploy il en sera fait lors du prochain déploiement :
+ **Échec du déploiement** : une erreur est signalée et le statut du déploiement passe à Échec.
+ **Remplacer le contenu** : la version du fichier issue de la révision de l'application remplace la version déjà présente sur l'instance.
+ **Conserver le contenu** : le fichier à l'emplacement cible est conservé et la version de la révision de l'application n'est pas copiée sur l'instance.
Vous pouvez choisir ce comportement lorsque vous créez un déploiement. Si vous créez un déploiement dans la console, consultez[Création d'un déploiement de plate-forme de calcul EC2/sur site (console)](deployments-create-console.md). Si vous créez un déploiement avec le AWS CLI, voir[Création d'un déploiement de plate-forme de calcul EC2/sur site (CLI)](deployments-create-cli.md).
Vous pouvez choisir de conserver les fichiers dont vous voulez qu'ils fassent partie du prochain déploiement sans avoir à les ajouter au package de la révision de l'application. Par exemple, vous pouvez charger directement sur l'instance des fichiers qui sont requis pour le déploiement, mais qui n'ont pas été ajoutés au groupe de révisions de l'application. Vous pouvez également télécharger des fichiers sur l'instance si vos applications se trouvent déjà dans votre environnement de production mais que vous souhaitez les utiliser CodeDeploy pour la première fois pour les déployer.
Dans le cas d'une restauration, où la dernière révision d'application déployée avec succès est redéployée en raison d'une défaillance de déploiement, l'option content-handling de ce dernier déploiement réussi est appliquée au déploiement de la restauration.
Cependant, si le déploiement qui a échoué a été configuré pour remplacer les fichiers au lieu de les conserver, un résultat inattendu peut se produire pendant la restauration. En particulier, les fichiers que vous avez prévu de conserver peuvent être supprimés par l'échec du déploiement. Les fichiers ne sont pas sur l'instance lorsque le déploiement de la restauration s'exécute.
Dans l'exemple suivant, il existe trois déploiements. Tout fichier écrasé (supprimé) au cours du deuxième déploiement défaillant n'est plus disponible (ne peut pas être conservé) lorsque la révision d'application 1 est déployée à nouveau pendant le déploiement 3 :
****
| Déploiement | Révision de l'application | Option de remplacement du contenu | Statut du déploiement | Comportement et résultat |
| --- | --- | --- | --- | --- |
| déploiement 1 | révision d'application 1 | RETAIN | Réussi(e) | CodeDeploy détecte les fichiers dans les emplacements cibles qui n'ont pas été déployés lors du déploiement précédent. Ces fichiers peuvent être placés là intentionnellement pour faire partie du déploiement actuel. Ils sont conservés et enregistrés dans le cadre du package de déploiement actuel. |
| déploiement 2 | révision d'application 2 | OVERWRITE | Échec | Au cours du processus de déploiement, CodeDeploy supprime tous les fichiers faisant partie du déploiement réussi précédent. Cela inclut les fichiers qui ont été conservés pendant le déploiement 1. Cependant, le déploiement échoue pour des raisons indépendantes. |
| déploiement 3 | révision d'application 1 | RETAIN | | Dans la mesure où l'annulation automatique est activée pour le déploiement ou le groupe de déploiement, CodeDeploy déploie la dernière révision d'application connue, la révision d'application 1.Cependant, les fichiers que vous souhaitiez conserver dans le déploiement 1 ont été supprimés avant l'échec du déploiement 2 et ne peuvent pas être récupérés par AWS CodeDeploy. Vous pouvez les ajouter à l'instance vous-même s'ils sont obligatoires pour la révision d'application 1, ou vous pouvez créer une nouvelle révision d'application. |
# Déployer une application dans un autre AWS compte
Organisations disposent généralement de plusieurs AWS comptes qu'elles utilisent à des fins différentes (par exemple, un pour les tâches d'administration système et un autre pour les tâches de développement, de test et de production, ou un associé aux environnements de développement et de test et un autre associé à l'environnement de production).
Bien que vous puissiez effectuer des tâches connexes dans différents comptes, les groupes de CodeDeploy déploiement et les instances Amazon EC2 sur lesquelles ils sont déployés sont strictement liés aux comptes sous lesquels ils ont été créés. Vous ne pouvez pas, par exemple, ajouter une instance que vous avez lancée dans un compte à un groupe de déploiement dans un autre.
Supposons que vous ayez deux AWS comptes : votre compte de développement et votre compte de production. Vous travaillez principalement dans le compte de développement, mais vous souhaitez être capable de lancer des déploiements dans votre compte de production sans un ensemble complet d’informations d’identification ou sans avoir à vous déconnecter du compte de développement pour vous connecter au compte de production.
Après avoir suivi les étapes de configuration entre comptes, vous pouvez lancer des déploiements appartenant à un autre compte de votre organisation, sans avoir besoin d’un ensemble complet d’informations d’identification pour cet autre compte. Pour ce faire, vous utilisez en partie une fonctionnalité fournie par le AWS Security Token Service (AWS STS) qui vous accorde un accès temporaire à ce compte.
## Étape 1 : créer un compartiment S3 dans l'un ou l'autre des comptes
Dans le compte de développement ou le compte de production :
+ Si ce n'est pas déjà fait, créez un compartiment Amazon S3 dans lequel les révisions de l'application pour le compte de production seront stockées. Pour plus d'informations, consultez [Créer un compartiment dans Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/CreatingABucket.html). Vous pouvez même utiliser les mêmes révisions d'application et compartiment pour les deux comptes, en déployant les mêmes fichiers dans votre environnement de production que vous avez testés et vérifiés dans votre compte de développement.
## Étape 2 : accorder des autorisations de compartiment Amazon S3 au profil d'instance IAM du compte de production
Si le compartiment Amazon S3 que vous avez créé à l'étape 1 se trouve dans votre compte de production, cette étape n'est pas obligatoire. Le rôle que vous assumerez plus tard aura déjà accès à ce compartiment, car il figure également dans le compte de production.
Si vous avez créé le compartiment Amazon S3 dans le compte de développement, procédez comme suit :
+ Dans le compte de production, créez un profil d'instance IAM. Pour plus d'informations, consultez [Étape 4 : Création d'un profil d'instance IAM pour vos instances Amazon EC2](getting-started-create-iam-instance-profile.md).
**Note**
Notez l'ARN de ce profil d'instance IAM. Vous devez l'ajouter à la stratégie entre compartiments que vous créez ensuite.
+ Dans le compte de développement, donnez accès au bucket Amazon S3 que vous avez créé dans le compte de développement au profil d'instance IAM que vous venez de créer dans votre compte de production. Pour plus d'informations, voir [Exemple 2 : le propriétaire du bucket accorde des autorisations de bucket entre comptes](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-walkthroughs-managing-access-example2.html).
Notez les éléments suivants lorsque vous terminez le processus d’octroi des autorisations de compartiment entre comptes :
+ Dans cet exemple de procédure, le compte A représente votre compte de développement et le compte B représente votre compte de production.
+ Lorsque vous [effectuez les tâches du compte A (compte de développement)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-walkthroughs-managing-access-example2.html#access-policies-walkthrough-cross-account-permissions-acctA-tasks), modifiez la stratégie de compartiment suivante pour accorder des autorisations entre comptes au lieu d'utiliser l'exemple de stratégie fourni dans la procédure pas à pas.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "Cross-account permissions",
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::111122223333:role/role-name"
},
"Action": [
"s3:Get*",
"s3:List*"
],
"Resource": [
"arn:aws:s3:::bucket-name/*"
]
}
]
}
```
------
*account-id*représente le numéro de compte du compte de production sur lequel vous venez de créer le profil d'instance IAM.
*role-name*représente le nom du profil d'instance IAM que vous venez de créer.
*bucket-name*représente le nom du compartiment que vous avez créé à l'étape 1. N’oubliez pas d’inclure `/*` après le nom de votre compartiment pour accorder l’accès à chacun des fichiers à l’intérieur du compartiment.
## Étape 3 : Création de ressources et d'un rôle multicompte dans le compte de production
Dans votre compte de production :
+ Créez vos CodeDeploy ressources (application, groupe de déploiement, configuration de déploiement, instances Amazon EC2, profil d'instance Amazon EC2, rôle de service, etc.) en suivant les instructions de ce guide.
+ Créez un rôle supplémentaire, un rôle IAM entre comptes, qu'un utilisateur de votre compte de développement peut assumer pour effectuer CodeDeploy des opérations dans ce compte de production.
Utilisez la [procédure pas à pas : déléguez l'accès entre les AWS comptes à l'aide des rôles IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/walkthru_cross-account-with-roles.html) comme guide pour vous aider à créer le rôle entre comptes. Au lieu d'ajouter les exemples d'autorisations dans la procédure pas à pas à votre document de politique, vous devez associer au moins les deux politiques AWS fournies suivantes au rôle :
+ `AmazonS3FullAccess` : requise uniquement si le compartiment S3 figure dans le compte de développement. Fournit au rôle de compte de production assumé un accès complet aux services et ressources Amazon S3 dans le compte de développement, où la révision est stockée.
+ `AWSCodeDeployDeployerAccess`: Permet à un utilisateur d'enregistrer et de déployer des révisions.
Si vous souhaitez créer et gérer des groupes de déploiement et non pas seulement initier des déploiements, ajoutez la stratégie `AWSCodeDeployFullAccess` à la place de la stratégie `AWSCodeDeployDeployerAccess`. Pour plus d'informations sur l'utilisation des politiques gérées par IAM pour accorder des autorisations pour les CodeDeploy tâches, consultez[AWS politiques gérées (prédéfinies) pour CodeDeploy](managed-policies.md).
Vous pouvez attacher des stratégies supplémentaires si vous souhaitez effectuer des tâches dans d'autres services AWS tout en utilisant ce rôle entre comptes.
**Important**
Lorsque vous créez le rôle IAM entre comptes, notez les informations dont vous aurez besoin pour accéder au compte de production.
Pour utiliser le AWS Management Console pour changer de rôle, vous devez fournir l'un des éléments suivants :
Une URL pour accéder au compte de production avec les informations d’identification du rôle assumé. Vous trouverez cette URL sur la page **Révision**, qui s'affiche à la fin du processus de création de rôle entre comptes.
Le nom du rôle entre comptes et l'alias ou l'ID du compte.
Pour utiliser le AWS CLI pour changer de rôle, vous devez fournir les éléments suivants :
Le nom ARN du rôle entre comptes que vous allez assumer.
## Étape 4 : télécharger la révision de l'application dans le compartiment Amazon S3
Dans le compte dans lequel vous avez créé le compartiment Amazon S3 :
+ Téléchargez la révision de votre application dans le compartiment Amazon S3. Pour plus d'informations, consultez [Transférer une révision CodeDeploy pour Amazon S3 (déploiements EC2/sur site uniquement)](application-revisions-push.md).
## Étape 5 : assumer le rôle multi-comptes et déployer des applications
Dans le compte de développement, vous pouvez utiliser le AWS CLI ou le AWS Management Console pour assumer le rôle entre comptes et lancer le déploiement dans le compte de production.
Pour obtenir des instructions sur la façon d'utiliser le AWS Management Console pour changer de rôle et lancer des déploiements, voir [Basculer vers un rôle (AWS Management Console)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-console.html) et[Création d'un déploiement de plate-forme de calcul EC2/sur site (console)](deployments-create-console.md).
Pour savoir comment utiliser le AWS CLI pour assumer le rôle entre comptes et lancer des déploiements, voir [Passer à un rôle IAM ()AWS Command Line Interface](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-cli.html) et. [Création d'un déploiement de plate-forme de calcul EC2/sur site (CLI)](deployments-create-cli.md)
Pour plus d'informations sur l'attribution d'un rôle AWS STS, consultez [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)le [guide de l'AWS Security Token Service utilisateur](https://docs.aws.amazon.com/STS/latest/APIReference/Welcome.html) et [assume-role](https://docs.aws.amazon.com/cli/latest/reference/sts/assume-role.html) dans le manuel de référence des [AWS CLI commandes](https://docs.aws.amazon.com/cli/latest/reference/).
**Voir aussi :**
+ [CodeDeploy: Déploiement d'un compte de développement vers un compte de production](https://aws.amazon.com/blogs/devops/aws-codedeploy-deploying-from-a-development-account-to-a-production-account/)
# Utiliser l' CodeDeploy agent pour valider un package de déploiement sur une machine locale
À l'aide de l' CodeDeploy agent, vous pouvez déployer du contenu sur une instance à laquelle vous êtes connecté. Cela vous permet de tester l'intégrité d'un fichier de spécification d'application (AppSpec fichier) que vous souhaitez utiliser dans le cadre d'un déploiement et du contenu que vous souhaitez déployer.
Il n'est pas nécessaire de créer une application et un groupe de déploiement. Si vous souhaitez déployer du contenu stocké sur l'instance locale, vous n'avez même pas besoin de AWS compte. Pour les tests les plus simples, vous pouvez exécuter la **codedeploy-local** commande, sans spécifier d'options, dans un répertoire contenant le AppSpec fichier et le contenu à déployer. L'outil inclut aussi des options pour d'autres scénarios de test.
En validant un package de déploiement sur un ordinateur local, vous pouvez :
+ Tester l'intégrité d'une révision d'application.
+ Testez le contenu d'un AppSpec fichier.
+ Essayez CodeDeploy pour la première fois avec le code de votre application existant.
+ Déployer rapidement du contenu lorsque vous êtes déjà connecté à une instance.
Vous pouvez utiliser le contenu de déploiement stocké sur l'instance locale ou dans un type de référentiel distant pris en charge (compartiments Amazon S3 ou GitHub référentiels publics).
## Conditions préalables
Avant de lancer un déploiement local, effectuez les étapes suivantes :
+ Créez ou utilisez un type d'instance pris en charge par l' CodeDeploy agent. Pour plus d'informations, consultez [Systèmes d'exploitation pris en charge par l' CodeDeploy agent](codedeploy-agent.md#codedeploy-agent-supported-operating-systems).
+ Installez la version 1.0.1.1352 ou ultérieure de l'agent. CodeDeploy Pour plus d'informations, consultez [Installation de l' CodeDeploy agent](codedeploy-agent-operations-install.md).
+ Si vous déployez votre contenu à partir d'un compartiment ou d'un GitHub référentiel Amazon S3, configurez un utilisateur avec lequel vous pourrez l'utiliser CodeDeploy. Pour plus d'informations, consultez [Étape 1 : Configuration](getting-started-setting-up.md).
+ Si vous déployez la révision de votre application à partir d'un compartiment Amazon S3, créez un compartiment Amazon S3 dans la région dans laquelle vous travaillez et appliquez une politique de compartiment Amazon S3 au compartiment. Cette stratégie accorde à vos instances les autorisations requises pour télécharger la révision d'application.
Par exemple, la politique de compartiment Amazon S3 suivante permet à toute instance Amazon EC2 associée à un profil d'instance IAM contenant l'ARN de `arn:aws:iam::444455556666:role/CodeDeployDemo` télécharger n'importe où dans le compartiment Amazon S3 nommé : `amzn-s3-demo-bucket`
```
{
"Statement": [
{
"Action": [
"s3:Get*",
"s3:List*"
],
"Effect": "Allow",
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*",
"Principal": {
"AWS": [
"arn:aws:iam::444455556666:role/CodeDeployDemo"
]
}
}
]
}
```
La politique de compartiment Amazon S3 suivante permet à toute instance sur site associée à un utilisateur IAM contenant l'ARN de `arn:aws:iam::444455556666:user/CodeDeployUser` télécharger depuis n'importe quel emplacement du compartiment Amazon S3 nommé : `amzn-s3-demo-bucket`
```
{
"Statement": [
{
"Action": [
"s3:Get*",
"s3:List*"
],
"Effect": "Allow",
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*",
"Principal": {
"AWS": [
"arn:aws:iam::444455556666:user/CodeDeployUser"
]
}
}
]
}
```
Pour plus d'informations sur la façon de générer et d'associer une politique de compartiment Amazon S3, consultez les [exemples de politique de compartiment](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html).
+ Si vous déployez la révision de votre application à partir d'un compartiment ou d'un GitHub référentiel Amazon S3, configurez un profil d'instance IAM et attachez-le à l'instance. Pour plus d'informations, consultez [Étape 4 : Création d'un profil d'instance IAM pour vos instances Amazon EC2](getting-started-create-iam-instance-profile.md), [Créez une instance Amazon EC2 pour CodeDeploy (AWS CLI ou une console Amazon EC2)](instances-ec2-create.md) et [Création d'une instance Amazon EC2 pour CodeDeploy (modèle)CloudFormation](instances-ec2-create-cloudformation-template.md).
+ Si vous déployez votre contenu depuis GitHub, créez un GitHub compte et un dépôt public. Pour créer un GitHub compte, consultez la section [S'inscrire GitHub](https://github.com/join). Pour créer un GitHub dépôt, voir [Création d'un dépôt.](https://help.github.com/articles/create-a-repo/)
**Note**
Les référentiels privés ne sont pas pris en charge pour l'instant. Si votre contenu est stocké dans un GitHub référentiel privé, vous pouvez le télécharger sur l'instance et utiliser l'`--bundle-location`option pour spécifier son chemin local.
+ Préparez le contenu (y compris un AppSpec fichier) que vous souhaitez déployer sur l'instance et placez-le sur l'instance locale, dans votre compartiment Amazon S3 ou dans votre GitHub référentiel. Pour plus d'informations, consultez [Travailler avec les révisions d'applications pour CodeDeploy](application-revisions.md).
+ Si vous souhaitez utiliser des valeurs autres que les valeurs par défaut pour d'autres options de configuration, créez le fichier de configuration et placez-le sur l'instance (`/etc/codedeploy-agent/conf/codedeployagent.yml`pour les instances Amazon Linux, RHEL ou Ubuntu Server ou `C:\ProgramData\Amazon\CodeDeploy\conf.yml` pour les instances Windows Server). Pour plus d'informations, consultez [CodeDeploy référence de configuration de l'agent](reference-agent-configuration.md).
**Note**
Si vous utilisez un fichier de configuration sur des instances Amazon Linux, RHEL ou Ubuntu Server, vous devez soit :
Utiliser les variables `:root_dir:` et `:log_dir:` pour spécifier des emplacements autres que ceux par défaut pour les dossiers du répertoire de journaux et du répertoire racine du déploiement.
`sudo`À utiliser pour exécuter les commandes de CodeDeploy l'agent.
## Création d'un déploiement local
Sur l'instance où vous souhaitez créer le déploiement local, ouvrez une session de terminal (instances Amazon Linux, RHEL ou Ubuntu Server) ou une invite de commande (Windows Server) pour exécuter les commandes de l'outil.
**Note**
La commande **codedeploy-local** est installée dans les emplacements suivants :
Sur Amazon Linux, RHEL ou Ubuntu Server : `/opt/codedeploy-agent/bin`
Sur Windows Server :`C:\ProgramData\Amazon\CodeDeploy\bin`.
** Syntaxe de base des commandes **
```
codedeploy-local [options]
```
**Résumé**
```
codedeploy-local
[--bundle-location ]
[--type ]
[--file-exists-behavior ]
[--deployment-group ]
[--events ]
[--agent-configuration-file ]
[--appspec-filename ]
```
**Options**
**-l**, **--bundle-location**
Emplacement du bundle de la révision d'application. Si vous ne spécifiez pas d'emplacement, l'outil utilise par défaut le répertoire dans lequel vous travaillez actuellement. Si vous spécifiez une valeur pour `--bundle-location`, vous devez également en spécifier une pour `--type`.
Exemples de format pour l'emplacement du bundle :
+ Instance locale de serveur Amazon Linux, RHEL ou Ubuntu : `/path/to/local/bundle.tgz`
+ Instance Windows Server locale : `C:/path/to/local/bundle`
+ Compartiment Amazon S3 : `s3://amzn-s3-demo-bucket/bundle.tar`
+ GitHub référentiel : `https://github.com/account-name/repository-name/`
**-t**, **--type**
Format du bundle de la révision d'application. Les types pris en charge incluent `tgz`, `tar`, `zip` et `directory`. Si vous ne spécifiez aucun type, l'outil utilise `directory` par défaut. Si vous spécifiez une valeur pour `--type`, vous devez également en spécifier une pour `--bundle-location`.
**-b**, **-- file-exists-behavior**
Indique le traitement à appliquer aux fichiers qui existent déjà dans un emplacement cible du déploiement mais qui ne faisaient pas partie d'un précédent déploiement réussi. Les options incluent DISALLOW, OVERWRITE, RETAIN. Pour plus d'informations, consultez [fileExistsBehavior](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_CreateDeployment.html#CodeDeploy-CreateDeployment-request-fileExistsBehavior)la section *[Référence des AWS CodeDeploy API](https://docs.aws.amazon.com/codedeploy/latest/APIReference/)*.
**-g**, **--deployment-group**
Chemin du dossier constituant l'emplacement cible du contenu à déployer. Si vous ne spécifiez aucun dossier, l'outil en crée un nommé *default-local-deployment-group*dans le répertoire racine de votre déploiement. Pour chaque déploiement local que vous créez, l'outil crée un sous-répertoire à l'intérieur de ce dossier avec un nom tel que *d-98761234-local*.
**-e**, **--events**
Un ensemble de hooks d'événements de remplacement du cycle de vie que vous souhaitez exécuter, dans l'ordre, à la place des événements que vous avez répertoriés dans le AppSpec fichier. Plusieurs hooks peuvent être spécifiés, séparés par des virgules. Vous pouvez utiliser cette option si :
+ Vous souhaitez exécuter un ensemble d'événements différent sans avoir à mettre à jour le AppSpec fichier.
+ Vous souhaitez exécuter un hook d'événement unique en tant qu'exception au contenu du AppSpec fichier, par exemple`ApplicationStop`.
Si vous ne spécifiez ni n'**installez **DownloadBundle****les événements dans la liste de remplacement, ils s'exécuteront avant tous les hooks d'événements que vous spécifiez. Si vous incluez **DownloadBundle**et **Installer** dans la liste des `--events` options, elles doivent être précédées uniquement des événements qui s'exécutent normalement avant elles lors CodeDeploy des déploiements. Pour plus d'informations, consultez [AppSpec section « crochets »](reference-appspec-file-structure-hooks.md).
**-c**, **-- agent-configuration-file**
Emplacement d'un fichier de configuration à utiliser pour le déploiement, si vous le stockez à un emplacement autre que celui par défaut. Un fichier de configuration spécifie des options alternatives pour les autres valeurs et comportements par défaut dans le cadre d'un déploiement.
Par défaut, les fichiers de configuration sont stockés dans `/etc/codedeploy-agent/conf/codedeployagent.yml` (instances Amazon Linux, RHEL ou Ubuntu Server) ou `C:/ProgramData/Amazon/CodeDeploy/conf.yml` (Windows Server). Pour de plus amples informations, veuillez consulter [CodeDeploy référence de configuration de l'agent](reference-agent-configuration.md).
**-A**, **--appspec-filename**
Le nom du AppSpec fichier. Pour les déploiements locaux, les valeurs acceptées sont `appspec.yml` et`appspec.yaml`. Par défaut, le AppSpec fichier est appelé`appspec.yml`.
**-h**, **--help**
Affiche un résumé du contenu d'aide.
**-v**, **--version**
Affiche le numéro de version de l'outil.
## Exemples
Voici des exemples de formats de commande valides.
```
codedeploy-local
```
```
codedeploy-local --bundle-location /path/to/local/bundle/directory
```
```
codedeploy-local --bundle-location C:/path/to/local/bundle.zip --type zip --deployment-group my-deployment-group
```
```
codedeploy-local --bundle-location /path/to/local/directory --type directory --deployment-group my-deployment-group
```
Déployez un bundle depuis Amazon S3 :
```
codedeploy-local --bundle-location s3://amzn-s3-demo-bucket/bundle.tgz --type tgz
```
```
codedeploy-local --bundle-location s3://amzn-s3-demo-bucket/bundle.zip?versionId=1234&etag=47e8 --type zip --deployment-group my-deployment-group
```
Déployez un bundle à partir d'un GitHub dépôt public :
```
codedeploy-local --bundle-location https://github.com/awslabs/aws-codedeploy-sample-tomcat --type zip
```
```
codedeploy-local --bundle-location https://api.github.com/repos/awslabs/aws-codedeploy-sample-tomcat/zipball/master --type zip
```
```
codedeploy-local --bundle-location https://api.github.com/repos/awslabs/aws-codedeploy-sample-tomcat/zipball/HEAD --type zip
```
```
codedeploy-local --bundle-location https://api.github.com/repos/awslabs/aws-codedeploy-sample-tomcat/zipball/1a2b3c4d --type zip
```
Déploiement d'un bundle en spécifiant plusieurs événements de cycle de vie :
```
codedeploy-local --bundle-location /path/to/local/bundle.tar --type tar --application-folder my-deployment --events DownloadBundle,Install,ApplicationStart,HealthCheck
```
Arrêtez une application précédemment déployée à l'aide de l'événement ApplicationStop du cycle de vie :
```
codedeploy-local --bundle-location /path/to/local/bundle.tgz --type tgz --deployment-group --events ApplicationStop
```
Déploiement à l'aide d'un ID de groupe de déploiement spécifique :
```
codedeploy-local --bundle-location C:/path/to/local/bundle/directory --deployment-group 1234abcd-5dd1-4774-89c6-30b107ac5dca
```
```
codedeploy-local --bundle-location C:/path/to/local/bundle.zip --type zip --deployment-group 1234abcd-5dd1-4774-89c6-30b107ac5dca
```