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é estC:\Program Data\Amazon\CodeDeploy. Assurez-vous qu'il n'y a pas de jonctions de répertoires ou de liens symboliques sur ce chemin.

Utiliser Systems Manager

Suivez les instructions Installez l' CodeDeploy agent à l'aide de AWS Systems Manager 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

2. Chargez le AWS Tools for Windows PowerShell.

   Import-Module AWSPowerShell

3. 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

4. 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 dans les AWS outils du Guide de PowerShell l'utilisateur.

5. 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, consultezNoms des compartiments du kit de ressources par région.

6. 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, pourhttps://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ù la région est 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'.msiexé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 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.

La commande Amazon S3 est la suivante :

aws s3 cp s3://aws-codedeploy-region/latest/codedeploy-agent.msi codedeploy-agent.msi --region region

... où la région est 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