Installieren Sie den CodeDeploy Agenten für Windows Server

Auf Windows Server-Instanzen können Sie eine der folgenden Methoden verwenden, um den CodeDeploy Agenten herunterzuladen und zu installieren:

• Verwenden AWS Systems Manager (empfohlen)

• Führen Sie eine Reihe von PowerShell Windows-Befehlen aus.

• Wählen eines direkten Download-Links

• Führen Sie einen Amazon S3 S3-Kopierbefehl aus.

Anmerkung

Der Ordner, in dem der CodeDeploy Agent installiert ist, istC:\ProgramData\Amazon\CodeDeploy. Platzieren Sie in diesem Pfad keine Verzeichnisverbindungen oder symbolischen Links. Für Version 2.0.x und höher setzt der Agent diese Anforderung durch und verweigert den Start, wenn die Service-Binärdatei nicht unter ist. C:\ProgramData\Amazon\CodeDeploy\

Verwenden von Systems Manager

Folgen Sie den Anweisungen unterInstallieren Sie den CodeDeploy Agenten mit AWS Systems Manager, um den Agenten zu installieren. CodeDeploy

Verwenden Sie Windows PowerShell

Melden Sie sich bei der Instanz an und führen Sie die folgenden Befehle in Windows aus PowerShell:

1. Fordern Sie an, dass nur Skripte und Konfigurationsdateien von vertrauenswürdigen Anbietern aus dem Internet heruntergeladen werden. Wenn Sie dazu aufgefordert werden, die Ausführungsrichtlinie zu ändern, geben Sie "Y" ein.

    Set-ExecutionPolicy RemoteSigned

2. Laden Sie das AWS Tools for Windows PowerShell.

   Import-Module AWSPowerShell

3. Erstellen Sie ein Verzeichnis, in das die CodeDeploy Agenteninstallationsdatei heruntergeladen wird.

   New-Item -Path "c:\temp" -ItemType "directory" -Force

4. Konfigurieren Sie die AWS Anmeldeinformationen mit den Initialize-AWSDefaultConfiguration Befehlen Set-AWSCredential und. Weitere Informationen finden Sie unter Verwenden von AWS Anmeldeinformationen im PowerShell Benutzerhandbuch zu AWS Tools.

5. Laden Sie die CodeDeploy Agenten-Installationsdatei herunter.

   Anmerkung

   Die neueste veröffentlichte Version finden Sie unterVersionsverlauf des Agenten CodeDeploy.

   Um die neueste Version des CodeDeploy Agenten zu installieren. Das latestv2/ Präfix dient dem Installationsprogramm der Version 2.x (2.0.x und höher), und das latest/ Präfix dient dem Installationsprogramm der Version 1.8.x.

   • Für Version 2.0.x und höher:

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

     Für Version 1.8.x und früher:

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

   Um eine bestimmte Version des Agenten zu installieren: CodeDeploy

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

   bucket-nameist der Name des Amazon S3 S3-Buckets, der die CodeDeploy Resource Kit-Dateien für Ihre Region enthält. Ersetzen Sie beispielsweise für die Region USA Ost (Ohio) bucket-name durchaws-codedeploy-us-east-2. Eine Liste der Bucket-Namen finden Sie unterBucket-Namen für das Resource Kit nach Regionen.

6. Führen Sie die CodeDeploy Agenten-Installationsdatei aus.

   c:\temp\codedeploy-agent.msi /quiet /l c:\temp\host-agent-install-log.txt

Führen Sie den folgenden Befehl aus, um zu prüfen, ob der Dienst ausgeführt wird:

powershell.exe -Command Get-Service -Name codedeployagent

Wenn der CodeDeploy Agent gerade installiert und noch nicht gestartet wurde, sollten Sie nach der Ausführung des Get-Service Befehls unter Status Folgendes sehenStart...:

Status     Name                DisplayName
------     ----                -----------
Start...   codedeployagent    CodeDeploy Host Agent Service

Wenn der CodeDeploy Agent bereits läuft, sollten Sie nach der Ausführung des Get-Service Befehls unter Status Folgendes sehenRunning:

Status     Name                DisplayName
------     ----                -----------
Running    codedeployagent    CodeDeploy Host Agent Service

Verwenden eines Direkt-Links

Wenn die Sicherheitseinstellungen des Browsers auf der Windows Server-Instanz die erforderlichen Berechtigungen vorsehen (z. B. fürhttps://s3.*.amazonaws.com), können Sie einen direkten Link für Ihre Region verwenden, um den CodeDeploy Agenten herunterzuladen und dann das Installationsprogramm manuell auszuführen.

Das latestv2/ Präfix dient dem Installationsprogramm der Version 2.x (2.0.x und höher), und das latest/ Präfix dient dem Installationsprogramm der Version 1.8.x.

Für Version 2.0.x und höher lautet der Link:

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

Für Version 1.8.x und früher:

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

... wo region ist die AWS Region, in der Sie Ihre Anwendung bereitstellen.

Zum Beispiel für Version 2.0.x und höher:

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

Wichtig

Besorgen Sie sich die .msi Datei aus derselben Region wie Ihre CodeDeploy Anwendung. Wenn Sie eine andere Region wählen, kann es zu inconsistent region Fehlern in der codedeploy-agent-log Datei kommen, wenn Sie die .msi Datei ausführen.

Verwenden Sie einen Amazon S3 S3-Kopierbefehl

Wenn der auf der Instance installiert AWS CLI ist, können Sie den CodeDeploy Agenten mit dem Amazon S3 S3-Befehl cp herunterladen und dann das Installationsprogramm manuell ausführen. Weitere Informationen finden Sie unter Installieren von AWS Command Line Interface unter Microsoft Windows.

Das latestv2/ Präfix dient dem Installationsprogramm der Version 2.x (2.0.x und höher), und das latest/ Präfix dient dem Installationsprogramm der Version 1.8.x.

Für Version 2.0.x und höher lautet der Amazon S3 S3-Befehl:

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

Für Version 1.8.x und früher:

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

... wo region ist die AWS Region, in der Sie Ihre Anwendung bereitstellen.

Zum Beispiel für Version 2.0.x und höher:

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