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