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:\ProgramData\Amazon\CodeDeploy. Ne placez pas de jonctions de répertoires ni de liens symboliques sur ce chemin. Pour les versions 2.0.x et ultérieures, l'agent applique cette exigence et refuse de démarrer si le binaire du service n'est pas inférieur. C:\ProgramData\Amazon\CodeDeploy\

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 dans 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 Initialize-AWSDefaultConfiguration des commandes Set-AWSCredential 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

   Pour la dernière version publiée, voirHistorique des versions de l' CodeDeploy agent.

   Pour installer la dernière version de l' CodeDeploy agent. Le latestv2/ préfixe sert au programme d'installation de la version 2.x (2.0.x et versions ultérieures) et le latest/ préfixe sert au programme d'installation de la version 1.8.x.

   • Pour les versions 2.0.x et ultérieures :

     powershell.exe -Command Read-S3Object -BucketName bucket-name -Key latestv2/codedeploy-agent.msi -File c:\temp\codedeploy-agent.msi

     Pour les versions 1.8.x et antérieures :

     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-nameest 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 de l'Est des États-Unis (Ohio), remplacez bucket-name paraws-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 nécessaires (par exemple, à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 latestv2/ préfixe sert au programme d'installation de la version 2.x (2.0.x et versions ultérieures) et le latest/ préfixe sert au programme d'installation de la version 1.8.x.

Pour la version 2.0.x et les versions ultérieures, le lien est le suivant :

https://s3.region.amazonaws.com/aws-codedeploy-region/latestv2/codedeploy-agent.msi

Pour les versions 1.8.x et antérieures :

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, pour la version 2.0.x et les versions ultérieures :

https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latestv2/codedeploy-agent.msi

Important

Procurez-vous le .msi dossier 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 échecs 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 le AWS Command Line Interface sur Microsoft Windows.

Le latestv2/ préfixe sert au programme d'installation de la version 2.x (2.0.x et versions ultérieures) et le latest/ préfixe sert au programme d'installation de la version 1.8.x.

Pour les versions 2.0.x et ultérieures, la commande Amazon S3 est la suivante :

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

Pour les versions 1.8.x et antérieures :

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, pour la version 2.0.x et les versions ultérieures :

aws s3 cp s3://aws-codedeploy-af-south-1/latestv2/codedeploy-agent.msi codedeploy-agent.msi --region af-south-1