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.

    So installieren Sie die neueste Version des CodeDeploy Agenten:

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

    Um eine bestimmte Version des CodeDeploy Agenten zu installieren:

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

Der Link lautet:

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

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

Beispiel:

https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latest/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.

Der Amazon S3-Befehl lautet:

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.

Beispiel:

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