View a markdown version of this page

Installieren Sie den CodeDeploy Agenten für Windows Server - AWS CodeDeploy
Verwenden von Systems ManagerVerwenden Sie Windows PowerShellVerwenden eines Direkt-LinksVerwenden Sie einen Amazon S3-Befehl zum Kopieren

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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 Sie 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-Kopierbefehl aus.

Anmerkung

Der Ordner, in dem der CodeDeploy Agent installiert ist, istC:\ProgramData\Amazon\CodeDeploy. Platzieren Sie keine Verzeichnisverbindungen oder symbolischen Links auf diesem Pfad. Für Version 2.0.x und höher setzt der Agent diese Anforderung durch und weigert sich, zu starten, wenn die Dienst-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 die 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 mithilfe der Initialize-AWSDefaultConfiguration Befehle Set-AWSCredential und. Weitere Informationen finden Sie unter Verwenden von AWS Anmeldeinformationen in den AWS Tools für das PowerShell Benutzerhandbuch.

  5. Laden Sie die CodeDeploy Agenteninstallationsdatei 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-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 Agenteninstallationsdatei 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 dem Ausführen 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 dem Ausführen des Get-Service Befehls unter Status Folgendes sehenRunning:


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

Wenn die Sicherheitseinstellungen des Browsers auf der Windows Server-Instanz die entsprechenden Berechtigungen enthalten (z. B. fürhttps://s3.*.amazonaws.com), können Sie einen direkten Link für Ihre Region verwenden, um den CodeDeploy Agenten herunterzuladen und das Installationsprogramm anschließend 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. Die Auswahl einer anderen Region kann zu inconsistent region Fehlern in der codedeploy-agent-log Datei führen, wenn Sie die .msi Datei ausführen.

Verwenden Sie einen Amazon S3-Befehl zum Kopieren

Wenn der auf der Instance installiert AWS CLI ist, können Sie den Amazon S3-Befehl cp verwenden, um den CodeDeploy Agenten herunterzuladen und das Installationsprogramm dann manuell auszufü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-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