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 à 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
```