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.
# Gestion des opérations des CodeDeploy agents
Les instructions de cette section vous indiquent comment installer, désinstaller, réinstaller ou mettre à jour l' CodeDeploy agent et comment vérifier que l' CodeDeploy agent est en cours d'exécution.
**Topics**
+ [Vérifiez que l' CodeDeploy agent est en cours d'exécution](codedeploy-agent-operations-verify.md)
+ [Déterminer la version de l' CodeDeploy agent](codedeploy-agent-operations-version.md)
+ [Installation de l' CodeDeploy agent](codedeploy-agent-operations-install.md)
+ [Mettre à jour l' CodeDeploy agent](codedeploy-agent-operations-update.md)
+ [Désinstallez l' CodeDeploy agent](codedeploy-agent-operations-uninstall.md)
+ [Envoyer les journaux des CodeDeploy agents à CloudWatch](codedeploy-agent-operations-cloudwatch-agent.md)
# Vérifiez que l' CodeDeploy agent est en cours d'exécution
Cette section décrit les commandes à exécuter si vous pensez que l' CodeDeploy agent a cessé de s'exécuter sur une instance.
**Topics**
+ [Vérifiez que l' CodeDeploy agent pour Amazon Linux ou RHEL est en cours d'exécution](#codedeploy-agent-operations-verify-linux)
+ [Vérifiez que l' CodeDeploy agent pour Ubuntu Server est en cours d'exécution](#codedeploy-agent-operations-verify-ubuntu)
+ [Vérifiez que l' CodeDeploy agent pour Windows Server est en cours d'exécution](#codedeploy-agent-operations-verify-windows)
## Vérifiez que l' CodeDeploy agent pour Amazon Linux ou RHEL est en cours d'exécution
Pour vérifier si l' CodeDeploy agent est installé et en cours d'exécution, connectez-vous à l'instance et exécutez la commande suivante :
```
systemctl status codedeploy-agent
```
Si la commande renvoie une erreur, l' CodeDeploy agent n'est pas installé. Installez-le comme cela est décrit dans la rubrique [Installation de l' CodeDeploy agent pour Amazon Linux ou RHEL](codedeploy-agent-operations-install-linux.md).
Si l' CodeDeploy agent est installé et en cours d'exécution, vous devriez voir un message tel que`The AWS CodeDeploy agent is running`.
Si vous voyez un message tel que `error: No AWS CodeDeploy agent running`, démarrez le service et exécutez les deux commandes suivantes, l'une après l'autre :
```
systemctl start codedeploy-agent
```
```
systemctl status codedeploy-agent
```
## Vérifiez que l' CodeDeploy agent pour Ubuntu Server est en cours d'exécution
Pour vérifier si l' CodeDeploy agent est installé et en cours d'exécution, connectez-vous à l'instance et exécutez la commande suivante :
```
systemctl status codedeploy-agent
```
Si la commande renvoie une erreur, l' CodeDeploy agent n'est pas installé. Installez-le comme cela est décrit dans la rubrique [Installation de l' CodeDeploy agent pour Ubuntu Server](codedeploy-agent-operations-install-ubuntu.md).
Si l' CodeDeploy agent est installé et en cours d'exécution, vous devriez voir un message tel que`The AWS CodeDeploy agent is running`.
Si vous voyez un message tel que `error: No AWS CodeDeploy agent running`, démarrez le service et exécutez les deux commandes suivantes, l'une après l'autre :
```
systemctl start codedeploy-agent
```
```
systemctl status codedeploy-agent
```
## Vérifiez que l' CodeDeploy agent pour Windows Server est en cours d'exécution
Pour vérifier si l' CodeDeploy agent est installé et en cours d'exécution, connectez-vous à l'instance et exécutez la commande suivante :
```
powershell.exe -Command Get-Service -Name codedeployagent
```
Vous devez voir des résultats similaires à ce qui suit :
```
Status Name DisplayName
------ ---- -----------
Running codedeployagent CodeDeploy Host Agent Service
```
Si la commande renvoie une erreur, l' CodeDeploy agent n'est pas installé. Installez-le comme cela est décrit dans la rubrique [Installation de l' CodeDeploy agent pour Windows Server](codedeploy-agent-operations-install-windows.md).
Si `Status` montre quelque chose d'autre que `Running`, démarrez le service avec la commande suivante :
```
powershell.exe -Command Start-Service -Name codedeployagent
```
Vous pouvez redémarrer le service avec la commande suivante :
```
powershell.exe -Command Restart-Service -Name codedeployagent
```
Vous pouvez arrêter le service avec la commande suivante :
```
powershell.exe -Command Stop-Service -Name codedeployagent
```
# Déterminer la version de l' CodeDeploy agent
Vous pouvez déterminer la version de l' CodeDeploy agent exécutée sur votre instance de deux manières.
Tout d'abord, à partir de la version 1.0.1.854 de l' CodeDeploy agent, vous pouvez afficher le numéro de version dans un `.version` fichier de l'instance. Le tableau suivant montre l'emplacement et l'exemple de chaîne de version pour chacun des systèmes d'exploitation pris en charge.
| Système d’exploitation | Emplacement du fichier | Exemple de chaîne agent\$1version |
| --- | --- | --- |
| Amazon Linux et Red Hat Enterprise Linux (RHEL) | /opt/codedeploy-agent/.version | OFFICIAL\$11.0.1.854\$1rpm |
| Ubuntu Server | /opt/codedeploy-agent/.version | OFFICIAL\$11.0.1.854\$1deb |
| Windows Server | C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1.version | OFFICIAL\$11.0.1.854\$1msi |
Ensuite, vous pouvez exécuter une commande sur une instance afin de déterminer la version de l'agent CodeDeploy.
**Topics**
+ [Déterminez la version sur Amazon Linux ou RHEL](#codedeploy-agent-operations-version-linux)
+ [Déterminer la version sur le serveur Ubuntu](#codedeploy-agent-operations-version-ubuntu)
+ [Déterminer la version sur Windows Server](#codedeploy-agent-operations-version-windows)
## Déterminez la version sur Amazon Linux ou RHEL
Connectez-vous à l'instance et exécutez la commande suivante :
```
sudo yum info codedeploy-agent
```
## Déterminer la version sur le serveur Ubuntu
Connectez-vous à l'instance et exécutez la commande suivante :
```
sudo dpkg -s codedeploy-agent
```
## Déterminer la version sur Windows Server
Connectez-vous à l'instance et exécutez la commande suivante :
```
sc qdescription codedeployagent
```
# Installation de l' CodeDeploy agent
Pour être utilisé CodeDeploy sur des instances EC2 ou des serveurs locaux, l' CodeDeploy agent doit d'abord être installé. Nous vous recommandons d'installer et de mettre à jour l' CodeDeploy agent avec AWS Systems Manager. 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). Vous pouvez configurer l'installation et les mises à jour planifiées de l' CodeDeployagent avec Systems Manager dans la console lorsque vous créez vos groupes de déploiement.
Vous pouvez également installer l' CodeDeploy agent directement depuis un compartiment S3 à l'aide de la ligne de commande.
Pour connaître la version recommandée à installer, voir[Historique des versions de l' CodeDeploy agent](codedeploy-agent.md#codedeploy-agent-version-history).
**Topics**
+ [Installez l' CodeDeploy agent à l'aide de AWS Systems Manager](codedeploy-agent-operations-install-ssm.md)
+ [Installation de l' CodeDeploy agent à l'aide de la ligne de commande](codedeploy-agent-operations-install-cli.md)
# Installez l' CodeDeploy agent à l'aide de AWS Systems Manager
Vous pouvez utiliser le AWS Management Console ou AWS CLI pour installer l' CodeDeploy agent sur vos instances Amazon EC2 ou sur site en utilisant. AWS Systems Manager Vous pouvez choisir d'installer une version spécifique ou de toujours installer la version la plus récente de l'agent. Pour plus d'informations AWS Systems Manager, voir [Qu'est-ce que AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html).
L'utilisation AWS Systems Manager est la méthode recommandée pour installer et mettre à jour l' CodeDeploy agent. Vous pouvez également installer l' CodeDeploy agent à partir d'un compartiment Amazon S3. Pour de plus amples informations sur l'utilisation d'un lien de téléchargement Amazon S3, consultez [Installation de l' CodeDeploy agent à l'aide de la ligne de commande](codedeploy-agent-operations-install-cli.md).
**Topics**
+ [Conditions préalables](#install-codedeploy-agent-prereqs)
+ [Installation de l' CodeDeploy agent](#download-codedeploy-agent-on-EC2-Instance)
## Conditions préalables
Suivez les étapes décrites [Commencer avec CodeDeploy](getting-started-codedeploy.md) pour configurer les autorisations IAM et le AWS CLI.
Si vous installez l' CodeDeploy agent sur un serveur local avec Systems Manager, vous devez enregistrer votre serveur local auprès d'Amazon EC2 Systems Manager. Pour plus d'informations, consultez la section [Configuration de Systems Manager dans les environnements hybrides](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-managedinstances.html) dans le *Guide de AWS Systems Manager l'utilisateur*.
## Installation de l' CodeDeploy agent
Avant de pouvoir utiliser Systems Manager pour installer l' CodeDeploy agent, vous devez vous assurer que l'instance est correctement configurée pour Systems Manager.
### Installation ou mise à jour de l'agent SSM
Sur une instance Amazon EC2, l' CodeDeploy agent doit exécuter la version 2.3.274.0 ou ultérieure. Avant d'installer l' CodeDeploy agent, mettez à jour ou installez l'agent SSM sur l'instance si ce n'est déjà fait.
L'agent SSM est préinstallé sur certains Amazon AMIs EC2 fournis par. AWS Pour plus d'informations, consultez [Amazon Machine Images (AMIs) avec agent SSM préinstallé](https://docs.aws.amazon.com/systems-manager/latest/userguide/ami-preinstalled-agent.html).
**Note**
Assurez-vous que le système d'exploitation de l'instance est également pris en charge par l' CodeDeployagent. Pour de plus amples informations, veuillez consulter [Systèmes d'exploitation pris en charge par l' CodeDeploy agent](codedeploy-agent.md#codedeploy-agent-supported-operating-systems).
Pour plus d'informations sur l'installation ou la mise à jour de l'agent SSM sur une instance exécutant Linux, consultez la section [Installation et configuration de l'agent SSM sur les instances Linux](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-ssm-agent.html) dans le Guide de l'*AWS Systems Manager utilisateur*.
Pour plus d'informations sur l'installation ou la mise à jour de l'agent SSM sur une instance exécutant Windows Server, consultez la section [Installation et configuration de l'agent SSM sur les instances Windows](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-ssm-win.html) dans le Guide de l'*AWS Systems Manager utilisateur*.
### (Facultatif) Vérification des prérequis de Systems Manager
Avant d'utiliser la commande Run Command de Systems Manager pour installer l' CodeDeploy agent, vérifiez que vos instances répondent aux exigences minimales de Systems Manager. Pour plus d’informations, consultez [Configuration d’ AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up.html) dans le *Guide de l’utilisateur AWS Systems Manager *.
### Installation de l' CodeDeploy agent
Avec SSM, vous pouvez l'installer CodeDeploy une seule fois ou établir un calendrier pour installer les nouvelles versions.
Pour installer l' CodeDeploy agent, choisissez le `AWSCodeDeployAgent` package en suivant les étapes décrites dans [Installer ou mettre à jour les packages avec le AWS Systems Manager distributeur](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor-working-with-packages-deploy.html).
# Installation de l' CodeDeploy agent à l'aide de la ligne de commande
**Note**
Nous vous recommandons d'installer l' CodeDeploy agent AWS Systems Manager pour pouvoir configurer les mises à jour planifiées de l'agent. Pour de plus amples informations, veuillez consulter [Installez l' CodeDeploy agent à l'aide de AWS Systems Manager](codedeploy-agent-operations-install-ssm.md).
Utilisez les rubriques suivantes pour installer et exécuter l' CodeDeploy agent à l'aide de la ligne de commande.
**Topics**
+ [Installation de l' CodeDeploy agent pour Amazon Linux ou RHEL](codedeploy-agent-operations-install-linux.md)
+ [Installation de l' CodeDeploy agent pour Ubuntu Server](codedeploy-agent-operations-install-ubuntu.md)
+ [Installation de l' CodeDeploy agent pour Windows Server](codedeploy-agent-operations-install-windows.md)
# Installation de l' CodeDeploy agent pour Amazon Linux ou RHEL
Connectez-vous à l'instance et exécutez les commandes suivantes, l'une après l'autre. L'exécution de la commande en `sudo yum update` `yum` premier est considérée comme une bonne pratique lors de l'installation de packages, mais vous pouvez l'ignorer si vous ne souhaitez pas mettre à jour tous vos packages.
```
sudo yum update
```
```
sudo yum install ruby
```
```
sudo yum install wget
```
(Facultatif) Pour nettoyer l'AMI de toutes les informations de mise en cache de l'agent précédentes, exécutez le script suivant :
```
#!/bin/bash
CODEDEPLOY_BIN="/opt/codedeploy-agent/bin/codedeploy-agent"
$CODEDEPLOY_BIN stop
yum erase codedeploy-agent -y
```
Accédez à votre répertoire personnel :
```
cd /home/ec2-user
```
**Note**
Dans la commande précédente, `/home/ec2-user` représente le nom d'utilisateur par défaut pour une instance Amazon Linux ou RHEL Amazon EC2. Si votre instance a été créée à l'aide d'une image AMI personnalisée, le propriétaire de l'image AMI peut avoir spécifié un nom d'utilisateur par défaut différent.
Téléchargez le programme d'installation de l' CodeDeploy agent :
```
wget https://bucket-name.s3.region-identifier.amazonaws.com/latest/install
```
*bucket-name*est le nom du compartiment Amazon S3 qui contient les fichiers du kit de CodeDeploy ressources pour votre région, ainsi *region-identifier* que l'identifiant de votre région.
Par exemple :
`https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latest/install`
Pour obtenir la liste des noms de compartiments et des identificateurs de région, consultez[Noms des compartiments du kit de ressources par région](resource-kit.md#resource-kit-bucket-names).
Définissez les autorisations d'exécution sur le `install` fichier :
```
chmod +x ./install
```
Pour installer la dernière version de l' CodeDeploy agent :
+
```
sudo ./install auto
```
Pour installer une version spécifique de l' CodeDeploy agent :
+ Répertoriez les versions disponibles dans votre région :
```
aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.rpm$'
```
+ Installez l'une des versions suivantes :
```
sudo ./install auto -v releases/codedeploy-agent-version.noarch.rpm
```
**Note**
AWS prend en charge la dernière version mineure de l' CodeDeploy agent. Actuellement, la dernière version mineure est 1.7.x.
Pour vérifier que le service est en cours d'exécution, exécutez la commande suivante :
```
systemctl status codedeploy-agent
```
Si l' CodeDeploy agent est installé et en cours d'exécution, vous devriez voir un message tel que`The AWS CodeDeploy agent is running`.
Si vous voyez un message tel que `error: No AWS CodeDeploy agent running`, démarrez le service et exécutez les deux commandes suivantes, l'une après l'autre :
```
systemctl start codedeploy-agent
```
```
systemctl status codedeploy-agent
```
# Installation de l' CodeDeploy agent pour Ubuntu Server
**Note**
Nous vous recommandons d'installer l' CodeDeploy agent AWS Systems Manager pour pouvoir configurer les mises à jour planifiées de l'agent. Pour de plus amples informations, veuillez consulter [Installez l' CodeDeploy agent à l'aide de AWS Systems Manager](codedeploy-agent-operations-install-ssm.md).
**Pour installer l' CodeDeploy agent sur le serveur Ubuntu**
1. Connectez-vous à l'instance.
1. Entrez les commandes suivantes, l'une après l'autre :
```
sudo apt update
```
```
sudo apt install ruby-full
```
```
sudo apt install wget
```
1. Entrez la commande suivante :
```
cd /home/ubuntu
```
*/home/ubuntu*représente le nom d'utilisateur par défaut pour une instance de serveur Ubuntu. Si votre instance a été créée à l'aide d'une image AMI personnalisée, le propriétaire de l'image AMI peut avoir spécifié un nom d'utilisateur par défaut différent.
1. Entrez la commande suivante :
```
wget https://bucket-name.s3.region-identifier.amazonaws.com/latest/install
```
*bucket-name*est le nom du compartiment Amazon S3 qui contient les fichiers du kit de CodeDeploy ressources pour votre région, ainsi *region-identifier* que l'identifiant de votre région.
Par exemple :
`https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latest/install`
Pour obtenir la liste des noms de compartiments et des identificateurs de région, consultez[Noms des compartiments du kit de ressources par région](resource-kit.md#resource-kit-bucket-names).
1. Entrez la commande suivante :
```
chmod +x ./install
```
1. Effectuez l’une des actions suivantes :
+ Pour installer la dernière version de l' CodeDeploy agent sur n'importe quelle version prise en charge d'Ubuntu Server à l'*exception* de la version 20.04 :
```
sudo ./install auto
```
+ Pour installer la dernière version de l' CodeDeploy agent sur Ubuntu Server 20.04 :
**Note**
L'écriture de la sortie dans un fichier journal temporaire est une solution de contournement qui doit être utilisée lorsque nous corrigeons un bogue connu avec le `install` script sur Ubuntu Server 20.04.
```
sudo ./install auto > /tmp/logfile
```
+ Pour installer une version spécifique de l' CodeDeploy agent sur n'importe quelle version prise en charge d'Ubuntu Server à l'*exception* de la version 20.04 :
+ Répertoriez les versions disponibles dans votre région :
```
aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.deb$'
```
+ Installez l'une des versions suivantes :
```
sudo ./install auto -v releases/codedeploy-agent-###.deb
```
**Note**
AWS prend en charge la dernière version mineure de l' CodeDeploy agent. Actuellement, la dernière version mineure est 1.7.x.
+ Pour installer une version spécifique de l' CodeDeploy agent sur Ubuntu Server 20.04 :
+ Répertoriez les versions disponibles dans votre région :
```
aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.deb$'
```
+ Installez l'une des versions suivantes :
```
sudo ./install auto -v releases/codedeploy-agent-###.deb > /tmp/logfile
```
**Note**
L'écriture de la sortie dans un fichier journal temporaire est une solution de contournement qui doit être utilisée lorsque nous corrigeons un bogue connu avec le `install` script sur Ubuntu Server 20.04.
**Note**
AWS prend en charge la dernière version mineure de l' CodeDeploy agent. Actuellement, la dernière version mineure est 1.7.x.
**Pour vérifier que le service fonctionne**
1. Entrez la commande suivante :
```
systemctl status codedeploy-agent
```
Si l' CodeDeploy agent est installé et en cours d'exécution, vous devriez voir un message tel que`The AWS CodeDeploy agent is running`.
1. Si vous voyez un message tel que `error: No AWS CodeDeploy agent running`, démarrez le service et exécutez les deux commandes suivantes, l'une après l'autre :
```
systemctl start codedeploy-agent
```
```
systemctl status codedeploy-agent
```
# Installation de l' CodeDeploy agent pour Windows Server
Sur les instances Windows Server, vous pouvez utiliser l'une des méthodes suivantes pour télécharger et installer l' CodeDeploy agent :
+ Utilisation AWS Systems Manager (recommandée)
+ Exécutez une série de PowerShell commandes Windows.
+ Choisissez un lien de téléchargement direct.
+ Exécutez une commande de copie Amazon S3.
**Note**
Le dossier dans lequel l' CodeDeploy agent est installé est`C:\Program Data\Amazon\CodeDeploy`. Assurez-vous qu'il n'y a pas de jonctions de répertoires ou de liens symboliques sur ce chemin.
**Topics**
+ [Utiliser Systems Manager](#codedeploy-agent-operations-install-system-manager)
+ [Utiliser Windows PowerShell](#codedeploy-agent-operations-install-windows-powershell)
+ [Utilisation d'un lien direct](#codedeploy-agent-operations-install-windows-direct-link)
+ [Utiliser une commande de copie Amazon S3](#codedeploy-agent-operations-install-windows-s3-copy)
## Utiliser Systems Manager
Suivez les instructions [Installez l' CodeDeploy agent à l'aide de AWS Systems Manager](codedeploy-agent-operations-install-ssm.md) pour installer l' CodeDeployagent.
## Utiliser Windows PowerShell
Connectez-vous à l'instance et exécutez les commandes suivantes sous Windows PowerShell :
1. Exigez que tous les scripts et les fichiers de configuration téléchargés depuis Internet soient signées par un éditeur de confiance. Si vous êtes invité à modifier la stratégie d'exécution, tapez « **Y** ».
```
Set-ExecutionPolicy RemoteSigned
```
1. Chargez le AWS Tools for Windows PowerShell.
```
Import-Module AWSPowerShell
```
1. Créez un répertoire dans lequel le fichier d'installation de l' CodeDeploy agent est téléchargé.
```
New-Item -Path "c:\temp" -ItemType "directory" -Force
```
1. Configurez AWS les informations d'identification à l'aide `Set-AWSCredential` des `Initialize-AWSDefaultConfiguration` commandes et. Pour plus d'informations, consultez la section [Utilisation des AWS informations d'identification](https://docs.aws.amazon.com/powershell/latest/userguide/specifying-your-aws-credentials.html) dans les *AWS outils du Guide de PowerShell l'utilisateur*.
1. Téléchargez le fichier d'installation de l' CodeDeploy agent.
**Note**
AWS prend en charge la dernière version mineure de l' CodeDeploy agent. Actuellement, la dernière version mineure est 1.7.x.
Pour installer la dernière version de l' CodeDeployagent :
+
```
powershell.exe -Command Read-S3Object -BucketName bucket-name -Key latest/codedeploy-agent.msi -File c:\temp\codedeploy-agent.msi
```
Pour installer une version spécifique de l' CodeDeployagent :
+
```
powershell.exe -Command Read-S3Object -BucketName bucket-name -Key releases/codedeploy-agent-###.msi -File c:\temp\codedeploy-agent.msi
```
*bucket-name*est le nom du compartiment Amazon S3 qui contient les fichiers du kit de CodeDeploy ressources pour votre région. Par exemple, pour la région USA Est (Ohio), remplacez *bucket-name* par`aws-codedeploy-us-east-2`. Pour obtenir la liste des noms de compartiments, consultez[Noms des compartiments du kit de ressources par région](resource-kit.md#resource-kit-bucket-names).
1. Exécutez le fichier d'installation de l' CodeDeploy agent.
```
c:\temp\codedeploy-agent.msi /quiet /l c:\temp\host-agent-install-log.txt
```
Pour vérifier que le service est en cours d'exécution, exécutez la commande suivante :
```
powershell.exe -Command Get-Service -Name codedeployagent
```
Si l' CodeDeploy agent vient d'être installé et n'a pas été démarré, après avoir exécuté la **Get-Service** commande, sous **État**, vous devriez voir **Start...** :
```
Status Name DisplayName
------ ---- -----------
Start... codedeployagent CodeDeploy Host Agent Service
```
Si l' CodeDeploy agent est déjà en cours d'exécution, après avoir exécuté la **Get-Service** commande, sous **État**, vous devriez voir **Running** :
```
Status Name DisplayName
------ ---- -----------
Running codedeployagent CodeDeploy Host Agent Service
```
## Utilisation d'un lien direct
Si les paramètres de sécurité du navigateur de l'instance Windows Server fournissent les autorisations (par exemple, pour`https://s3.*.amazonaws.com`), vous pouvez utiliser un lien direct vers votre région pour télécharger l' CodeDeploy agent, puis exécuter le programme d'installation manuellement.
Le lien est le suivant :
```
https://s3.region.amazonaws.com/aws-codedeploy-region/latest/codedeploy-agent.msi
```
... où se *region* trouve la AWS région dans laquelle vous déployez votre application.
Par exemple :
```
https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latest/codedeploy-agent.msi
```
**Important**
Procurez-vous le `.msi` fichier auprès de la même région que votre CodeDeploy demande. Le choix d'une autre région peut entraîner `inconsistent region` des défaillances dans le `codedeploy-agent-log` fichier lorsque vous l'`.msi`exécutez.
## Utiliser une commande de copie Amazon S3
S'il AWS CLI est installé sur l'instance, vous pouvez utiliser la commande Amazon S3 [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) pour télécharger l' CodeDeploy agent, puis exécuter le programme d'installation manuellement. Pour plus d'informations, voir [Installer AWS Command Line Interface le sous Microsoft Windows](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html).
La commande Amazon S3 est la suivante :
```
aws s3 cp s3://aws-codedeploy-region/latest/codedeploy-agent.msi codedeploy-agent.msi --region region
```
... où se *region* trouve la AWS région dans laquelle vous déployez votre application.
Par exemple :
```
aws s3 cp s3://aws-codedeploy-af-south-1/latest/codedeploy-agent.msi codedeploy-agent.msi --region af-south-1
```
# Mettre à jour l' CodeDeploy agent
Vous pouvez configurer des mises à jour automatiques et planifiées de l' CodeDeploy agent sur tous les systèmes d'exploitation pris en charge à l'aide de AWS Systems Manager. Vous pouvez également forcer les mises à jour sur tous les systèmes d'exploitation pris en charge en exécutant une commande sur une instance.
**Topics**
+ [Mettre à jour l' CodeDeploy agent sur Amazon Linux ou RHEL](codedeploy-agent-operations-update-linux.md)
+ [Mettre à jour l' CodeDeploy agent sur le serveur Ubuntu](codedeploy-agent-operations-update-ubuntu.md)
+ [Mettre à jour l' CodeDeploy agent sur Windows Server](codedeploy-agent-operations-update-windows.md)
# Mettre à jour l' CodeDeploy agent sur Amazon Linux ou RHEL
Pour configurer les mises à jour automatiques et planifiées de l' CodeDeploy agent à l'aide de AWS Systems Manager, suivez les étapes [décrites dans Installer l' CodeDeploy agent avec AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html).
Si vous souhaitez forcer la mise à jour de l' CodeDeploy agent, connectez-vous à l'instance et exécutez la commande suivante :
```
sudo /opt/codedeploy-agent/bin/install auto
```
# Mettre à jour l' CodeDeploy agent sur le serveur Ubuntu
Pour configurer les mises à jour automatiques et planifiées de l' CodeDeploy agent à l'aide de AWS Systems Manager, suivez les étapes [décrites dans Installer l' CodeDeploy agent avec AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html).
Si vous souhaitez forcer la mise à jour de l' CodeDeploy agent, connectez-vous à l'instance et exécutez la commande suivante :
```
sudo /opt/codedeploy-agent/bin/install auto
```
# Mettre à jour l' CodeDeploy agent sur Windows Server
Vous pouvez activer les mises à jour automatiques de l' CodeDeploy agent avec AWS Systems Manager. Avec Systems Manager, vous pouvez configurer un calendrier de mise à jour pour vos instances Amazon EC2 ou sur site en créant une association avec Systems Manager State Manager. Vous pouvez également mettre à jour l' CodeDeploy agent manuellement en désinstallant la version actuelle et en installant une version plus récente.
**Topics**
+ [Configurez la mise à jour automatique des CodeDeploy agents avec AWS Systems Manager](#codedeploy-agent-operations-update-windows-ssm)
+ [Mettre à jour l' CodeDeploy agent manuellement](#codedeploy-agent-operations-update-windows-manual)
+ [(Obsolète) Mettez à jour l' CodeDeploy agent avec le Windows Server Updater](#codedeploy-agent-operations-update-windows-updater)
## Configurez la mise à jour automatique des CodeDeploy agents avec AWS Systems Manager
Pour configurer Systems Manager et activer les mises à jour automatiques de l' CodeDeploy agent, suivez les instructions de la section [Installer l' CodeDeploy agent à l'aide](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html) de AWS Systems Manager.
## Mettre à jour l' CodeDeploy agent manuellement
Pour mettre à jour l' CodeDeploy agent manuellement, vous pouvez installer la dernière version à partir de la CLI ou à l'aide de Systems Manager. Suivez les instructions de [Installer l'agent CodeDeploy.](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install.html) Il est recommandé de désinstaller les anciennes versions de l' CodeDeploy agent en suivant les instructions de la section [Désinstaller l' CodeDeployagent](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-uninstall.html).
## (Obsolète) Mettez à jour l' CodeDeploy agent avec le Windows Server Updater
**Note**
Le programme de mise à jour de l' CodeDeploy agent pour Windows Server est obsolète et ne sera mis à jour vers aucune version postérieure à la version 1.0.1.1597.
Pour activer les mises à jour automatiques de l' CodeDeploy agent, installez le programme de mise à jour de l' CodeDeploy agent pour Windows Server sur des instances nouvelles ou existantes. Le programme de mise à jour vérifie régulièrement l'existence de nouvelles versions. Lorsqu'une nouvelle version est détectée, le programme de mise à jour désinstalle la version actuelle de l'agent, si elle est installée, avant d'installer la version la plus récente.
Si un déploiement est déjà en cours lorsque le programme de mise à jour détecte une nouvelle version, le déploiement se poursuit jusqu'à la fin. Si un déploiement tente de démarrer pendant le processus de mise à jour, le déploiement échoue.
Si vous souhaitez forcer la mise à jour de l' CodeDeploy agent, suivez les instructions figurant dans[Installation de l' CodeDeploy agent pour Windows Server](codedeploy-agent-operations-install-windows.md).
Sur les instances Windows Server, vous pouvez télécharger et installer le programme de mise à jour de l' CodeDeploy agent en exécutant des PowerShell commandes Windows, en utilisant un lien de téléchargement direct ou en exécutant une commande de copie Amazon S3.
**Topics**
+ [Utiliser Windows PowerShell](#codedeploy-agent-operations-update-windows-powershell)
+ [Utilisation d'un lien direct](#codedeploy-agent-operations-update-windows-direct-link)
+ [Utiliser une commande de copie Amazon S3](#codedeploy-agent-operations-update-windows-s3-copy)
### Utiliser Windows PowerShell
Connectez-vous à l'instance et exécutez les commandes suivantes sous Windows PowerShell, une par une :
```
Set-ExecutionPolicy RemoteSigned
```
Si vous êtes invité à modifier la politique d'exécution, choisissez de faire en **Y** sorte que Windows PowerShell exige que tous les scripts et fichiers de configuration téléchargés depuis Internet soient signés par un éditeur approuvé.
```
Import-Module AWSPowerShell
```
```
New-Item -Path "c:\temp" -ItemType "directory" -Force
```
```
powershell.exe -Command Read-S3Object -BucketName bucket-name -Key latest/codedeploy-agent-updater.msi -File c:\temp\codedeploy-agent-updater.msi
```
```
c:\temp\codedeploy-agent-updater.msi /quiet /l c:\temp\host-agent-updater-log.txt
```
```
powershell.exe -Command Get-Service -Name codedeployagent
```
*bucket-name*est le nom du compartiment Amazon S3 qui contient les fichiers du kit de CodeDeploy ressources pour votre région. Par exemple, pour la région USA Est (Ohio), remplacez *bucket-name* par`aws-codedeploy-us-east-2`. Pour obtenir la liste des noms de compartiments, consultez[Noms des compartiments du kit de ressources par région](resource-kit.md#resource-kit-bucket-names).
Si vous devez résoudre une erreur du processus de mise à jour, tapez la commande suivante pour ouvrir le fichier journal du programme de mise à jour de l' CodeDeploy agent :
```
notepad C:\ProgramData\Amazon\CodeDeployUpdater\log\codedeploy-agent.updater.log
```
### Utilisation d'un lien direct
Si les paramètres de sécurité du navigateur de l'instance Windows Server fournissent les autorisations requises (par exemple, pour ` http://s3.*.amazonaws.com `), vous pouvez utiliser un lien direct pour télécharger le programme de mise à jour de l' CodeDeploy agent.
Le lien est le suivant :
```
https://s3.region.amazonaws.com/aws-codedeploy-region/latest/codedeploy-agent-updater.msi
```
... où se *region* trouve la AWS région dans laquelle vous mettez à jour votre application.
Par exemple :
```
https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latest/codedeploy-agent-updater.msi
```
### Utiliser une commande de copie Amazon S3
S'il AWS CLI est installé sur l'instance, vous pouvez utiliser la commande Amazon S3 [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) pour télécharger le programme de mise à jour de l' CodeDeploy agent, puis exécuter le programme d'installation manuellement. Pour plus d'informations, voir [Installer AWS Command Line Interface le sous Microsoft Windows](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html).
La commande Amazon S3 est la suivante :
```
aws s3 cp s3://aws-codedeploy-region/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi --region region
```
... où se *region* trouve la AWS région dans laquelle vous mettez à jour votre application.
Par exemple :
```
aws s3 cp s3://aws-codedeploy-af-south-1/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi --region af-south-1
```
# Désinstallez l' CodeDeploy agent
Vous pouvez supprimer l' CodeDeploy agent des instances lorsqu'il n'est plus nécessaire ou lorsque vous souhaitez effectuer une nouvelle installation.
## Désinstallez l' CodeDeploy agent d'Amazon Linux ou de RHEL
Pour désinstaller l' CodeDeploy agent, connectez-vous à l'instance et exécutez la commande suivante :
```
sudo yum erase codedeploy-agent
```
## Désinstallez l' CodeDeploy agent d'Ubuntu Server
Pour désinstaller l' CodeDeploy agent, connectez-vous à l'instance et exécutez la commande suivante :
```
sudo dpkg --purge codedeploy-agent
```
## Désinstallez l' CodeDeploy agent de Windows Server
Pour désinstaller l' CodeDeploy agent, connectez-vous à l'instance et exécutez les trois commandes suivantes, une par une :
```
wmic
```
```
product where name="CodeDeploy Host Agent" call uninstall /nointeractive
```
```
exit
```
Vous pouvez également vous connecter à l'instance et, dans le **Panneau de configuration**, ouvrir **Programmes et fonctionnalités**, choisir **CodeDeploy Host Agent**, puis choisir **Désinstaller**.
# Envoyer les journaux des CodeDeploy agents à CloudWatch
Vous pouvez envoyer les données métriques et de journal de l' CodeDeploy agent à CloudWatch l'aide de l'[ CloudWatch agent unifié](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/UseCloudWatchUnifiedAgent.html) ou, plus simplement, de l' CloudWatch agent.
Suivez les instructions ci-dessous pour installer l' CloudWatch agent et le configurer pour une utilisation avec CodeDeploy des agents.
## Conditions préalables
Avant de commencer, effectuez les tâches suivantes :
+ Installez l' CodeDeploy agent et assurez-vous qu'il est en cours d'exécution. Pour plus d’informations, consultez [Installation de l' CodeDeploy agent](codedeploy-agent-operations-install.md) et [Vérifiez que l' CodeDeploy agent est en cours d'exécution](codedeploy-agent-operations-verify.md).
+ Installez l' CloudWatch agent. Pour plus d'informations, consultez la section [Installation de l' CloudWatch agent](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance.html).
+ Ajoutez les autorisations suivantes au profil d'instance CodeDeploy IAM :
+ CloudWatchLogsFullAccess
+ CloudWatchAgentServerPolicy
Pour plus d'informations sur le profil d' CodeDeploy instance, consultez [Étape 4 : Création d'un profil d'instance IAM pour vos instances Amazon EC2](getting-started-create-iam-instance-profile.md) la section de[Commencer avec CodeDeploy](getting-started-codedeploy.md).
## Configuration de l' CloudWatch agent pour collecter les CodeDeploy journaux
Vous pouvez configurer l' CloudWatch agent en utilisant un assistant ou en créant ou en modifiant manuellement un fichier de configuration.
**Pour configurer l' CloudWatch agent à l'aide de l'assistant (Linux)**
1. Exécutez l'assistant, comme décrit dans [Exécuter l'assistant de configuration de l' CloudWatch agent](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard).
1. Dans l'assistant, lorsque vous y êtes invité, `Do you want to monitor any log files?` entrez**1**.
1. Spécifiez le fichier journal de l' CodeDeploy agent, comme suit :
1. Pour `Log file path` saisir le chemin du fichier CodeDeploy journal, par exemple :**/var/log/aws/codedeploy-agent/codedeploy-agent.log**.
1. Pour `Log group name` saisir un nom de groupe de journaux, par exemple :**codedeploy-agent-log**.
1. Pour `Log stream name` saisir un nom de flux de journal, par exemple :**\$1instance\$1id\$1-codedeploy-agent-log**.
1. Lorsque vous y êtes invité`Do you want to specify any additional log files?`, entrez**1**.
1. Spécifiez les journaux de déploiement de l' CodeDeploy agent, comme suit :
1. Pour `Log file path` saisir le chemin du fichier journal de CodeDeploy déploiement, par exemple :**/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log**.
1. Pour `Log group name` saisir un nom de groupe de journaux, par exemple :**codedeploy-agent-deployment-log**.
1. Pour `Log stream name` saisir un nom de flux de journal, par exemple :**\$1instance\$1id\$1-codedeploy-agent-deployment-log**.
1. Lorsque vous y êtes invité`Do you want to specify any additional log files?`, entrez**1**.
1. Spécifiez les journaux du programme de mise à jour de l' CodeDeploy agent, comme suit :
1. Pour `Log file path` saisir le chemin du fichier journal du CodeDeploy programme de mise à jour, par exemple :**/tmp/codedeploy-agent.update.log**.
1. Pour `Log group name` saisir un nom de groupe de journaux, par exemple :**codedeploy-agent-updater-log**.
1. Pour `Log stream name` saisir un nom de flux de journal, par exemple :**\$1instance\$1id\$1-codedeploy-agent-updater-log**.
**Pour configurer l' CloudWatch agent à l'aide de l'assistant (Windows)**
1. Exécutez l'assistant, comme décrit dans [Exécuter l'assistant de configuration de l' CloudWatch agent](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard).
1. Dans l'assistant, lorsque vous y êtes invité, `Do you want to monitor any customized log files?` entrez**1**.
1. Spécifiez le fichier CodeDeploy journal, comme suit :
1. Pour `Log file path` saisir le chemin ou le fichier journal de l' CodeDeploy agent, par exemple :**C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1log\$1codedeploy-agent-log.txt**.
1. Pour `Log group name` saisir un nom de groupe de journaux, par exemple :**codedeploy-agent-log**.
1. Pour `Log stream name` saisir un nom de flux de journal, par exemple :**\$1instance\$1id\$1-codedeploy-agent-log**.
1. Lorsque vous y êtes invité`Do you want to specify any additional log files?`, entrez**1**.
1. Spécifiez les journaux de déploiement de l' CodeDeploy agent, comme suit :
1. Pour `Log file path` saisir le chemin du fichier journal de CodeDeploy déploiement, par exemple :**C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1deployment-logs\$1codedeploy-agent-deployments.log**.
1. Pour `Log group name` saisir un nom de groupe de journaux, par exemple :**codedeploy-agent-deployment-log**.
1. Pour `Log stream name` saisir un nom de flux de journal, par exemple :**\$1instance\$1id\$1-codedeploy-agent-deployment-log**.
**Pour configurer l' CloudWatch agent en créant ou en modifiant manuellement un fichier de configuration (Linux)**
1. Créez ou modifiez le fichier de configuration de l' CloudWatch agent comme décrit dans [Création ou modification manuelle du fichier de configuration de l' CloudWatch agent](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html).
1. Assurez-vous que le fichier est appelé `/opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.json` et qu'il contient le code suivant :
```
...
"logs": {
"logs_collected": {
"files": {
"collect_list": [
{
"file_path": "/var/log/aws/codedeploy-agent/codedeploy-agent.log",
"log_group_name": "codedeploy-agent-log",
"log_stream_name": "{instance_id}-agent-log"
},
{
"file_path": "/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log",
"log_group_name": "codedeploy-agent-deployment-log",
"log_stream_name": "{instance_id}-codedeploy-agent-deployment-log"
},
{
"file_path": "/tmp/codedeploy-agent.update.log",
"log_group_name": "codedeploy-agent-updater-log",
"log_stream_name": "{instance_id}-codedeploy-agent-updater-log"
}
]
}
}
}
...
```
**Pour configurer l' CloudWatch agent en créant ou en modifiant manuellement un fichier de configuration (Windows)**
1. Créez ou modifiez le fichier de configuration de l' CloudWatch agent comme décrit dans [Création ou modification manuelle du fichier de configuration de l' CloudWatch agent](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html).
1. Assurez-vous que le fichier est appelé `C:\ProgramData\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent.json` et qu'il contient le code suivant :
```
...
"logs": {
"logs_collected": {
"files": {
"collect_list": [
{
"file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\log\\codedeploy-agent-log.txt",
"log_group_name": "codedeploy-agent-log",
"log_stream_name": "{instance_id}-codedeploy-agent-log"
},
{
"file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\deployment-logs\\codedeploy-agent-deployments.log",
"log_group_name": "codedeploy-agent-deployment-log",
"log_stream_name": "{instance_id}-codedeploy-agent-deployment-log"
}
]
},
...
}
},
...
```
## Redémarrer l' CloudWatch agent
Après avoir apporté vos modifications, redémarrez l' CloudWatch agent comme décrit dans [Démarrer l' CloudWatch agent](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance-fleet.html#start-CloudWatch-Agent-EC2-fleet).