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.
# Tutoriel : Déployez un message « Bonjour tout le monde \$1 » application avec CodeDeploy (Windows Server)
Dans ce didacticiel, vous allez déployer une page Web unique sur une instance Amazon EC2 Windows Server exécutant Internet Information Services (IIS) comme serveur Web. Cette page Web affiche un simple message « Bonjour tout le monde \$1 » message.
Ce n'est pas ce que vous recherchez ?
+ Pour vous entraîner plutôt à déployer sur une instance Amazon EC2 Amazon Linux ou Red Hat Enterprise Linux (RHEL), consultez. [Tutoriel : Déploiement WordPress sur une instance Amazon EC2 (Amazon Linux ou Red Hat Enterprise Linux et Linux, macOS ou Unix)](tutorials-wordpress.md)
+ Pour vous exercer plutôt à déployer sur une instance sur site, consultez la page [Tutoriel : Déployer une application sur une instance locale avec CodeDeploy (Windows Server, Ubuntu Server ou Red Hat Enterprise Linux)](tutorials-on-premises-instance.md).
Les étapes de ce didacticiel sont présentés du point de vue de Windows. Bien que vous puissiez effectuer la plupart de ces étapes sur un ordinateur local exécutant Linux, macOS ou Unix, vous devez adapter celles qui concernent les chemins de répertoire basés sur Windows, tels que. `c:\temp` En outre, si vous souhaitez vous connecter à l'instance Amazon EC2, vous avez besoin d'une application cliente capable de se connecter via le protocole RDP (Remote Desktop Protocol) à l'instance Amazon EC2 exécutant Windows Server. (Windows inclut une application cliente de connexion RDP par défaut.)
Avant de commencer ce didacticiel, vous devez remplir les conditions requises[Commencer avec CodeDeploy](getting-started-codedeploy.md), notamment configurer votre utilisateur, installer ou mettre à niveau le AWS CLI, et créer un profil d'instance IAM et un rôle de service.
**Topics**
+ [Étape 1 : Lancer une instance Amazon EC2 de Windows Server](tutorials-windows-launch-instance.md)
+ [Étape 2 : configurer votre contenu source à déployer sur l'instance Amazon EC2 de Windows Server](tutorials-windows-configure-content.md)
+ [Étape 3 : Téléchargez votre message « Bonjour tout le monde \$1 » application pour Amazon S3](tutorials-windows-upload-application.md)
+ [Étape 4 : Déployez votre application Hello World](tutorials-windows-deploy-application.md)
+ [Étape 5 : Mettez à jour et redéployez votre message « Hello, world \$1 » vigie](tutorials-windows-update-and-redeploy-application.md)
+ [Étape 6 : Nettoyez votre message « Bonjour tout le monde \$1 » application et ressources connexes](tutorials-windows-clean-up.md)
# Étape 1 : Lancer une instance Amazon EC2 de Windows Server
Pour déployer l'application Hello World avec CodeDeploy, vous avez besoin d'une instance Amazon EC2 exécutant Windows Server.
Suivez les instructions de la section [Créez une instance Amazon EC2 pour CodeDeploy](instances-ec2-create.md). Lorsque vous êtes prêt à attribuer une balise d'instance Amazon EC2 à l'instance, assurez-vous de spécifier la clé de balise **Name** et la valeur de balise de. **CodeDeployDemo** (Si vous spécifiez une clé de balise ou une valeur de balise différente, les instructions fournies dans [Étape 4 : Déployez votre application Hello World](tutorials-windows-deploy-application.md) peuvent générer des résultats inattendus.)
Après avoir lancé l'instance Amazon EC2, revenez à cette page et passez à la section suivante. Ne passez pas à l'étape [Créez une application avec CodeDeploy](applications-create.md).
## Connectez-vous à votre instance Amazon EC2
Après le lancement de votre instance Amazon EC2, suivez ces instructions pour vous entraîner à vous y connecter.
**Note**
Dans ces instructions, nous supposons que vous exécutez Windows et l'application cliente de connexion au Bureau Windows. Pour plus d'informations, consultez [Connexion à votre instance Windows à l'aide du protocole RDP.](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/connecting_to_windows_instance.html) Vous devrez peut-être adapter ces instructions pour d'autres systèmes d'exploitation ou d'autres applications clientes de connexion RDP.
1. Connectez-vous à la console Amazon EC2 AWS Management Console et ouvrez-la à l'adresse. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)
1. Dans le panneau de navigation, sous **Instances**, choisissez **Instances**.
1. Accédez à votre instance Windows Server et choisissez-la dans la liste.
1. Choisissez **Se connecter**.
1. Choisissez **Get Password (Obtenir un mot de passe)**, puis choisissez **Choose File (Sélectionner un fichier)**.
1. **Accédez au fichier de paire de clés d'instance Amazon EC2 associé à l'instance Amazon EC2 de Windows Server et choisissez-le, puis choisissez Ouvrir.**
1. Choisissez **Déchiffrer le mot de passe**. Notez le mot de passe qui s'affiche. Vous en aurez besoin à l'étape 10.
1. Choisissez **Télécharger le fichier Bureau à distance**, puis ouvrez le fichier.
1. Si vous êtes invité à vous connecter alors que l'éditeur de la connexion à distance ne peut pas être identifié, continuez.
1. Saisissez le mot de passe que vous avez noté à l'étape 7, puis continuez. (Si votre application cliente de connexion RDP vous invite à fournir un nom utilisateur, tapez **Administrator**.)
1. Si vous êtes invité à vous connecter alors que l'identité de l'ordinateur distant ne peut pas être vérifiée, continuez.
1. Une fois connecté, le bureau de l'instance Amazon EC2 exécutant Windows Server s'affiche.
1. Vous pouvez désormais vous déconnecter de l'instance Amazon EC2.
**Avertissement**
N'arrêtez pas ni ne mettez hors service l'instance. Sinon, CodeDeploy impossible de le déployer.
## Ajoutez une règle entrante qui autorise le trafic HTTP vers votre instance Amazon EC2 de Windows Server
L'étape suivante confirme que votre instance Amazon EC2 possède un port HTTP ouvert afin que vous puissiez voir la page Web déployée sur votre instance Amazon EC2 Windows Server dans un navigateur.
1. Connectez-vous à la console Amazon EC2 AWS Management Console et ouvrez-la à l'adresse. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)
1. Choisissez **Instances**, puis choisissez votre instance.
1. Dans l'onglet **Description**, sous **Groupes de sécurité**, choisissez **Afficher les règles entrantes**.
Vous devriez voir une liste de règles dans votre groupe de sécurité, comme suit :
```
Security Groups associated with i-1234567890abcdef0
Ports Protocol Source launch-wizard-N
22 tcp 0.0.0.0/0 ✔
```
1. Sous **Groupes de sécurité**, choisissez le groupe de sécurité pour votre instance Amazon EC2. Il pourrait être nommé **launch-wizard-*N***. Le ***N*** dans le nom est un numéro attribué à votre groupe de sécurité lorsque l'instance a été créée.
Choisissez l'onglet **Entrant**. Si le groupe de sécurité de votre instance est correctement configuré, vous devriez voir apparaître une règle avec les valeurs suivantes :
+ **Type** : HTTP
+ **Protocole** : TCP
+ **Plage de ports** : 80
+ **Source** : 0.0.0,0/0
1. Si aucune règle ne contient ces valeurs, utilisez les procédures décrites dans [Ajouter des règles à un groupe de sécurité](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-network-security.html#adding-security-group-rule) pour les ajouter à une nouvelle règle de sécurité.
# Étape 2 : configurer votre contenu source à déployer sur l'instance Amazon EC2 de Windows Server
Il est maintenant temps de configurer le contenu source de votre application afin de pouvoir le déployer sur l'instance Amazon EC2. Dans le cadre de ce didacticiel, vous allez déployer une seule page Web sur l'instance Amazon EC2 exécutant Windows Server, qui exécutera Internet Information Services (IIS) en tant que serveur Web. Cette page Web affichera un simple message « Bonjour tout le monde \$1 » message.
**Topics**
+ [Création de la page Web](#tutorials-windows-configure-content-download-code)
+ [Créez un script pour exécuter votre application](#tutorials-windows-configure-content-create-scripts)
+ [Ajouter un fichier de spécification d'application](#tutorials-windows-configure-content-add-appspec-file)
## Création de la page Web
1. Créez un sous-répertoire (sous-dossier) nommé `HelloWorldApp` dans votre dossier `c:\temp`, puis basculez vers ce dossier.
```
mkdir c:\temp\HelloWorldApp
cd c:\temp\HelloWorldApp
```
**Note**
Vous n'êtes pas tenu d'utiliser l'emplacement `c:\temp` ni le nom de sous-dossier `HelloWorldApp`. Si vous utilisez un autre emplacement ou nom de sous-dossier, veillez à l'utiliser tout au long de ce didacticiel.
1. Utilisez un éditeur de texte pour créer un fichier dans le dossier. Nommez le fichier `index.html`.
```
notepad index.html
```
1. Ajoutez le code HTML suivant au fichier, puis enregistrez le fichier.
```
Hello, World!
Hello, World!
You have successfully deployed an application using CodeDeploy
```
## Créez un script pour exécuter votre application
Vous allez ensuite créer un script qui CodeDeploy sera utilisé pour configurer le serveur Web sur l'instance Amazon EC2 cible.
1. Dans le sous-dossier où le fichier `index.html` est enregistré, utilisez un éditeur de texte pour créer un autre fichier. Nommez le fichier `before-install.bat`.
```
notepad before-install.bat
```
1. Ajoutez le code de script de commandes par lot suivant dans le fichier, puis enregistrez le fichier.
```
REM Install Internet Information Server (IIS).
c:\Windows\Sysnative\WindowsPowerShell\v1.0\powershell.exe -Command Import-Module -Name ServerManager
c:\Windows\Sysnative\WindowsPowerShell\v1.0\powershell.exe -Command Install-WindowsFeature Web-Server
```
## Ajouter un fichier de spécification d'application
Vous allez ensuite ajouter un fichier de spécification d'application (AppSpec fichier) en plus de la page Web et du fichier de script batch. Le AppSpec fichier est un fichier au format [YAML](http://www.yaml.org) utilisé pour : CodeDeploy
+ mapper les fichiers sources figurant dans votre révision d'application vers leurs destinations sur l'instance ;
+ spécifier des scripts à exécuter sur l'instance au cours du déploiement.
Le AppSpec fichier doit être nommé`appspec.yml`. Il doit être placé dans le dossier racine du code source de l'application.
1. Dans le sous-dossier où les fichiers `index.html` et `before-install.bat` sont enregistrés, utilisez un éditeur de texte pour créer un autre fichier. Nommez le fichier `appspec.yml`.
```
notepad appspec.yml
```
1. Ajoutez le code YAML suivant au fichier, puis enregistrez le fichier.
```
version: 0.0
os: windows
files:
- source: \index.html
destination: c:\inetpub\wwwroot
hooks:
BeforeInstall:
- location: \before-install.bat
timeout: 900
```
CodeDeploy utilisera ce AppSpec fichier pour copier le `index.html` fichier du dossier racine du code source de l'application vers le `c:\inetpub\wwwroot` dossier de l'instance Amazon EC2 cible. Pendant le déploiement, CodeDeploy exécutera le script `before-install.bat` batch sur l'instance Amazon EC2 cible pendant l'événement du cycle de vie du **BeforeInstall** déploiement. Si l'exécution de ce script prend plus de 900 secondes (15 minutes), il CodeDeploy arrêtera le déploiement et marquera le déploiement sur l'instance Amazon EC2 comme ayant échoué.
Pour plus d'informations sur ces paramètres, consultez la rubrique [CodeDeploy AppSpec référence de fichier](reference-appspec-file.md).
**Important**
Les emplacements et les nombres d'espaces entre les différents éléments de ce fichier sont importants. Si l'espacement est incorrect, cela CodeDeploy provoquera une erreur qui peut être difficile à déboguer. Pour de plus amples informations, veuillez consulter [AppSpec Espacement des fichiers](reference-appspec-file.md#reference-appspec-file-spacing).
# Étape 3 : Téléchargez votre message « Bonjour tout le monde \$1 » application pour Amazon S3
Vous allez maintenant préparer et télécharger votre contenu source vers un emplacement à partir duquel CodeDeploy vous pourrez le déployer. Les instructions suivantes vous montrent comment configurer un compartiment Amazon S3, préparer les fichiers de révision de l'application pour le compartiment, regrouper les fichiers de révision, puis transférer la révision dans le compartiment.
**Note**
Bien que cela ne soit pas abordé dans ce didacticiel, vous pouvez l'utiliser CodeDeploy pour déployer des applications depuis des GitHub référentiels vers des instances. Pour de plus amples informations, veuillez consulter [Intégration CodeDeploy avec GitHub](integrations-partners-github.md).
**Topics**
+ [Provisionner un compartiment Amazon S3](#tutorials-windows-upload-application-create-s3-bucket)
+ [Préparer les fichiers de l'application pour le bucket](#tutorials-windows-upload-application-prepare-application-files)
+ [Regroupez les fichiers de l'application dans un seul fichier d'archive et transférez le fichier d'archive](#tutorials-windows-upload-application-bundle-and-push-archive)
## Provisionner un compartiment Amazon S3
Créez un conteneur ou un *compartiment* de stockage dans Amazon S3 ou utilisez un compartiment existant. Assurez-vous que vous pouvez télécharger la révision dans le compartiment et que les instances Amazon EC2 utilisées dans les déploiements peuvent télécharger la révision depuis le compartiment.
Vous pouvez utiliser AWS CLI la console Amazon S3 ou Amazon S3 APIs pour créer un compartiment Amazon S3. Une fois que vous avez créé le compartiment, veillez à accorder des autorisations d'accès au compartiment et à votre utilisateur CodeDeploy.
**Note**
Les noms de compartiment doivent être uniques sur Amazon S3 pour tous les AWS comptes. Si vous n'êtes pas en mesure d'utiliser **amzn-s3-demo-bucket**, essayez un autre nom de compartiment, tel que **amzn-s3-demo-bucket**, suivi d'un tiret et de vos initiales ou d'un autre identificateur unique. Veillez ensuite à substituer votre nom de compartiment à **amzn-s3-demo-bucket** chaque fois que vous le verrez tout au long de ce didacticiel.
Le compartiment Amazon S3 doit être créé dans la même AWS région que celle dans laquelle vos instances Amazon EC2 cibles sont lancées. Par exemple, si vous créez le bucket dans la région USA Est (Virginie du Nord), vos instances Amazon EC2 cibles doivent être lancées dans la région USA Est (Virginie du Nord).
**Topics**
+ [Pour créer un compartiment Amazon S3 (CLI)](#tutorials-windows-upload-application-create-s3-bucket-cli)
+ [Pour créer un compartiment Amazon S3 (console)](#tutorials-windows-upload-application-create-s3-bucket-console)
+ [Donnez des autorisations au compartiment Amazon S3 et à votre AWS compte](#tutorials-windows-upload-application-create-s3-bucket-grant-permission)
### Pour créer un compartiment Amazon S3 (CLI)
Appelez la **mb** commande pour créer un compartiment Amazon S3 nommé **amzn-s3-demo-bucket** :
```
aws s3 mb s3://amzn-s3-demo-bucket --region region
```
### Pour créer un compartiment Amazon S3 (console)
1. Ouvrez la console Amazon S3 à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Dans la console Amazon S3, choisissez **Create bucket**.
1. Dans la zone **Nom du compartiment**, saisissez un nom pour le compartiment.
1. Dans la liste**Région**, choisissez la région cible, puis **Créer**.
### Donnez des autorisations au compartiment Amazon S3 et à votre AWS compte
Vous devez disposer des autorisations nécessaires pour effectuer le téléchargement dans le compartiment Amazon S3. Vous pouvez spécifier ces autorisations par le biais d'une politique de compartiment Amazon S3. Par exemple, dans la politique de compartiment Amazon S3 suivante, l'utilisation du caractère générique (\$1) permet `111122223333` au AWS compte de télécharger des fichiers dans n'importe quel répertoire du compartiment Amazon S3 nommé `amzn-s3-demo-bucket` :
```
{
"Statement": [
{
"Action": [
"s3:PutObject"
],
"Effect": "Allow",
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*",
"Principal": {
"AWS": [
"111122223333"
]
}
}
]
}
```
Pour consulter l'identifiant de votre AWS compte, consultez la section [Trouver votre identifiant de AWS compte](https://docs.aws.amazon.com/IAM/latest/UserGuide/console_account-alias.html#FindingYourAWSId).
C'est le bon moment pour vérifier que le compartiment Amazon S3 autorisera les demandes de téléchargement provenant de chaque instance Amazon EC2 participante. Vous pouvez le spécifier par le biais d'une politique de compartiment Amazon S3. Par exemple, dans la politique de compartiment Amazon S3 suivante, l'utilisation du caractère générique (\$1) permet à toute instance Amazon EC2 associée à un profil d'instance IAM contenant l'`arn:aws:iam::444455556666:role/CodeDeployDemo`ARN de télécharger des fichiers depuis n'importe quel répertoire 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:role/CodeDeployDemo"
]
}
}
]
}
```
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).
L'utilisateur CodeDeploy administratif que vous avez créé [Étape 1 : Configuration](getting-started-setting-up.md) doit également être autorisé à télécharger la révision dans le compartiment Amazon S3. Pour le spécifier, vous pouvez notamment utiliser une stratégie IAM, que vous ajoutez à l'ensemble d'autorisations de l'utilisateur, ou un rôle IAM (que vous autorisez l'utilisateur à assumer). La politique IAM suivante permet à l'utilisateur de télécharger des révisions n'importe où dans le compartiment Amazon S3 nommé `amzn-s3-demo-bucket` :
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[
{
"Effect":"Allow",
"Action":["s3:PutObject"],
"Resource":"arn:aws:s3:::amzn-s3-demo-bucket/*"
}
]
}
```
------
Pour plus d'informations sur la création d'une stratégie IAM, consultez la section [Création de politiques IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) dans le Guide de l'utilisateur *IAM*. Pour plus d'informations sur l'ajout d'une politique à un ensemble d'autorisations, voir [Création d'un ensemble d'autorisations](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtocreatepermissionset.html) dans le *Guide de AWS IAM Identity Center l'utilisateur*.
## Préparer les fichiers de l'application pour le bucket
Assurez-vous que la page Web, le AppSpec fichier et le script sont organisés sur votre machine de développement comme suit :
```
c:\
|-- temp\
|--HelloWorldApp\
|-- appspec.yml
|-- before-install.bat
|-- index.html
```
## Regroupez les fichiers de l'application dans un seul fichier d'archive et transférez le fichier d'archive
Groupez les fichiers en un fichier d'archive (appelé *révision* d'application).
**Note**
Il est possible qu'il vous soit facturé le stockage des objets dans un compartiment et le transfert des révisions d'application vers et hors d'un compartiment. Pour plus d’informations, consultez [Tarification Amazon S3](https://aws.amazon.com/s3/pricing/).
1. Sur la machine de développement, basculez vers le dossier dans lequel les fichiers sont stockés :
```
cd c:\temp\HelloWorldApp
```
**Note**
Si vous ne basculez pas dans ce dossier, la création d'un bundle de fichiers commencera dans votre dossier actif. Par exemple, si votre dossier actif est `c:\temp` au lieu de `c:\temp\HelloWorldApp`, la création du bundle commencera avec les fichiers et les sous-dossiers figurant dans le dossier `c:\temp`, lequel peut inclure plus que le simple sous-dossier `HelloWorldApp`.
1. Appelez la **create-application** commande pour enregistrer une nouvelle application nommée **HelloWorld\$1App** avec CodeDeploy :
```
aws deploy create-application --application-name HelloWorld_App
```
1. Appelez la commande CodeDeploy [push](https://docs.aws.amazon.com/cli/latest/reference/deploy/push.html) pour regrouper les fichiers, télécharger les révisions CodeDeploy sur Amazon S3 et enregistrer les informations relatives à la révision téléchargée, le tout en une seule action.
```
aws deploy push --application-name HelloWorld_App --s3-location s3://amzn-s3-demo-bucket/HelloWorld_App.zip --ignore-hidden-files
```
Cette commande regroupe les fichiers du répertoire actuel (à l'exception des fichiers cachés) dans un seul fichier d'archive nommé`HelloWorld_App.zip`, télécharge la révision dans le **amzn-s3-demo-bucket** compartiment et enregistre les informations relatives à CodeDeploy la révision téléchargée.
# Étape 4 : Déployez votre application Hello World
Vous devez maintenant déployer l'exemple de révision de l'application Hello World que vous avez chargé sur Amazon S3. Vous utilisez la console AWS CLI ou la CodeDeploy console pour déployer la révision et suivre la progression du déploiement. Une fois que la révision d'application est déployée avec succès, vous vérifiez les résultats.
**Topics**
+ [Déployez la révision de votre application avec CodeDeploy](#tutorials-windows-deploy-application-create-deployment)
+ [Surveillez et résolvez les problèmes liés à votre déploiement](#tutorials-windows-deploy-application-monitor)
+ [Vérifiez votre déploiement](#tutorials-windows-deploy-application-verify)
## Déployez la révision de votre application avec CodeDeploy
Vous pouvez déployer votre application via l'interface de ligne de commande ou la console.
**Topics**
+ [Pour déployer votre révision d'application (interface CLI)](#tutorials-windows-deploy-application-create-deployment-cli)
+ [Pour déployer votre révision d'application (console)](#tutorials-windows-deploy-application-create-deployment-console)
### Pour déployer votre révision d'application (interface CLI)
1. Tout d'abord, le déploiement a besoin d'un groupe de déploiement. Toutefois, avant de créer le groupe de déploiement, vous avez besoin d'un nom ARN de rôle de service. Un rôle de service est un rôle IAM qui autorise un service à agir en votre nom. Dans ce cas, le rôle de service donne CodeDeploy l'autorisation d'accéder à vos instances Amazon EC2 pour étendre (lire) leurs balises d'instance Amazon EC2.
Vous devriez avoir déjà suivi les instructions de la rubrique [Création d'un rôle de service (CLI)](getting-started-create-service-role.md#getting-started-create-service-role-cli) pour créer un rôle de service. Pour obtenir le nom ARN du rôle de service, consultez la page [Obtenez l'ARN du rôle de service (CLI)](getting-started-create-service-role.md#getting-started-get-service-role-cli).
1. Maintenant que vous avez l'ARN, appelez la **create-deployment-group** commande pour créer un groupe de déploiement nommé**HelloWorld\$1DepGroup**, associé à l'application nommée**HelloWorld\$1App**, à l'aide de la balise d'instance Amazon EC2 **CodeDeployDemo** et du nom de la configuration de déploiement**CodeDeployDefault.OneAtATime**, avec l'ARN du rôle de service :
```
aws deploy create-deployment-group --application-name HelloWorld_App --deployment-group-name HelloWorld_DepGroup --deployment-config-name CodeDeployDefault.OneAtATime --ec2-tag-filters Key=Name,Value=CodeDeployDemo,Type=KEY_AND_VALUE --service-role-arn serviceRoleARN
```
**Note**
La [create-deployment-group](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment-group.html)commande permet de créer des déclencheurs qui entraînent l'envoi de notifications Amazon SNS aux abonnés du topic concernant des événements spécifiques liés aux déploiements et aux instances. La commande prend également en charge les options permettant d'annuler automatiquement les déploiements et de configurer des alarmes pour arrêter les déploiements lorsque les seuils de surveillance des CloudWatch alarmes d'Amazon sont atteints. Les commandes associées à ces actions ne sont pas incluses dans ce didacticiel.
1. Avant de créer un déploiement, l' CodeDeploy agent doit être installé sur les instances de votre groupe de déploiement. Vous pouvez installer l'agent à partir de la ligne de commande AWS Systems Manager avec la commande suivante :
```
aws ssm create-association --name AWS-ConfigureAWSPackage --targets Key=tag:Name,Values=CodeDeployDemo --parameters action=Install,name=AWSCodeDeployAgent --schedule-expression "cron(0 2 ? * SUN *)"
```
Cette commande crée une association dans Systems Manager State Manager qui installera l' CodeDeploy agent puis tentera de le mettre à jour à 2h00 tous les dimanches matins. Pour plus d'informations sur l' CodeDeploy agent, consultez la section [Utilisation de l' CodeDeploy agent](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent.html). Pour plus d'informations sur Systems Manager, consultez [What is AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html).
1. Maintenant, appelez la commande **create-deployment** pour créer un déploiement associé à l'application nommée **HelloWorld\$1App**, à la configuration de déploiement nommée **CodeDeployDefault.OneAtATime** et au groupe de déploiement nommé **HelloWorld\$1DepGroup**, en utilisant la révision d'application nommée **HelloWorld\$1App.zip** dans le compartiment nommé **amzn-s3-demo-bucket** :
```
aws deploy create-deployment --application-name HelloWorld_App --deployment-config-name CodeDeployDefault.OneAtATime --deployment-group-name HelloWorld_DepGroup --s3-location bucket=amzn-s3-demo-bucket,bundleType=zip,key=HelloWorld_App.zip
```
### Pour déployer votre révision d'application (console)
1. Avant d'utiliser la CodeDeploy console pour déployer la révision de votre application, vous avez besoin d'un ARN de rôle de service. Un rôle de service est un rôle IAM qui autorise un service à agir en votre nom. Dans ce cas, le rôle de service donne CodeDeploy l'autorisation d'accéder à vos instances Amazon EC2 pour étendre (lire) leurs balises d'instance Amazon EC2.
Vous devriez avoir déjà suivi les instructions de la rubrique [Création d'un rôle de service (console)](getting-started-create-service-role.md#getting-started-create-service-role-console) pour créer un rôle de service. Pour obtenir le nom ARN du rôle de service, consultez la page [Obtenir l'ARN du rôle de service (console)](getting-started-create-service-role.md#getting-started-get-service-role-console).
1. Maintenant que vous disposez de l'ARN, vous pouvez utiliser la CodeDeploy console pour déployer la révision de votre application.
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 **Applications**.
1. Choisissez **HelloWorld\$1App.**
1. Dans l'onglet **Groupes de déploiement**, choisissez **Créer un groupe de déploiement**.
1. Dans **Nom du groupe de déploiement**, saisissez **HelloWorld\$1DepGroup**.
1. Dans **Rôle de service**, choisissez le nom du rôle de service.
1. Dans **Type de déploiement**, choisissez **Sur place**.
1. Dans **Configuration de l'environnement**, sélectionnez les **instances Amazon EC2.**
1. Dans la **configuration de l'agent avec AWS Systems Manager**, conservez les valeurs par défaut.
1. Dans **Clé**, entrez **Name**.
1. Dans **Value (Valeur)**, entrez **CodeDeployDemo**.
1. Dans **Configuration du déploiement**, choisissez **CodeDeployDefault. OneAtATime**.
1. Dans **Équilibreur de charge**, désactivez **Activer l'équilibrage de charge**.
1. Choisissez **Créer un groupe de déploiement**.
1. Choisissez **Créer un déploiement**.
1. Dans **le groupe de déploiement**, choisissez **HelloWorld\$1 DepGroup**
1. Dans **Type de révision**, choisissez **Mon application est stockée dans Amazon S3**, puis dans Emplacement de **la révision, entrez l'emplacement** de l'exemple de révision de l'application Hello World que vous avez précédemment chargé sur Amazon S3. Pour obtenir cet emplacement :
1. Ouvrez la console Amazon S3 à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Dans la liste des buckets, choisissez **amzn-s3-demo-bucket (ou le nom du bucket dans lequel** vous avez chargé la révision de votre application).
1. Dans la liste des objets, choisissez **HelloWorld\$1App.zip**.
1. Dans l’onglet **Overview (Présentation)**, choisissez **Copy path (Copier le chemin)**.
1. Retournez à la CodeDeploy console, puis dans **Emplacement des révisions**, collez la valeur du champ **Lien**.
1. Pour **Revision file type (Type de fichier de révision)**, choisissez **.zip**.
1. (Facultatif) Entrez un commentaire dans **Deployment description) Description du déploiement**.
1. Choisissez **Créer un déploiement**. Des informations sur votre déploiement nouvellement créé s'affichent dans la page **Deployments**.
## Surveillez et résolvez les problèmes liés à votre déploiement
Utilisez la console AWS CLI ou la console pour surveiller et résoudre les problèmes liés à votre déploiement.
**Topics**
+ [Pour surveiller et dépanner votre déploiement (interface CLI)](#tutorials-windows-deploy-application-monitor-cli)
+ [Pour surveiller et dépanner votre déploiement (console)](#tutorials-windows-deploy-application-monitor-console)
### Pour surveiller et dépanner votre déploiement (interface CLI)
1. Obtenez l'ID du déploiement en appelant la commande **list-deployments** sur l'application nommée **HelloWorld\$1App** et le groupe de déploiement nommé **HelloWorld\$1DepGroup** :
```
aws deploy list-deployments --application-name HelloWorld_App --deployment-group-name HelloWorld_DepGroup --query "deployments" --output text
```
1. Appelez la commande **get-deployment** avec l'ID du déploiement :
```
aws deploy get-deployment --deployment-id deploymentID --query "deploymentInfo.status" --output text
```
1. La commande renvoie l'état général du déploiement. En cas de réussite, la valeur est `Succeeded`.
Si l'état général est `Failed`, vous pouvez appeler des commandes telles que [list-deployment-instances](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-instances.html) et [get-deployment-instance](https://docs.aws.amazon.com/cli/latest/reference/deploy/get-deployment-instance.html) pour résoudre les problèmes. Pour plus d'options de dépannage, consultez la page [Analyse des fichiers journaux pour enquêter sur des échecs de déploiement sur les instances](troubleshooting-ec2-instances.md#troubleshooting-deploy-failures).
### Pour surveiller et dépanner votre déploiement (console)
Sur la page **Déploiements** de la CodeDeploy console, vous pouvez surveiller l'état de votre déploiement dans la colonne **État**.
Pour obtenir plus d'informations sur votre déploiement, notamment si la valeur de la colonne **État**a une valeur différente de **Succeeded** :
1. Dans la table **Déploiements**, choisissez votre ID de déploiement. Une fois qu'un déploiement a échoué, un message décrivant la raison de l'échec s'affiche sur la page des détails du déploiement.
1. . Des informations supplémentaires sur les instances du déploiement sont affichées. Après l'échec d'un déploiement, vous pourrez peut-être déterminer sur quelles instances Amazon EC2 et à quelle étape le déploiement a échoué.
1. Si vous souhaitez effectuer davantage d'opérations de dépannage, vous pouvez utiliser une technique telle que celle exposée dans la rubrique [Afficher les détails de l'instance avec CodeDeploy](instances-view-details.md). Vous pouvez également analyser les fichiers journaux de déploiement sur une instance Amazon EC2. 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).
## Vérifiez votre déploiement
Une fois que votre déploiement a réussi, vérifiez que votre installation fonctionne. Utilisez l'adresse DNS publique de l'instance Amazon EC2 pour afficher la page Web dans un navigateur Web. (Pour obtenir la valeur du DNS public, dans la console Amazon EC2, choisissez l'instance Amazon EC2, puis dans l'onglet Description, recherchez **la** valeur **dans** Public DNS.)
Par exemple, si l'adresse DNS publique de votre instance Amazon EC2 est**ec2-01-234-567-890.compute-1.amazonaws.com**, vous devez utiliser l'URL suivante :
```
http://ec2-01-234-567-890.compute-1.amazonaws.com
```
En cas de succès, vous devez voir une page Web « Hello, World\$1 ».
# Étape 5 : Mettez à jour et redéployez votre message « Hello, world \$1 » vigie
Maintenant que vous avez déployé avec succès la révision de votre application, sur la machine de développement, mettez à jour le code de la page Web, puis utilisez-le CodeDeploy pour redéployer le site. Après le redéploiement, vous devriez être en mesure de voir les modifications sur l'instance Amazon EC2.
**Topics**
+ [Modifier la page Web](#tutorials-windows-update-and-redeploy-application-modify-code)
+ [Redéployer le site](#tutorials-windows-update-and-redeploy-application-deploy-updates)
## Modifier la page Web
1. Accédez à votre sous-dossier `c:\temp\HelloWorldApp` et utilisez un éditeur de texte pour modifier le fichier `index.html` :
```
cd c:\temp\HelloWorldApp
notepad index.html
```
1. Révisez le contenu du fichier `index.html` pour modifier la couleur d'arrière-plan et une partie du texte sur la page web, puis enregistrez le fichier :
```
Hello Again, World!
Hello Again, World!
You have successfully deployed a revision of an application using CodeDeploy
```
## Redéployer le site
Maintenant que vous avez modifié le code, utilisez Amazon S3 CodeDeploy pour redéployer la page Web.
Regroupez et chargez les modifications sur Amazon S3 comme décrit dans[Regroupez les fichiers de l'application dans un seul fichier d'archive et transférez le fichier d'archive](tutorials-windows-upload-application.md#tutorials-windows-upload-application-bundle-and-push-archive). (Lorsque vous suivez ces instructions, vous n'avez pas besoin de créer une nouvelle application.) Donnez à la révision la même clé qu'auparavant (**HelloWorld\$1App.zip**). Téléchargez-le dans le même compartiment Amazon S3 que vous avez créé précédemment (par exemple,**amzn-s3-demo-bucket**).
Utilisez la console AWS CLI ou la CodeDeploy console pour redéployer le site.
**Topics**
+ [Pour redéployer le site (interface CLI)](#tutorials-windows-update-and-redeploy-application-deploy-updates-cli)
+ [Pour redéployer le site (console)](#tutorials-windows-update-and-redeploy-application-deploy-updates-console)
### Pour redéployer le site (interface CLI)
Appelez la commande **create-deployment** pour créer un déploiement basé sur la révision téléchargée, de nouveau en utilisant l'application nommée **HelloWorld\$1App**, la configuration de déploiement nommée **CodeDeployDefault.OneAtATime** et le groupe de déploiement nommé **HelloWorld\$1DepGroup** et la révision nommée **HelloWorld\$1App.zip** dans le compartiment nommé **amzn-s3-demo-bucket** :
```
aws deploy create-deployment --application-name HelloWorld_App --deployment-config-name CodeDeployDefault.OneAtATime --deployment-group-name HelloWorld_DepGroup --s3-location bucket=amzn-s3-demo-bucket,bundleType=zip,key=HelloWorld_App.zip
```
Vous pouvez vérifier l'état du nouveau déploiement, comme décrit dans la rubrique [Surveillez et résolvez les problèmes liés à votre déploiement](tutorials-windows-deploy-application.md#tutorials-windows-deploy-application-monitor).
Une fois le site CodeDeploy redéployé, revisitez-le dans votre navigateur Web pour vérifier que la couleur d'arrière-plan et le texte de la page Web ont été modifiés. (Vous devrez peut-être actualiser votre navigateur.) Si la couleur d'arrière-plan et le texte ont été modifiés, vous avez réussi la procédure. Vous avez modifié et redéployé votre site.
### Pour redéployer le site (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 , choisissez **Applications**.
1. Dans la liste des **applications**, choisissez **HelloWorld\$1App**.
1. Dans l'onglet **Déploiements**, choisissez **Créer un déploiement**.
1. Dans la liste des **groupes de déploiement**, choisissez **HelloWorld\$1 DepGroup**.
1. Dans **Emplacement de la révision**, entrez le lien Amazon S3 correspondant à votre révision.
Pour trouver la valeur du lien :
1. 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/).
Accédez à **amzn-s3-demo-bucket** et ouvrez-le, puis choisissez votre révision dans **HelloWorld\$1App.zip** la console Amazon S3.
1. Si le volet **Propriétés** n'est pas visible dans la console Amazon S3, cliquez sur le bouton **Propriétés**.
1. Dans le volet **Propriétés**, copiez la valeur du champ **Lien**.
1. Retournez à la CodeDeploy console, puis collez le lien dans l'**emplacement de la révision**.
1. Dans **Type de fichier de révision**, si un message indique que le type de fichier n'a pas pu être détecté, choisissez **.zip**.
1. Laissez **Description du déploiement** vide.
1. **Étendre les **remplacements des groupes de déploiement** Dans la liste **de configuration du déploiement**, sélectionnezCodeDeployDefault. OneAtATime**, puis choisissez **Create deployment**.
Vous pouvez vérifier l'état du déploiement comme décrit dans la rubrique [Surveillez et résolvez les problèmes liés à votre déploiement](tutorials-windows-deploy-application.md#tutorials-windows-deploy-application-monitor).
Une fois le site CodeDeploy redéployé, revisitez-le dans votre navigateur Web pour vérifier que la couleur d'arrière-plan et le texte de la page Web ont été modifiés. (Vous devrez peut-être actualiser votre navigateur.) Si la couleur d'arrière-plan et le texte ont été modifiés, vous avez réussi la procédure. Vous avez modifié et redéployé votre site.
# Étape 6 : Nettoyez votre message « Bonjour tout le monde \$1 » application et ressources connexes
Vous avez maintenant correctement mis à jour le message « Hello, World \$1 » codez et redéployez le site. Pour éviter des frais permanents pour les ressources que vous avez créées pour effectuer ce didacticiel, vous devez supprimer :
+ Toutes les CloudFormation piles (ou résiliez toute instance Amazon EC2, si vous les avez créées en dehors CloudFormation de).
+ Tous les compartiments Amazon S3.
+ l'application `HelloWorld_App` dans CodeDeploy ;
+ L'association AWS Systems Manager State Manager de l' CodeDeploy agent.
Vous pouvez utiliser les AWS CLI consoles Amazon S3, Amazon EC2 et les CodeDeploy consoles, ou AWS APIs pour effectuer le nettoyage. CloudFormation
**Topics**
+ [Pour nettoyer les ressources (interface CLI)](#tutorials-windows-clean-up-cli)
+ [Pour nettoyer les ressources (console)](#tutorials-windows-clean-up-console)
+ [Quelle est la prochaine étape ?](#tutorials-windows-clean-up-whats-next)
## Pour nettoyer les ressources (interface CLI)
1. Si vous avez utilisé la CloudFormation pile pour ce didacticiel, supprimez-la en appelant la **delete-stack** commande correspondant à la pile nommée**CodeDeployDemoStack**. Cela met fin à toutes les instances Amazon EC2 associées et supprime tous les rôles IAM associés créés à l'origine par la pile.
```
aws cloudformation delete-stack --stack-name CodeDeployDemoStack
```
1. Pour supprimer le compartiment Amazon S3, appelez la **rm** commande en utilisant le **--recursive** commutateur correspondant au compartiment nommé**amzn-s3-demo-bucket**. Elle supprime le compartiment et tous les objets qui y figurent.
```
aws s3 rm s3://amzn-s3-demo-bucket --recursive --region region
```
1. Pour supprimer l'`HelloWorld_App`application CodeDeploy, appelez la **delete-application** commande. Elle supprime tous les enregistrements de groupe de déploiement et les enregistrements de déploiement associés pour l'application.
```
aws deploy delete-application --application-name HelloWorld_App
```
1. Pour supprimer l'association Systems Manager State Manager, appelez la **delete-association** commande.
```
aws ssm delete-association --assocation-id association-id
```
Vous pouvez l'obtenir *association-id* en appelant la **describe-association** commande.
```
aws ssm describe-association --name AWS-ConfigureAWSPackage --targets Key=tag:Name,Values=CodeDeployDemo
```
1. Si vous n'avez pas utilisé la CloudFormation pile pour ce didacticiel, appelez la **terminate-instances** commande pour mettre fin aux instances Amazon EC2 que vous avez créées manuellement. Fournissez l'ID de l'instance Amazon EC2 à résilier.
```
aws ec2 terminate-instances --instance-ids instanceId
```
## Pour nettoyer les ressources (console)
Si vous avez utilisé notre CloudFormation modèle pour ce didacticiel, supprimez la CloudFormation pile associée.
1. Connectez-vous à la CloudFormation console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/cloudformation.](https://console.aws.amazon.com/cloudformation/)
1. Dans la zone de recherche, tapez le nom de la CloudFormation pile (par exemple,**CodeDeployDemoStack**).
1. Cochez la case en regard du nom de la pile.
1. Dans le menu **Actions**, sélectionnez **Supprimer pile**. Cela supprime la pile, met fin à toutes les instances Amazon EC2 associées et supprime tous les rôles IAM associés.
Pour mettre fin aux instances Amazon EC2 que vous avez créées en dehors d'une CloudFormation pile :
1. Connectez-vous à la console Amazon EC2 AWS Management Console et ouvrez-la à l'adresse. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)
1. Dans la zone **Instances**, choisissez **Instances**.
1. **Dans le champ de recherche, tapez le nom de l'instance Amazon EC2 que vous souhaitez résilier, puis appuyez sur Entrée.**
1. Choisissez l'instance Amazon EC2.
1. Choisissez **Actions**, pointez sur **État de l'instance**, puis choisissez **Terminer**. À l'invite, choisissez **Oui, résilier**. Répétez ces étapes pour toutes les instances Amazon EC2 supplémentaires.
Pour supprimer le compartiment Amazon S3, procédez comme suit :
1. 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/).
1. Dans la liste des compartiments, recherchez et choisissez le nom du compartiment Amazon S3 (par exemple,**amzn-s3-demo-bucket**).
1. Avant de pouvoir supprimer un compartiment, vous devez d'abord supprimer son contenu. Sélectionnez tous les fichiers figurant dans le compartiment, tels que **HelloWorld\$1App.zip**. Dans le menu **Actions**, sélectionnez **Delete**. Lorsque vous êtes invité à confirmer la suppression, choisissez **OK**.
1. Une fois que le compartiment est vide, vous pouvez le supprimer. Dans la liste des compartiments, sélectionnez la ligne du compartiment (mais pas son nom). Choisissez **Supprimer le compartiment**, lorsque vous êtes invité à confirmer, puis **OK**.
Pour supprimer l'`HelloWorld_App`application depuis 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 le volet de navigation, développez **Deploy**, puis choisissez **Applications**.
1. Sélectionnez **`HelloWorld_App`**.
1. Choisissez **Supprimer l'application**.
1. Lorsque vous y êtes invité, tapez **Delete**, puis choisissez **Supprimer**.
Pour supprimer l'association Systems Manager State Manager, procédez comme suit :
1. Ouvrez la AWS Systems Manager console dans https://console.aws.amazon.com /systems-manager.
1. Dans le volet de navigation, sélectionnez **State Manager**.
1. Sélectionnez l'association que vous avez créée et choisissez **Delete (Supprimer)**.
## Quelle est la prochaine étape ?
Si vous êtes arrivé ici, vous avez terminé avec succès un déploiement avec CodeDeploy. Félicitations \$1