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. # Mit dem CodeDeploy Agenten arbeiten Der AWS CodeDeploy Agent ist ein Softwarepaket, das, wenn es auf einer Instanz installiert und konfiguriert ist, die Verwendung dieser Instanz in CodeDeploy Bereitstellungen ermöglicht. AWS unterstützt die neueste Nebenversion des CodeDeploy Agenten. Derzeit ist die neueste Nebenversion 1.8.x. **Anmerkung** Der CodeDeploy Agent ist nur erforderlich, wenn Sie ihn auf einer EC2/lokalen Rechenplattform bereitstellen. Der Agent ist für Bereitstellungen, die die Amazon ECS- oder AWS Lambda-Rechenplattform verwenden, nicht erforderlich. Eine Konfigurationsdatei wird auf der Instance platziert, wenn der Agent installiert wird. Diese Datei wird verwendet, um festzulegen, wie der Agent arbeitet. Diese Konfigurationsdatei spezifiziert Verzeichnispfade und andere Einstellungen, die bei AWS CodeDeploy der Interaktion mit der Instance verwendet werden sollen. Sie können einige der Konfigurationsoptionen in der Datei ändern. Hinweise zur Arbeit mit der CodeDeploy Agent-Konfigurationsdatei finden Sie unter[CodeDeploy Referenz zur Agentenkonfiguration](reference-agent-configuration.md). Weitere Informationen zur Arbeit mit dem CodeDeploy Agenten, z. B. zu Schritten zur Installation, Aktualisierung und Überprüfung von Versionen, finden Sie unter[Verwaltung des CodeDeploy Agentenbetriebs](codedeploy-agent-operations.md). **Topics** + [ ## Betriebssysteme, die vom Agenten unterstützt werden CodeDeploy ](#codedeploy-agent-supported-operating-systems) + [ ## Kommunikationsprotokoll und Port für den CodeDeploy Agenten ](#codedeploy-agent-outbound-port) + [ ## Versionsverlauf des Agenten CodeDeploy ](#codedeploy-agent-version-history) + [ ## Den CodeDeploy Prozess verwalten ](#codedeploy-agent-processes) + [ ## Revision der Anwendung und Bereinigung der Protokolldateien ](#codedeploy-agent-revisions-logs-cleanup) + [ ## Vom Agenten installierte Dateien CodeDeploy ](#codedeploy-agent-install-files) + [ # Verwaltung des CodeDeploy Agentenbetriebs ](codedeploy-agent-operations.md) ## Betriebssysteme, die vom Agenten unterstützt werden CodeDeploy ### Unterstützte Amazon EC2 AMI-Betriebssysteme Der CodeDeploy Agent wurde auf den folgenden Amazon EC2 AMI-Betriebssystemen getestet: + Amazon Linux 2023 (ARM, x86) + Amazon Linux 2 (ARM, x86) + Microsoft Windows Server 2022, 2019 + RedHat Enterprise Linux (RHEL) 9.x, 8.x, 7.x + Ubuntu Server 22.04 LTS, 20.04 LTS, 18.04 LTS, 16.04 LTS Der CodeDeploy Agent steht Ihnen als Open Source zur Verfügung, sodass Sie ihn an Ihre Bedürfnisse anpassen können. Es kann mit anderen Amazon EC2 AMI-Betriebssystemen verwendet werden. Weitere Informationen finden Sie im [CodeDeploy Agenten-Repository](https://github.com/aws/aws-codedeploy-agent) unter GitHub. ### Unterstützte lokale Betriebssysteme Der CodeDeploy Agent wurde auf den folgenden lokalen Betriebssystemen getestet: + Microsoft Windows Server 2022, 2019 + RedHat Enterprise Linux (RHEL) 9.x, 8.x, 7.x + Ubuntu Server 22.04 LTS, 20.04 LTS Der CodeDeploy Agent steht Ihnen als Open Source zur Verfügung, sodass Sie ihn an Ihre Bedürfnisse anpassen können. Er kann mit anderen Betriebssystemen lokaler Instances verwendet werden. Weitere Informationen finden Sie im [CodeDeploy Agenten-Repository](https://github.com/aws/aws-codedeploy-agent) unter GitHub. ## Kommunikationsprotokoll und Port für den CodeDeploy Agenten Der CodeDeploy Agent kommuniziert ausgehend über HTTPS über Port 443. Wenn der CodeDeploy Agent auf einer EC2-Instance ausgeführt wird, verwendet er den [EC2-Metadaten-Endpunkt](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html), um instanzbezogene Informationen abzurufen. Weitere Informationen zum [Einschränken und Gewähren von Service-Zugriff auf Instance-Metadaten](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html#instance-metadata-limiting-access) finden Sie hier. ## Versionsverlauf des Agenten CodeDeploy Auf Ihren Instances muss eine unterstützte Version des CodeDeploy Agenten ausgeführt werden. Die derzeit unterstützte Mindestversion ist 1.8.x. **Anmerkung** Wir empfehlen, die neueste Version des Agenten zu verwenden. CodeDeploy Wenn Sie Probleme haben, aktualisieren Sie auf die neueste Version, bevor Sie sich an den AWS Support wenden. Informationen zum Upgrade finden Sie unter[Aktualisieren Sie den Agenten CodeDeploy](codedeploy-agent-operations-update.md). In der folgenden Tabelle sind alle Versionen des CodeDeploy Agenten sowie die Funktionen und Verbesserungen aufgeführt, die in jeder Version enthalten sind. | Version | Datum der Veröffentlichung | Details | | --- | --- | --- | | 1.8.1 | 3. Februar 2026 | **Behoben**: S3-Endpunkt-Bugfix. **Hinzugefügt**: Sectigo CA-Zertifikat zur Windows-CA-Liste. | | 1.8.0 | 31. Juli 2025 | **Geändert**: Das mitgelieferte Ruby wurde im CodeDeploy Agenten für Windows auf 3.2 aktualisiert. | | 1.7.1 | 14. November 2024 | **Geändert**: Die Abhängigkeiten für Sicherheitspatches wurden aktualisiert. | | 1.7.0 | 6. März 2024 | **Hinzugefügt**: Eine `:disable_imds_v1:` Konfigurationseinstellung zur CodeDeploy Agenten-Konfigurationsdatei. Verwenden Sie diese Einstellung, um den Fallback zu deaktivieren, IMDSv1 wenn IMDSv2 Fehler auftreten. Die Standardeinstellung ist `false` (aktiviert den Fallback). Weitere Informationen finden Sie in der Referenz zur [CodeDeploy Agentenkonfiguration](https://docs.aws.amazon.com/codedeploy/latest/userguide/reference-agent-configuration.html). **Hinzugefügt**: Support für das Betriebssystem Red Hat Enterprise Linux 9 (RHEL 9). **Hinzugefügt**: Support für die Ruby-Versionen 3.1 und 3.2 auf Ubuntu Server. **Behoben**: Der CodeDeploy Agent generiert jetzt einen benutzerfreundlichen Fehler, wenn die CodeDeploy Agenten-Konfigurationsdatei nicht geladen werden kann. **Geändert**: Ruby wurde im CodeDeploy Agenten für Windows auf 2.7.8-1 aktualisiert. | | 1.6.0 | 30. März 2023 | **Hinzugefügt**: Support für Ruby 3.1, 3.2. **Hinzugefügt**: Support für Amazon Linux 2023. **Hinzugefügt**: Support für Windows Server 2022. **Geändert**: Die Standardeinstellung von `verbose` ist jetzt `false` für Windows Server-Instanzen. Um weiterhin Debugmeldungen in Protokolldateien unter Windows drucken zu können, müssen Sie `verbose` auf `true` einstellen. **Entfernt**: Support für Windows Server 2016 und Windows Server 2012 R2. **Entfernt**: Support für Amazon Linux 2018.03.x. | | 1.5.0 | 03. März 2023 | **Hinzugefügt**: Support für Ruby 3. **Hinzugefügt**: Support für Ubuntu 22.04. **Behoben**: Ein Problem, bei dem ein Neustart des CodeDeploy Agenten kurz nach dem Start dazu führte, dass der Agent hängen blieb. **Geändert**: Der CodeDeploy Agent schlägt jetzt eine Host-Bereitstellung beim Start des Agenten fehl, wenn der Agent-Dienst während der Ausführung eines Hook-Skripts unerwartet neu gestartet wird. Mit diesem Fix können Sie vermeiden, das 70-minütige Timeout abzuwarten, bevor Sie erneut versuchen, eine Bereitstellung durchzuführen. **Hinweis zu veralteter** Version: CodeDeploy Agent 1.5.0 ist die letzte Version, die Windows Server 2016 und Windows Server 2012 R2 unterstützt. **Entfernt:** Support für den CodeDeploy Agenten auf Ubuntu 14.04 LTS, Windows Server 2008 R2 und Windows Server 2008 R2 32-Bit. | | 1.4.1 | 6. Dezember 2022 | **Behoben**: Sicherheitslücke im Zusammenhang mit der Protokollierung. **Verbesserung**: Die Protokollierung beim Abfragen des Host-Befehls wurde verbessert. | | 1.4.0 | 31. August 2022 | **Hinzugefügt**: Support für Red Hat Enterprise Linux 8. **Hinzugefügt**: Support für lange Dateipfade auf dem CodeDeploy Agenten für Windows. Um lange Dateipfade zu aktivieren, müssen Sie den entsprechenden Windows-Registrierungsschlüssel festlegen und dann Ihren Agenten neu starten. Weitere Informationen finden Sie unter [Lange Dateipfade führen zu der Fehlermeldung „Keine solche Datei oder kein solches Verzeichnis“](troubleshooting-deployments.md#troubleshooting-long-file-paths). **Behoben**: Ein Problem beim Entpacken, wenn die Festplatte voll war. Der CodeDeploy Agent erkennt jetzt den [Exit-Code 50](https://linux.die.net/man/1/unzip) des Entpackvorgangs, der auf eine volle Festplatte hinweist, entfernt teilweise entpackte Dateien und löst eine Ausnahme aus, um einen Fehler auf dem CodeDeploy Server zu melden. Die Fehlermeldung ist als Fehlermeldung im Zusammenhang mit einem Lebenszyklusereignis sichtbar, und die Bereitstellung auf Host-Ebene wird beendet, ohne dass es zu einer Unterbrechung kommt oder ein Timeout auftritt. **Behoben**: Ein Problem, das zum Ausfall des Agenten führen würde. **Behoben**: Ein Problem, bei dem Hooks während eines Edge-Case-Rennens ein Timeout auftraten. Hooks ohne Skripte werden jetzt fortgesetzt und verursachen keine Ausfälle oder Timeouts mehr. **Geändert**: Das `update` Skript aus dem CodeDeploy `bin` Agentenverzeichnis wurde entfernt, da es nicht mehr verwendet wird. **Geändert**: Der CodeDeploy Agent für Windows Server bündelt jetzt Ruby 2.7. **Geändert**: Neue Umgebungsvariablen wurden hinzugefügt, die je nach Quelle des Bereitstellungspakets (Amazon S3 oder GitHub) von Hook-Skripten verwendet werden können. Weitere Informationen finden Sie unter [Verfügbarkeit von Umgebungsvariablen für Hooks](reference-appspec-file-structure-hooks.md#reference-appspec-file-structure-environment-variable-availability). **Veraltungshinweis**: CodeDeploy Agent 1.4.0 ist die letzte Version, die Installationsprogramme für 32-Bit-Windows Server enthalten wird. **Hinweis auf veraltete Versionen**: CodeDeploy Agent 1.4.0 ist die letzte Version, die Windows Server 2008 R2 unterstützen wird. **Entfernt**: Support für den CodeDeploy Agenten auf dem folgenden Amazon EC2 AMIs: Amazon Linux 2014.09, 2016.03, 2016.09 und 2017.03. | | 1.3.2 | 6. Mai 2021 | CodeDeploy [Agent 1.3.2 adressiert CVE-2018-1000201, was Windows-Hosts betrifft, auf denen der Agent ausgeführt wird.](https://nvd.nist.gov/vuln/detail/CVE-2018-1000201) Das CVE zitiert ruby-ffi, was eine Abhängigkeit des Agenten ist. CodeDeploy Wenn Ihr Agent mit Amazon EC2 Systems Manager (SSM) installiert wurde und so eingestellt ist, dass er automatisch aktualisiert wird, ist keine Aktion erforderlich. Andernfalls ist eine Aktion erforderlich, um den Agenten manuell zu aktualisieren. Um den Agenten zu aktualisieren, folgen Sie den Anweisungen unter [Den CodeDeploy Agenten auf Windows Server aktualisieren](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-update-windows.html). **Behoben**: Ein Problem bei der Installation des CodeDeploy Agenten auf Ubuntu 20.04 und höher. **Behoben**: Ein zeitweiliges Problem, das beim Extrahieren komprimierter Dateien auftrat, weil relative Pfade nicht korrekt behandelt wurden. **Hinzugefügt**: Support für [AWS PrivateLink und VPC-Endpunkte](https://docs.aws.amazon.com//vpc/latest/userguide/endpoint-services-overview.html) für Windows-Instances. **Hinzugefügt**: AppSpec Dateiverbesserungen, wie unten beschrieben. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/codedeploy/latest/userguide/codedeploy-agent.html) **Aktualisiert**: verwendet CodeDeploy jetzt das AWS SDK for Ruby 3.0. | | 1.3.1 | 22. Dezember 2020 | **Behoben**: 1.3.0-Problem, das den Start von lokalen Instanzen verhinderte. | | 1.3.0 | 10. November 2020 | Diese Version ist veraltet. **Behoben**: Ein abgelaufenes Zertifikat, das nicht mehr verwendet wurde, wurde entfernt. **Problem behoben**: Die Eingabeaufforderung wurde aus dem von verwendeten Agenten-Deinstallationsskript entfernt AWS Systems Manager, wodurch es einfacher wurde, einen Host oder eine Flotte auf eine frühere Version des Agenten herunterzustufen. | | 1.2.1 | 23. September 2020 | **Geändert**: Die AWS SDK für Ruby Abhängigkeit wurde von Version 2 auf Version 3 aktualisiert. **Hinzugefügt**: Support für IMDSv2. Beinhaltet einen stillen Fallback für den IMDSv1 Fall, dass IMDSv2 HTTP-Anfragen fehlschlagen. **Geändert**: Die Abhängigkeiten von Rake und Rubyzip für Sicherheitspatches wurden aktualisiert. **Behoben**: Stellt sicher, dass eine leere PID-Datei den Status zurückgibt `No CodeDeploy Agent Running` und die PID-Datei beim Start des Agenten bereinigt. | | 1.1.2 | 4. August 2020 | **Hinzugefügt**: Support für Ubuntu Server 19.10 und 20.04. **Hinweis**: Version 19.10 hat ihr end-of-life Datum erreicht und wird von Ubuntu oder nicht mehr unterstützt. CodeDeploy **Hinzugefügt**: Verbesserungen der Speichereffizienz für Linux und Ubuntu, um reservierten Speicher zeitnaher freizugeben. **Hinzugefügt**: Kompatibilität mit Windows Server „Silent-Cleanup“, was dazu führte, dass der Agent in einigen Fällen nicht reagierte. **Hinzugefügt**: Ignoriere nicht leere Verzeichnisse während der Bereinigung, um Fehler bei der Bereitstellung zu vermeiden. **Hinzugefügt**: Support für AWS Local Zone in Los Angeles (LA). **Hinzugefügt**: Extrahieren Sie AZ aus Instanz-Metadaten, um die Kompatibilität für AWS Local Zones zu gewährleisten. **Hinzugefügt**: Benutzer können ihr Archiv jetzt in Unterverzeichnissen bereitstellen und müssen es nicht mehr im Stammverzeichnis speichern. **Hinzugefügt**: Es wurde ein Problem mit Rubyzip festgestellt, das zu Speicherlecks führen könnte. Der Befehl zum Entpacken wurde aktualisiert, sodass zunächst versucht wird, ein vom System installiertes Unzip-Hilfsprogramm zu verwenden, bevor Rubyzip verwendet wird. **Hinzugefügt**: `:enable_auth_policy:` als Agent-Konfigurationseinstellung. **Geändert**: Unzip-Warnungen werden jetzt ignoriert, sodass die Bereitstellungen fortgesetzt werden. | | 1.1.0 | 30. Juni 2020 | **Geändert**: Die Versionierung des CodeDeploy Agenten folgt jetzt der Ruby-Standard-Versionskonvention. **Hinzugefügt**: Neuer Parameter für den Befehl „install and update“, um die Installation einer bestimmten Agentenversion über die Befehlszeile zu ermöglichen. **Entfernt**: Der Auto Updater für den CodeDeploy Agenten für Linux und Ubuntu wurde entfernt. Informationen zur Konfiguration automatischer Updates des CodeDeploy Agenten finden [Sie unter Installieren des CodeDeploy Agenten mit AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html). | | 1.0.1.1597 | 15. November 2018 | **Erweiterung**: CodeDeploy unterstützt Ubuntu 18.04. **Erweiterung**: CodeDeploy unterstützt Ruby 2.5. **Verbesserung**: CodeDeploy unterstützt FIPS-Endpunkte. Weitere Informationen zu FIPS-Endpunkten finden Sie unter [FIPS 140-2-Übersicht](https://aws.amazon.com/compliance/fips/). Informationen zu Endpunkten, die mit verwendet werden können CodeBuild, finden Sie unter [CodeDeployRegionen](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) und Endpunkte. | | 1.0.1.1518 | 12. Juni 2018 | **Verbesserung**: Es wurde ein Problem behoben, das zu einem Fehler führte, wenn der CodeDeploy Agent geschlossen wurde, während er Umfrageanfragen annimmt. **Verbesserung**: Es wurde eine Funktion zur Nachverfolgung von Bereitstellungen hinzugefügt, die verhindert, dass der CodeDeploy Agent geschlossen wird, wenn eine Bereitstellung ausgeführt wird. **Verbesserung**: Verbesserte Leistung beim Löschen von Dateien. | | 1.0.1.1458 | 6. März 2018 | **Hinweis**: Diese Version wird nicht mehr unterstützt. Wenn Sie diese Version verwenden, schlagen Ihre Bereitstellungen fehl. **Erweiterung**: Verbesserte Zertifikatvalidierungen zur Unterstützung von mehr vertrauenswürdigen Ausstellern. **Verbesserung**: Es wurde ein Problem behoben, das dazu führte, dass die lokale CLI während einer Bereitstellung, die ein BeforeInstall Lebenszyklusereignis beinhaltete, fehlschlug. **Verbesserung**: Es wurde ein Problem behoben, das dazu führen konnte, dass eine aktive Bereitstellung fehlschlug, wenn der CodeDeploy Agent aktualisiert wurde. | | 1.0.1.1352 | 16. November 2017 | **Hinweis**: Diese Version wird nicht mehr unterstützt. Wenn Sie diese Version verwenden, schlagen Ihre Bereitstellungen fehl. **Feature**: Es wurde eine neue Funktion zum Testen und Debuggen einer EC2/On-Premises-Bereitstellung auf einem lokalen Computer oder einer Instanz eingeführt, auf der der CodeDeploy Agent installiert ist. | | 1.0.1.1106 | 16. Mai 2017 | **Hinweis**: Diese Version wird nicht mehr unterstützt. Wenn Sie diese Version verwenden, schlagen Ihre Bereitstellungen fehl. **Funktion**: Einführung neuer Unterstützung für den Umgang mit Inhalten an einem Zielort, der nicht Teil der Anwendungsrevision aus der letzten erfolgreichen Bereitstellung war. Bereitstellungsoptionen für vorhandene Inhalte umfassen jetzt das Speichern der Inhalte, das Überschreiben der Inhalte oder das Fehlschlagen der Bereitstellung. **Verbesserung**: Der CodeDeploy Agent wurde mit Version 2.9.2 von (2.9.2) kompatibel gemacht. AWS SDK für Ruby aws-sdk-core | | 1.0.1.1095 | 29. März 2017 | **Hinweis**: Diese Version wird nicht mehr unterstützt. Wenn Sie diese Version verwenden, schlagen Ihre Bereitstellungen fehl. **Verbesserung**: Unterstützung für den CodeDeploy Agenten in der Region China (Peking) eingeführt. **Verbesserung**: Puppet kann nun auf Windows Server-Instanzen ausgeführt werden, wenn es durch einen Lifecycle-Event-Hook aufgerufen wird. **Erweiterung**: Verbesserung der Handhabung von `untar`-Vorgängen. | | 1.0.1.1067 | 6. Januar 2017 | **Hinweis**: Diese Version wird nicht mehr unterstützt. Wenn Sie diese Version verwenden, schlagen Ihre Bereitstellungen fehl. **Erweiterung**: Prüfung zahlreicher Fehlermeldungen zur Einbeziehung spezifischerer Ursachen für Bereitstellungsfehler. **Verbesserung**: Es wurde ein Problem behoben, durch das der CodeDeploy Agent bei einigen Bereitstellungen nicht die richtige Anwendungsversion für die Bereitstellung identifizieren konnte. **Erweiterung**: Zurücksetzung der Nutzung von `pushd` und `popd` vor und nach dem `untar`-Vorgang. | | 1.0.1.1045 | 21. November 2016 | **Hinweis**: Diese Version wird nicht mehr unterstützt. Wenn Sie diese Version verwenden, schlagen Ihre Bereitstellungen fehl. **Verbesserung**: Der CodeDeploy Agent wurde mit Version 2.6.11 von AWS SDK für Ruby (aws-sdk-core2.6.11) kompatibel gemacht. | | 1.0.1.1037 | 19. Oktober 2016 | **Hinweis**: Diese Version wird nicht mehr unterstützt. Wenn Sie diese Version verwenden, schlagen Ihre Bereitstellungen fehl. Der CodeDeploy Agent für Amazon Linux-, RHEL- und Ubuntu-Server-Instances wurde mit der folgenden Änderung aktualisiert. Für Windows Server-Instances bleibt die neueste Version 1.0.1.998. **Erweiterung**: Der Agent kann jetzt bestimmen, welche Version von Ruby auf einer Instance installiert ist, sodass er das `codedeploy-agent`-Skript mit dieser Version aufrufen kann. | | 1.0.1.1011.1 | 17. August 2016 | **Hinweis**: Diese Version wird nicht mehr unterstützt. Wenn Sie diese Version verwenden, schlagen Ihre Bereitstellungen fehl. **Erweiterung**: Entfernung der Änderungen aus Version 1.0.1.1011 aufgrund von Problemen mit der Shell-Unterstützung. Diese Version des Agenten entspricht funktional Version 1.0.1.998, die am 11. Juli 2016 veröffentlicht wurde. | | 1.0.1.1011 | 15. August 2016 | **Hinweis**: Diese Version wird nicht mehr unterstützt. Wenn Sie diese Version verwenden, schlagen Ihre Bereitstellungen fehl. Der CodeDeploy Agent für Amazon Linux-, RHEL- und Ubuntu-Server-Instances wurde mit den folgenden Änderungen aktualisiert. Für Windows Server-Instances bleibt die neueste Version 1.0.1.998.**Feature**: Unterstützung für das Aufrufen des CodeDeploy Agenten mithilfe der Bash-Shell auf Betriebssystemen hinzugefügt, auf denen das Systemd-Init-System verwendet wird.Verbesserung: Unterstützung für alle Versionen von Ruby 2.x im Agenten und im CodeDeploy Agenten-Updater aktiviert. CodeDeploy Aktualisierte CodeDeploy Agenten sind nicht mehr nur von Ruby 2.0 abhängig. (Ruby 2.0 ist weiterhin für die Deb- und RPM-Versionen des CodeDeploy Agenten-Installationsprogramms erforderlich.) | | 1.0.1.998 | 11. Juli 2016 | **Hinweis**: Diese Version wird nicht mehr unterstützt. Wenn Sie diese Version verwenden, schlagen Ihre Bereitstellungen fehl. **Verbesserung**: Die Unterstützung für die Ausführung des CodeDeploy Agenten mit anderen Benutzerprofilen als *Root* wurde behoben. Die Variable mit dem Namen `USER` wird durch `CODEDEPLOY_USER` ersetzt, um Konflikte mit Umgebungsvariablen zu verhindern. | | 1.0.1.966 | 16. Juni 2016 | **Hinweis**: Diese Version wird nicht mehr unterstützt. Wenn Sie diese Version verwenden, schlagen Ihre Bereitstellungen fehl. **Feature**: Unterstützung für die Ausführung des CodeDeploy Agenten mit anderen Benutzerprofilen als *Root* eingeführt. **Erweiterung**: Wiederherstellung der Unterstützung für die Angabe der Anzahl an Anwendungsrevisionen, die der CodeDeploy-Agent für eine Bereitstellungsgruppe archivieren soll. **Verbesserung**: Der CodeDeploy Agent wurde mit Version 2.3 von AWS SDK für Ruby (aws-sdk-core 2.3) kompatibel gemacht. **Erweiterung**: Behebung von Problemen mit UTF-8-Codierung während Bereitstellungen. **Erweiterung**: Verbesserung der Genauigkeit bei der Identifikation von Prozessnamen. | | 1.0.1.950 | 24. März 2016 | **Hinweis**: Diese Version wird nicht mehr unterstützt. Wenn Sie diese Version verwenden, schlagen Ihre Bereitstellungen fehl. **Funktion**: Hinzufügung von Proxy-Support für die Installation. **Verbesserung**: Das Installationsskript wurde aktualisiert, sodass der CodeDeploy Agent nicht heruntergeladen wird, wenn die neueste Version bereits installiert ist. | | 1.0.1.934 | 11. Februar 2016 | **Hinweis**: Diese Version wird nicht mehr unterstützt. Wenn Sie diese Version verwenden, schlagen Ihre Bereitstellungen fehl. **Funktion**: Einführung der Unterstützung für die Angabe der Anzahl an Anwendungsrevisionen, die der CodeDeploy-Agent für eine Bereitstellungsgruppe archivieren soll. | | 1.0.1.880 | 11. Januar 2016 | **Hinweis**: Diese Version wird nicht mehr unterstützt und kann zum Fehlschlagen von Bereitstellungen führen. **Verbesserung**: Der CodeDeploy Agent wurde mit Version 2.2 von AWS SDK für Ruby (aws-sdk-core 2.2) kompatibel gemacht. Version 2.1.2 wird weiterhin unterstützt. | | 1.0.1.854 | 17. November 2015 | **Hinweis**: Diese Version wird nicht mehr unterstützt. Wenn Sie diese Version verwenden, schlagen Ihre Bereitstellungen fehl. **Funktion**: Einführung von Unterstützung für den SHA-256-Hash-Algorithmus. **Funktion**: Einführung von Unterstützung für die Versionskontrolle in `.version`-Dateien. **Funktion**: Herstellung der Verfügbarkeit der Bereitstellungsgruppen-ID durch Verwendung einer Umgebungsvariablen. **Verbesserung**: Unterstützung für die Überwachung von CodeDeploy Agentenprotokollen mithilfe von [Amazon CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatchLogs.html) hinzugefügt. | Zugehörige Informationen finden Sie unter den folgenden Themen: + [Ermitteln Sie die Version des CodeDeploy Agenten](codedeploy-agent-operations-version.md) + [Installieren Sie den CodeDeploy Agenten](codedeploy-agent-operations-install.md) Eine Historie der CodeDeploy Agentenversionen finden Sie im [Release-Repository unter GitHub](https://github.com/aws/aws-codedeploy-agent/releases). ## Den CodeDeploy Prozess verwalten Alle Linux-Distributionen des CodeDeploy Agenten (rpm und deb) verwenden standardmäßig [systemd](https://systemd.io/), um den Agentenprozess zu verwalten. Sowohl die RPM- als auch die Deb-Distribution werden jedoch mit Startskripten ausgeliefert, die sich unter befinden. `/etc/init.d/codedeploy-agent` Je nachdem, welche Distribution Sie verwenden, `/etc/init.d` können bei der Verwendung eines Befehls wie die Skripte unter ausgeführt werden`sudo service codedeploy-agent restart`, um den Agentenprozess zu starten, anstatt den Prozess `systemd` zu verwalten. Das Ausführen von Skripten unter `/etc/init.d` ist unerwünscht. Um dieses Problem zu vermeiden, empfehlen `systemd` wir für Systeme, die dies unterstützen, das `systemctl` Tool für alle Agentenoperationen zu verwenden, anstatt den `service` Befehl zu verwenden. Verwenden Sie zum Beispiel, um den CodeDeploy Agenten neu zu starten, `sudo systemctl restart codedeploy-agent` anstelle des entsprechenden Befehls mit dem `service` Hilfsprogramm. ## Revision der Anwendung und Bereinigung der Protokolldateien Der CodeDeploy Agent archiviert Revisionen und Protokolldateien auf Instanzen. Der CodeDeploy Agent bereinigt diese Artefakte, um Speicherplatz zu sparen. **Protokolle zur Bereitstellung von Anwendungsrevisionen**: Sie können die **Option:max\$1revisions:** in der Agenten-Konfigurationsdatei verwenden, um die Anzahl der zu archivierenden Anwendungsrevisionen durch Eingabe einer beliebigen positiven Ganzzahl anzugeben. CodeDeploy archiviert auch die Protokolldateien für diese Revisionen. Alle anderen werden gelöscht, mit Ausnahme der Protokolldatei der letzten erfolgreichen Bereitstellung. Diese Protokolldatei wird immer aufbewahrt, auch wenn die Anzahl der fehlgeschlagenen Bereitstellungen die Anzahl der aufbewahrten Revisionen überschreitet. Wenn kein Wert angegeben ist, werden die fünf neuesten Versionen zusätzlich zur aktuell bereitgestellten Version CodeDeploy beibehalten. **CodeDeploy Logs**: Für Amazon Linux-, Ubuntu Server- und RHEL-Instances rotiert der CodeDeploy Agent die Protokolldateien im `/var/log/aws/codedeploy-agent` Ordner. Die Protokolldatei wird jeden Tag um 00:00:00 (Instance-Zeit) rotiert. Protokolldateien werden nach sieben Tagen gelöscht. Das Benennungsmuster für rotierte Protokolldateien ist `codedeploy-agent.YYYYMMDD.log`. ## Vom Agenten installierte Dateien CodeDeploy Der CodeDeploy Agent speichert Revisionen, den Bereitstellungsverlauf und Bereitstellungsskripts in seinem Stammverzeichnis auf einer Instanz. Der Standardname und Speicherort für dieses Verzeichnis lauten: `'/opt/codedeploy-agent/deployment-root'`für Amazon Linux-, Ubuntu Server- und RHEL-Instances. `'C:\ProgramData\Amazon\CodeDeploy'`für Windows Server-Instanzen. Sie können die Einstellung **root\$1dir** in der CodeDeploy Agent-Konfigurationsdatei verwenden, um den Namen und den Speicherort des Verzeichnisses zu konfigurieren. Weitere Informationen finden Sie unter [CodeDeploy Referenz zur Agentenkonfiguration](reference-agent-configuration.md). Es folgt ein Beispiel für die Datei- und Verzeichnisstruktur unter dem Stammverzeichnis. Die Struktur geht davon aus, dass es N Bereitstellungsgruppen gibt und jede Bereitstellungsgruppe N Bereitstellungen enthält. ``` |--deployment-root/ |-- deployment group 1 ID | |-- deployment 1 ID | | |-- Contents and logs of the deployment's revision | |-- deployment 2 ID | | |-- Contents and logs of the deployment's revision | |-- deployment N ID | | |-- Contents and logs of the deployment's revision |-- deployment group 2 ID | |-- deployment 1 ID | | |-- bundle.tar | | |-- deployment-archive | | | | -- contents of the deployment's revision | | |-- logs | | | | -- scripts.log | |-- deployment 2 ID | | |-- bundle.tar | | |-- deployment-archive | | | | -- contents of the deployment's revision | | |-- logs | | | | -- scripts.log | |-- deployment N ID | | |-- bundle.tar | | |-- deployment-archive | | | | -- contents of the deployment's revision | | |-- logs | | | | -- scripts.log |-- deployment group N ID | |-- deployment 1 ID | | |-- Contents and logs of the deployment's revision | |-- deployment 2 ID | | |-- Contents and logs of the deployment's revision | |-- deployment N ID | | |-- Contents and logs of the deployment's revision |-- deployment-instructions | |-- [deployment group 1 ID]_cleanup | |-- [deployment group 2 ID]_cleanup | |-- [deployment group N ID]_cleanup | |-- [deployment group 1 ID]_install.json | |-- [deployment group 2 ID]_install.json | |-- [deployment group N ID]_install.json | |-- [deployment group 1 ID]_last_successful_install | |-- [deployment group 2 ID]_last_successful_install | |-- [deployment group N ID]_last_successful_install | |-- [deployment group 1 ID]_most_recent_install | |-- [deployment group 2 ID]_most_recent_install | |-- [deployment group N ID]_most_recent_install |-- deployment-logs | |-- codedeploy-agent-deployments.log ``` + **Deployment Group ID**-Ordner stehen für Ihre einzelnen Bereitstellungsgruppen. Der Verzeichnisname einer Bereitstellungsgruppe ist ihre ID (z. B. `acde1916-9099-7caf-fd21-012345abcdef`). Jedes Verzeichnis einer Bereitstellungsgruppe enthält ein Unterverzeichnis für jede versuchte Bereitstellung in der jeweiligen Gruppe. Mit dem Befehl [batch-get-deployments](https://docs.aws.amazon.com/cli/latest/reference/deploy/batch-get-deployments.html) können Sie eine Bereitstellungsgruppen-ID finden. + **Deployment ID**-Ordner stehen für die einzelnen Bereitstellungen in einer Bereitstellungsgruppe. Jeder Verzeichnisname einer Bereitstellung ist ihre ID. Jeder Ordner enthält: + **bundle.tar**, eine komprimierte Datei mit dem Inhalt der Bereitstellungsrevision. Verwenden Sie ein ZIP-Hilfsprogramm zum Dekomprimieren, wenn Sie die Revision anzeigen möchten. + **deployment-archive**, ein Verzeichnis mit den Inhalten der Bereitstellungsrevision. + **logs**, ein Verzeichnis mit einer `scripts.log`-Datei. In dieser Datei wird die Ausgabe aller Skripts aufgeführt, die in der Bereitstellungsdatei angegeben sind. AppSpec Wenn Sie den Ordner für eine Bereitstellung suchen möchten, aber dessen Bereitstellungs- oder Bereitstellungsgruppen-ID nicht kennen, können Sie die [AWS CodeDeploy Konsole](https://console.aws.amazon.com/codedeploy) oder die verwenden, AWS CLI um sie zu finden. Weitere Informationen finden Sie unter [CodeDeploy Bereitstellungsdetails anzeigen](deployments-view-details.md). Die standardmäßige maximale Anzahl von Bereitstellungen, die in einer Bereitstellungsgruppe archiviert werden können, ist fünf. Wenn diese Anzahl erreicht ist, werden künftige Bereitstellungen archiviert und das älteste Archiv gelöscht. Sie können die Einstellung **max\$1revisions** in der CodeDeploy Agentenkonfigurationsdatei verwenden, um die Standardeinstellung zu ändern. Weitere Informationen finden Sie unter [CodeDeploy Referenz zur Agentenkonfiguration](reference-agent-configuration.md). **Anmerkung** Wenn Sie den von archivierten Bereitstellungen belegten Festplattenspeicher zurückgewinnen möchten, aktualisieren Sie die Einstellung **max\$1revisions** auf eine niedrige Zahl, etwa 1 oder 2. Die nächste Bereitstellung löscht archivierte Bereitstellungen, so dass die Anzahl der von Ihnen angegebenen entspricht. + **deployment-instructions** enthält vier Textdateien für jede Bereitstellungsgruppe: + **[Deployment Group ID]-cleanup**, eine Textdatei mit einer Undo-Version jedes Befehls, der während einer Bereitstellung ausgeführt wird. Der Dateiname lautet z. B. `acde1916-9099-7caf-fd21-012345abcdef-cleanup`. + **[Deployment Group ID]-install.json**, eine JSON-Datei, die während der letzten Bereitstellung erstellt wurde. Sie enthält die Befehle, die während der Bereitstellung ausgeführt werden. Der Dateiname lautet z. B. `acde1916-9099-7caf-fd21-012345abcdef-install.json`. + **[Deployment Group ID]\$1last\$1successfull\$1install**, eine Textdatei, die das Archivverzeichnis der letzten erfolgreichen Bereitstellung auflistet. Diese Datei wird erstellt, wenn der CodeDeploy Agent alle Dateien in der Bereitstellungsanwendung auf die Instanz kopiert hat. Sie wird vom CodeDeploy Agenten bei der nächsten Bereitstellung verwendet, um zu bestimmen, welche `ApplicationStop` `BeforeInstall` Skripte ausgeführt werden sollen. Der Dateiname lautet z. B. `acde1916-9099-7caf-fd21-012345abcdef_last_successfull_install`. + **[Deployment Group ID]\$1most\$1recent\$1install**, eine Textdatei, die den Namen des Archivverzeichnisses der letzten Bereitstellung auflistet. Diese Datei wird erstellt, wenn die Dateien in der Bereitstellung erfolgreich heruntergeladen wurden. Die [deployment group ID]\$1last\$1successfull\$1install-Datei wird nach dieser Datei erstellt, wenn die heruntergeladenen Dateien an das endgültige Ziel kopiert werden. Der Dateiname lautet z. B. `acde1916-9099-7caf-fd21-012345abcdef_most_recent_install`. + **deployment-logs** enthält die folgenden Protokolldateien: + **codedeploy-agent.yyyymmdd.log**-Dateien werden für jeden Tag erstellt, an dem eine Bereitstellung erfolgt. Jede Protokolldatei enthält Informationen zu den Bereitstellungen des jeweiligen Tages. Diese Protokolldateien können nützlich sein, um Probleme wie ein Berechtigungsproblem zu beheben. Diese Protokolldatei heißt zunächst `codedeploy-agent.log`. Am nächsten Tag wird das Datum der Bereitstellung in den Dateinamen eingefügt. Ist das Tagesdatum beispielsweise der 3. Januar 2018, können Sie Informationen zu allen Bereitstellungen in `codedeploy-agent.log` finden. Morgen, am 4. Januar 2018, wird die Protokolldatei nach `codedeploy-agent.20180103.log` umbenannt. + **codedeploy-agent-deployments.log** kompiliert den Inhalt der `scripts.log` Dateien für jede Bereitstellung. Die `scripts.log`-Dateien befinden sich im `logs`-Unterordner unter dem jeweiligen `Deployment ID`-Ordner. Den Einträgen in dieser Datei ist eine Deployment-ID vorangestellt. Beispiel: "`[d-ABCDEF123]LifecycleEvent - BeforeInstall`" kann während einer Bereitstellung mit der ID `d-ABCDEF123` erscheinen. Wenn die maximale Größe `codedeploy-agent-deployments.log` erreicht ist, schreibt der CodeDeploy Agent weiter darauf und löscht gleichzeitig alte Inhalte. # Verwaltung des CodeDeploy Agentenbetriebs Die Anweisungen in diesem Abschnitt zeigen Ihnen, wie Sie den CodeDeploy Agenten installieren, deinstallieren, neu installieren oder aktualisieren und wie Sie überprüfen können, ob der CodeDeploy Agent ausgeführt wird. **Topics** + [ # Stellen Sie sicher, dass der CodeDeploy Agent läuft ](codedeploy-agent-operations-verify.md) + [ # Ermitteln Sie die Version des CodeDeploy Agenten ](codedeploy-agent-operations-version.md) + [ # Installieren Sie den CodeDeploy Agenten ](codedeploy-agent-operations-install.md) + [ # Aktualisieren Sie den Agenten CodeDeploy ](codedeploy-agent-operations-update.md) + [ # Deinstallieren Sie den Agenten CodeDeploy ](codedeploy-agent-operations-uninstall.md) + [ # CodeDeploy Agentenprotokolle senden an CloudWatch ](codedeploy-agent-operations-cloudwatch-agent.md) # Stellen Sie sicher, dass der CodeDeploy Agent läuft In diesem Abschnitt werden Befehle beschrieben, die ausgeführt werden müssen, wenn Sie vermuten, dass der CodeDeploy Agent auf einer Instance nicht mehr ausgeführt wird. **Topics** + [ ## Stellen Sie sicher, dass der CodeDeploy Agent für Amazon Linux oder RHEL läuft ](#codedeploy-agent-operations-verify-linux) + [ ## Stellen Sie sicher, dass der CodeDeploy Agent für Ubuntu Server läuft ](#codedeploy-agent-operations-verify-ubuntu) + [ ## Stellen Sie sicher, dass der CodeDeploy Agent für Windows Server läuft ](#codedeploy-agent-operations-verify-windows) ## Stellen Sie sicher, dass der CodeDeploy Agent für Amazon Linux oder RHEL läuft Um zu sehen, ob der CodeDeploy Agent installiert ist und läuft, melden Sie sich bei der Instance an und führen Sie den folgenden Befehl aus: ``` systemctl status codedeploy-agent ``` Wenn der Befehl einen Fehler zurückgibt, ist der CodeDeploy Agent nicht installiert. Installieren Sie ihn, wie in [Installieren Sie den CodeDeploy Agenten für Amazon Linux oder RHEL](codedeploy-agent-operations-install-linux.md) beschrieben. Wenn der CodeDeploy Agent installiert ist und läuft, sollten Sie eine Meldung wie sehen`The AWS CodeDeploy agent is running`. Wenn Sie eine Meldung sehen wie `error: No AWS CodeDeploy agent running`, starten Sie den Service neu und führen die beiden folgenden Befehle nacheinander aus: ``` systemctl start codedeploy-agent ``` ``` systemctl status codedeploy-agent ``` ## Stellen Sie sicher, dass der CodeDeploy Agent für Ubuntu Server läuft Um zu überprüfen, ob der CodeDeploy Agent installiert ist und läuft, melden Sie sich bei der Instanz an und führen Sie den folgenden Befehl aus: ``` systemctl status codedeploy-agent ``` Wenn der Befehl einen Fehler zurückgibt, ist der CodeDeploy Agent nicht installiert. Installieren Sie ihn, wie in [Installieren Sie den CodeDeploy Agenten für Ubuntu Server](codedeploy-agent-operations-install-ubuntu.md) beschrieben. Wenn der CodeDeploy Agent installiert ist und läuft, sollten Sie eine Meldung wie sehen`The AWS CodeDeploy agent is running`. Wenn Sie eine Meldung sehen wie `error: No AWS CodeDeploy agent running`, starten Sie den Service neu und führen die beiden folgenden Befehle nacheinander aus: ``` systemctl start codedeploy-agent ``` ``` systemctl status codedeploy-agent ``` ## Stellen Sie sicher, dass der CodeDeploy Agent für Windows Server läuft Um zu überprüfen, ob der CodeDeploy Agent installiert ist und läuft, melden Sie sich bei der Instanz an und führen Sie den folgenden Befehl aus: ``` powershell.exe -Command Get-Service -Name codedeployagent ``` Die Ausgabe sollte folgendermaßen oder ähnlich aussehen: ``` Status Name DisplayName ------ ---- ----------- Running codedeployagent CodeDeploy Host Agent Service ``` Wenn der Befehl einen Fehler zurückgibt, ist der CodeDeploy Agent nicht installiert. Installieren Sie ihn, wie in [Installieren Sie den CodeDeploy Agenten für Windows Server](codedeploy-agent-operations-install-windows.md) beschrieben. Wenn für `Status` etwas anderes als `Running` angezeigt wird, starten Sie den Service mit dem folgenden Befehl: ``` powershell.exe -Command Start-Service -Name codedeployagent ``` Sie können den Service mit dem folgenden Befehl neu starten: ``` powershell.exe -Command Restart-Service -Name codedeployagent ``` Sie können den Service mit dem folgenden Befehl stoppen: ``` powershell.exe -Command Stop-Service -Name codedeployagent ``` # Ermitteln Sie die Version des CodeDeploy Agenten Sie können die Version des CodeDeploy Agenten, der auf Ihrer Instance ausgeführt wird, auf zwei Arten ermitteln. Zunächst können Sie ab Version 1.0.1.854 des CodeDeploy Agenten die Versionsnummer in einer `.version` Datei auf der Instanz anzeigen. Die folgende Tabelle enthält den Speicherort und eine Beispielversionszeichenfolge für jedes unterstützte Betriebssystem. | Betriebssystem | Speicherort der Datei | Beispielzeichenfolge für Agentversion | | --- | --- | --- | | Amazon Linux und Red Hat Enterprise Linux (RHEL) | /opt/codedeploy-agent/.version | OFFICIAL\$11.0.1.854\$1rpm | | Ubuntu Server | /opt/codedeploy-agent/.version | OFFICIAL\$11.0.1.854\$1deb | | Windows Server | C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1.version | OFFICIAL\$11.0.1.854\$1msi | Zweitens können Sie einen Befehl auf einer Instance ausführen, um die Version des CodeDeploy-Agenten zu ermitteln. **Topics** + [ ## Ermitteln Sie die Version auf Amazon Linux oder RHEL ](#codedeploy-agent-operations-version-linux) + [ ## Ermitteln Sie die Version auf Ubuntu Server ](#codedeploy-agent-operations-version-ubuntu) + [ ## Ermitteln Sie die Version auf Windows Server ](#codedeploy-agent-operations-version-windows) ## Ermitteln Sie die Version auf Amazon Linux oder RHEL Melden Sie sich bei der Instance an, und führen Sie den folgenden Befehl aus: ``` sudo yum info codedeploy-agent ``` ## Ermitteln Sie die Version auf Ubuntu Server Melden Sie sich bei der Instance an, und führen Sie den folgenden Befehl aus: ``` sudo dpkg -s codedeploy-agent ``` ## Ermitteln Sie die Version auf Windows Server Melden Sie sich bei der Instance an, und führen Sie den folgenden Befehl aus: ``` sc qdescription codedeployagent ``` # Installieren Sie den CodeDeploy Agenten Für die Verwendung CodeDeploy auf EC2-Instances oder lokalen Servern muss der CodeDeploy Agent zuerst installiert werden. Wir empfehlen, den CodeDeploy Agenten mit zu installieren und zu aktualisieren. AWS Systems Manager Weitere Informationen zu Systems Manager finden Sie unter [Was ist AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html). Sie können die Installation und geplante Updates des CodeDeploy Agenten mit Systems Manager in der Konsole einrichten, wenn Sie Ihre Bereitstellungsgruppen erstellen. Sie können den CodeDeploy Agenten auch direkt über die Befehlszeile aus einem S3-Bucket installieren. Die empfohlene Version für die Installation finden Sie unter[Versionsverlauf des Agenten CodeDeploy](codedeploy-agent.md#codedeploy-agent-version-history). **Topics** + [ # Installieren Sie den CodeDeploy Agenten mit AWS Systems Manager ](codedeploy-agent-operations-install-ssm.md) + [ # Installieren Sie den CodeDeploy Agenten über die Befehlszeile ](codedeploy-agent-operations-install-cli.md) # Installieren Sie den CodeDeploy Agenten mit AWS Systems Manager Sie können das AWS-Managementkonsole oder das verwenden AWS CLI , um den CodeDeploy Agenten auf Ihren Amazon EC2- oder lokalen Instances zu installieren, indem Sie. AWS Systems Manager Sie können wählen, ob Sie eine bestimmte Version installieren oder immer die neueste Version des Agenten installieren möchten. Weitere Informationen zu finden Sie AWS Systems Manager unter [Was ist](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html). AWS Systems Manager Die Verwendung AWS Systems Manager ist die empfohlene Methode für die Installation und Aktualisierung des CodeDeploy Agenten. Sie können den CodeDeploy Agenten auch von einem Amazon S3 S3-Bucket aus installieren. Informationen zum Verwenden eines Amazon-S3-Download-Links finden Sie unter [Installieren Sie den CodeDeploy Agenten über die Befehlszeile](codedeploy-agent-operations-install-cli.md). **Topics** + [ ## Voraussetzungen ](#install-codedeploy-agent-prereqs) + [ ## Installieren Sie den CodeDeploy Agenten ](#download-codedeploy-agent-on-EC2-Instance) ## Voraussetzungen Folgen Sie den Schritten unter[Erste Schritte mit CodeDeploy](getting-started-codedeploy.md), um IAM-Berechtigungen einzurichten und die AWS CLI. Wenn Sie den CodeDeploy Agenten auf einem lokalen Server mit Systems Manager installieren, müssen Sie Ihren lokalen Server bei Amazon EC2 Systems Manager registrieren. Weitere Informationen finden Sie im *AWS Systems Manager Benutzerhandbuch* unter [Systems Manager in Hybridumgebungen einrichten](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-managedinstances.html). ## Installieren Sie den CodeDeploy Agenten Bevor Sie Systems Manager zur Installation des CodeDeploy Agenten verwenden können, müssen Sie sicherstellen, dass die Instanz korrekt für Systems Manager konfiguriert ist. ### Installation oder Aktualisierung des SSM-Agenten Auf einer Amazon EC2 EC2-Instance benötigt der CodeDeploy Agent, dass auf der Instance Version 2.3.274.0 oder höher ausgeführt wird. Bevor Sie den CodeDeploy Agenten installieren, aktualisieren oder installieren Sie den SSM-Agent auf der Instance, falls Sie dies noch nicht getan haben. Der SSM-Agent ist auf einigen Amazon EC2 AMIs EC2-Geräten vorinstalliert, die von bereitgestellt werden. AWS Weitere Informationen finden Sie unter [Amazon Machine Images (AMIs) mit vorinstalliertem SSM-Agent](https://docs.aws.amazon.com/systems-manager/latest/userguide/ami-preinstalled-agent.html). **Anmerkung** Stellen Sie sicher, dass das Betriebssystem der Instance auch vom Agenten unterstützt wird. CodeDeploy Weitere Informationen finden Sie unter [Betriebssysteme, die vom Agenten unterstützt werden CodeDeploy](codedeploy-agent.md#codedeploy-agent-supported-operating-systems). Informationen zur Installation oder Aktualisierung des SSM-Agenten auf einer Instanz, auf der Linux ausgeführt wird, finden Sie im *AWS Systems Manager Benutzerhandbuch* unter [Installation und Konfiguration des SSM-Agenten auf Linux-Instances](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-ssm-agent.html). *Informationen zur Installation oder Aktualisierung des SSM-Agenten auf einer Instanz, auf der Windows Server ausgeführt wird, finden Sie im [Benutzerhandbuch unter Installation und Konfiguration des SSM-Agenten auf Windows-Instanzen](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-ssm-win.html).AWS Systems Manager * ### (Optional) Überprüfen der Voraussetzungen für Systems Manager Bevor Sie Systems Manager Run Command zur Installation des CodeDeploy Agenten verwenden, stellen Sie sicher, dass Ihre Instances die Mindestanforderungen von Systems Manager erfüllen. Weitere Informationen finden Sie unter [Einrichten von AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up.html) im *Benutzerhandbuch für AWS Systems Manager *. ### Installieren Sie den CodeDeploy Agenten Mit SSM können Sie den CodeDeploy einmal installieren oder einen Zeitplan für die Installation neuer Versionen einrichten. Um den CodeDeploy Agenten zu installieren, wählen Sie das `AWSCodeDeployAgent` Paket aus und folgen dabei den Schritten unter [Pakete mit dem AWS Systems Manager Händler installieren oder aktualisieren](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor-working-with-packages-deploy.html). # Installieren Sie den CodeDeploy Agenten über die Befehlszeile **Anmerkung** Wir empfehlen, den CodeDeploy Agenten mit AWS Systems Manager zu installieren, um geplante Updates des Agenten konfigurieren zu können. Weitere Informationen finden Sie unter [Installieren Sie den CodeDeploy Agenten mit AWS Systems Manager](codedeploy-agent-operations-install-ssm.md). Verwenden Sie die folgenden Themen, um den CodeDeploy Agenten über die Befehlszeile zu installieren und auszuführen. **Topics** + [ # Installieren Sie den CodeDeploy Agenten für Amazon Linux oder RHEL ](codedeploy-agent-operations-install-linux.md) + [ # Installieren Sie den CodeDeploy Agenten für Ubuntu Server ](codedeploy-agent-operations-install-ubuntu.md) + [ # Installieren Sie den CodeDeploy Agenten für Windows Server ](codedeploy-agent-operations-install-windows.md) # Installieren Sie den CodeDeploy Agenten für Amazon Linux oder RHEL Melden Sie sich bei der Instance an, und führen Sie die folgenden Befehle nacheinander aus. Es hat sich bewährt, den Befehl `sudo yum update` zuerst auszuführen, wenn es `yum` um die Installation von Paketen geht. Sie können ihn jedoch überspringen, wenn Sie nicht alle Ihre Pakete aktualisieren möchten. ``` sudo yum update ``` ``` sudo yum install ruby ``` ``` sudo yum install wget ``` (Optional) Führen Sie das folgende Skript aus, um das AMI von allen vorherigen Agent-Caching-Informationen zu säubern: ``` #!/bin/bash CODEDEPLOY_BIN="/opt/codedeploy-agent/bin/codedeploy-agent" $CODEDEPLOY_BIN stop yum erase codedeploy-agent -y ``` Wechseln Sie zu Ihrem Home-Verzeichnis: ``` cd /home/ec2-user ``` **Anmerkung** `/home/ec2-user`Stellt im vorherigen Befehl den Standardbenutzernamen für eine Amazon Linux- oder RHEL Amazon EC2 EC2-Instance dar. Wenn Ihre Instance mit einer benutzerdefinierten AMI erstellt wurde, kann der Eigentümer der AMI einen anderen Standardbenutzernamen angegeben haben. Laden Sie das CodeDeploy Agent-Installationsprogramm herunter: ``` wget https://bucket-name.s3.region-identifier.amazonaws.com/latest/install ``` *bucket-name*ist der Name des Amazon S3 S3-Buckets, der die CodeDeploy Resource Kit-Dateien für Ihre Region enthält, und *region-identifier* ist die Kennung für Ihre Region. Beispiel: `https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latest/install` Eine Liste der Bucket-Namen und Regionskennungen finden Sie unter[Bucket-Namen für das Resource Kit nach Regionen](resource-kit.md#resource-kit-bucket-names). Legen Sie Ausführungsberechtigungen für die `install` Datei fest: ``` chmod +x ./install ``` Um die neueste Version des CodeDeploy Agenten zu installieren: + ``` sudo ./install auto ``` Um eine bestimmte Version des CodeDeploy Agenten zu installieren: + Listet die verfügbaren Versionen in Ihrer Region auf: ``` aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.rpm$' ``` + Installieren Sie eine der folgenden Versionen: ``` sudo ./install auto -v releases/codedeploy-agent-version.noarch.rpm ``` **Anmerkung** AWS unterstützt die neueste Nebenversion des CodeDeploy Agenten. Derzeit ist die neueste Nebenversion 1.7.x. Führen Sie den folgenden Befehl aus, um zu prüfen, ob der Dienst ausgeführt wird: ``` systemctl status codedeploy-agent ``` Wenn der CodeDeploy Agent installiert ist und läuft, sollten Sie eine Meldung wie sehen. `The AWS CodeDeploy agent is running` Wenn Sie eine Meldung sehen wie `error: No AWS CodeDeploy agent running`, starten Sie den Service neu und führen die beiden folgenden Befehle nacheinander aus: ``` systemctl start codedeploy-agent ``` ``` systemctl status codedeploy-agent ``` # Installieren Sie den CodeDeploy Agenten für Ubuntu Server **Anmerkung** Wir empfehlen, den CodeDeploy Agenten mit AWS Systems Manager zu installieren, um geplante Updates des Agenten konfigurieren zu können. Weitere Informationen finden Sie unter [Installieren Sie den CodeDeploy Agenten mit AWS Systems Manager](codedeploy-agent-operations-install-ssm.md). **Um den CodeDeploy Agenten auf Ubuntu Server zu installieren** 1. Melden Sie sich bei der Instanz an. 1. Geben Sie nacheinander die folgenden Befehle ein: ``` sudo apt update ``` ``` sudo apt install ruby-full ``` ``` sudo apt install wget ``` 1. Geben Sie den folgenden Befehl ein: ``` cd /home/ubuntu ``` */home/ubuntu*steht für den Standardbenutzernamen für eine Ubuntu-Server-Instanz. Wenn Ihre Instance mit einer benutzerdefinierten AMI erstellt wurde, kann der Eigentümer der AMI einen anderen Standardbenutzernamen angegeben haben. 1. Geben Sie den folgenden Befehl ein: ``` wget https://bucket-name.s3.region-identifier.amazonaws.com/latest/install ``` *bucket-name*ist der Name des Amazon S3 S3-Buckets, der die CodeDeploy Resource Kit-Dateien für Ihre Region enthält, und *region-identifier* ist die Kennung für Ihre Region. Beispiel: `https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latest/install` Eine Liste der Bucket-Namen und Regionskennungen finden Sie unter[Bucket-Namen für das Resource Kit nach Regionen](resource-kit.md#resource-kit-bucket-names). 1. Geben Sie den folgenden Befehl ein: ``` chmod +x ./install ``` 1. Führen Sie eine der folgenden Aktionen aus: + Um die neueste Version des CodeDeploy Agenten auf einer beliebigen unterstützten Version von Ubuntu Server *außer* 20.04 zu installieren: ``` sudo ./install auto ``` + Um die neueste Version des CodeDeploy Agenten auf Ubuntu Server 20.04 zu installieren: **Anmerkung** Das Schreiben der Ausgabe in eine temporäre Protokolldatei ist eine Problemumgehung, die verwendet werden sollte, während wir einen bekannten Fehler mit dem `install` Skript auf Ubuntu Server 20.04 beheben. ``` sudo ./install auto > /tmp/logfile ``` + *Um eine bestimmte Version des CodeDeploy Agenten auf einer beliebigen unterstützten Version von Ubuntu Server außer 20.04 zu installieren:* + Listen Sie die verfügbaren Versionen in Ihrer Region auf: ``` aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.deb$' ``` + Installieren Sie eine der folgenden Versionen: ``` sudo ./install auto -v releases/codedeploy-agent-###.deb ``` **Anmerkung** AWS unterstützt die neueste Nebenversion des CodeDeploy Agenten. Derzeit ist die neueste Nebenversion 1.7.x. + Um eine bestimmte Version des CodeDeploy Agenten auf Ubuntu Server 20.04 zu installieren: + Listen Sie die verfügbaren Versionen in Ihrer Region auf: ``` aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.deb$' ``` + Installieren Sie eine der folgenden Versionen: ``` sudo ./install auto -v releases/codedeploy-agent-###.deb > /tmp/logfile ``` **Anmerkung** Das Schreiben der Ausgabe in eine temporäre Protokolldatei ist eine Problemumgehung, die verwendet werden sollte, während wir einen bekannten Fehler mit dem `install` Skript auf Ubuntu Server 20.04 beheben. **Anmerkung** AWS unterstützt die neueste Nebenversion des Agenten. CodeDeploy Derzeit ist die neueste Nebenversion 1.7.x. **Um zu überprüfen, ob der Dienst läuft** 1. Geben Sie den folgenden Befehl ein: ``` systemctl status codedeploy-agent ``` Wenn der CodeDeploy Agent installiert ist und läuft, sollten Sie eine Meldung wie sehen`The AWS CodeDeploy agent is running`. 1. Wenn Sie eine Meldung sehen wie `error: No AWS CodeDeploy agent running`, starten Sie den Service neu und führen die beiden folgenden Befehle nacheinander aus: ``` systemctl start codedeploy-agent ``` ``` systemctl status codedeploy-agent ``` # 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, ist`C:\Program Data\Amazon\CodeDeploy`. Stellen Sie sicher, dass sich in diesem Pfad keine Verzeichnisverbindungen oder symbolischen Links befinden. **Topics** + [ ## Verwenden von Systems Manager ](#codedeploy-agent-operations-install-system-manager) + [ ## Verwenden Sie Windows PowerShell ](#codedeploy-agent-operations-install-windows-powershell) + [ ## Verwenden eines Direkt-Links ](#codedeploy-agent-operations-install-windows-direct-link) + [ ## Verwenden Sie einen Amazon S3 S3-Kopierbefehl ](#codedeploy-agent-operations-install-windows-s3-copy) ## Verwenden von Systems Manager Folgen Sie den Anweisungen unter[Installieren Sie den CodeDeploy Agenten mit AWS Systems Manager](codedeploy-agent-operations-install-ssm.md), 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 ``` 1. Laden Sie das AWS Tools for Windows PowerShell. ``` Import-Module AWSPowerShell ``` 1. Erstellen Sie ein Verzeichnis, in das die CodeDeploy Agenteninstallationsdatei heruntergeladen wird. ``` New-Item -Path "c:\temp" -ItemType "directory" -Force ``` 1. Konfigurieren Sie die AWS Anmeldeinformationen mit den `Initialize-AWSDefaultConfiguration` Befehlen `Set-AWSCredential` und. Weitere Informationen finden Sie unter [Verwenden von AWS Anmeldeinformationen](https://docs.aws.amazon.com/powershell/latest/userguide/specifying-your-aws-credentials.html) im * PowerShell Benutzerhandbuch zu AWS Tools*. 1. Laden Sie die CodeDeploy Agenteninstallationsdatei herunter. **Anmerkung** AWS unterstützt die neueste Nebenversion des CodeDeploy Agenten. Derzeit ist die neueste Nebenversion 1.7.x. Gehen Sie wie folgt vor, um die neueste Version des CodeDeploy Agenten zu installieren: + ``` 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-name*ist 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* durch`aws-codedeploy-us-east-2`. Eine Liste der Bucket-Namen finden Sie unter[Bucket-Namen für das Resource Kit nach Regionen](resource-kit.md#resource-kit-bucket-names). 1. 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 sehen**Start...**: ``` 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 sehen**Running**: ``` 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ür`https://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. 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. 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](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) herunterladen und dann das Installationsprogramm manuell ausführen. Weitere Informationen finden [Sie unter Installieren von AWS Command Line Interface unter Microsoft Windows](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html). Der Amazon S3 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 ``` # Aktualisieren Sie den Agenten CodeDeploy Sie können automatische, geplante Updates des CodeDeploy Agenten auf allen unterstützten Betriebssystemen mithilfe von konfigurieren AWS Systems Manager. Sie können Aktualisierungen unter allen unterstützten Betriebssystemen auch erzwingen, indem Sie einen Befehl auf einer Instance ausführen. **Topics** + [ # Aktualisieren Sie den CodeDeploy Agenten auf Amazon Linux oder RHEL ](codedeploy-agent-operations-update-linux.md) + [ # Aktualisieren Sie den CodeDeploy Agenten auf Ubuntu Server ](codedeploy-agent-operations-update-ubuntu.md) + [ # Aktualisieren Sie den CodeDeploy Agenten auf Windows Server ](codedeploy-agent-operations-update-windows.md) # Aktualisieren Sie den CodeDeploy Agenten auf Amazon Linux oder RHEL Um automatische, geplante Updates des CodeDeploy Agenten mithilfe von zu konfigurieren AWS Systems Manager, folgen Sie den Schritten unter [ CodeDeploy Agent installieren mit AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html). Wenn Sie ein Update des CodeDeploy Agenten erzwingen möchten, melden Sie sich bei der Instanz an und führen Sie den folgenden Befehl aus: ``` sudo /opt/codedeploy-agent/bin/install auto ``` # Aktualisieren Sie den CodeDeploy Agenten auf Ubuntu Server Um automatische, geplante Updates des CodeDeploy Agenten mithilfe von zu konfigurieren AWS Systems Manager, folgen Sie den Schritten unter [ CodeDeploy Agent installieren mit AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html). Wenn Sie ein Update des CodeDeploy Agenten erzwingen möchten, melden Sie sich bei der Instanz an und führen Sie den folgenden Befehl aus: ``` sudo /opt/codedeploy-agent/bin/install auto ``` # Aktualisieren Sie den CodeDeploy Agenten auf Windows Server Sie können automatische Updates des CodeDeploy Agenten mit aktivieren AWS Systems Manager. Mit Systems Manager können Sie einen Aktualisierungszeitplan für Ihre Amazon EC2- oder lokalen Instances konfigurieren, indem Sie eine Verknüpfung mit Systems Manager State Manager erstellen. Sie können den CodeDeploy Agenten auch manuell aktualisieren, indem Sie die aktuelle Version deinstallieren und eine neuere installieren. **Topics** + [ ## Richten Sie das automatische CodeDeploy Agenten-Update ein mit AWS Systems Manager ](#codedeploy-agent-operations-update-windows-ssm) + [ ## Aktualisieren Sie den CodeDeploy Agenten manuell ](#codedeploy-agent-operations-update-windows-manual) + [ ## (Veraltet) Aktualisieren Sie den CodeDeploy Agenten mit dem Windows Server Updater ](#codedeploy-agent-operations-update-windows-updater) ## Richten Sie das automatische CodeDeploy Agenten-Update ein mit AWS Systems Manager Folgen Sie den Anweisungen unter [Installieren des CodeDeploy Agenten mit, um Systems Manager zu konfigurieren und automatische Updates des CodeDeploy Agenten](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html) zu aktivieren AWS Systems Manager. ## Aktualisieren Sie den CodeDeploy Agenten manuell Um den CodeDeploy Agenten manuell zu aktualisieren, können Sie die neueste Version über die CLI oder mit Systems Manager installieren. Folgen Sie den Anweisungen unter [Installieren des CodeDeploy-Agenten.](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install.html) Es wird empfohlen, ältere Versionen des CodeDeploy Agenten zu deinstallieren, indem Sie den Anweisungen unter [ CodeDeployAgent deinstallieren](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-uninstall.html) folgen. ## (Veraltet) Aktualisieren Sie den CodeDeploy Agenten mit dem Windows Server Updater **Anmerkung** Der CodeDeploy Agent-Updater für Windows Server ist veraltet und kann auf keine Version nach 1.0.1.1597 aktualisiert werden. Um automatische Updates des Agenten zu aktivieren, installieren Sie den CodeDeploy CodeDeploy Agent-Updater für Windows Server auf neuen oder vorhandenen Instanzen. Der Updater prüft regelmäßig, ob eine neue Version vorhanden ist. Wenn der Updater eine neue Version findet, deinstalliert er die aktuelle Agent-Version, sofern eine installiert ist, bevor er die neueste Version installiert. Wenn bereits eine Bereitstellung ausgeführt wird, sobald der Updater eine neue Version erkennt, wird die Bereitstellung zuerst abgeschlossen. Wird während der Aktualisierung eine Bereitstellung versucht, dann schlägt diese jedoch fehl. Wenn Sie ein Update des CodeDeploy Agenten erzwingen möchten, folgen Sie den Anweisungen unter[Installieren Sie den CodeDeploy Agenten für Windows Server](codedeploy-agent-operations-install-windows.md). Auf Windows Server-Instances können Sie den CodeDeploy Agent-Updater herunterladen und installieren, indem Sie PowerShell Windows-Befehle ausführen, einen direkten Download-Link verwenden oder einen Amazon S3 S3-Kopierbefehl ausführen. **Topics** + [ ### Verwenden Sie Windows PowerShell ](#codedeploy-agent-operations-update-windows-powershell) + [ ### Verwenden eines Direkt-Links ](#codedeploy-agent-operations-update-windows-direct-link) + [ ### Verwenden Sie einen Amazon S3 S3-Kopierbefehl ](#codedeploy-agent-operations-update-windows-s3-copy) ### Verwenden Sie Windows PowerShell Melden Sie sich bei der Instanz an und führen Sie die folgenden Befehle nacheinander in Windows PowerShell aus: ``` Set-ExecutionPolicy RemoteSigned ``` Wenn Sie aufgefordert werden, die Ausführungsrichtlinie zu ändern, wählen Sie, **Y** dass Windows PowerShell verlangt, dass alle aus dem Internet heruntergeladenen Skripts und Konfigurationsdateien von einem vertrauenswürdigen Herausgeber signiert werden. ``` Import-Module AWSPowerShell ``` ``` New-Item -Path "c:\temp" -ItemType "directory" -Force ``` ``` powershell.exe -Command Read-S3Object -BucketName bucket-name -Key latest/codedeploy-agent-updater.msi -File c:\temp\codedeploy-agent-updater.msi ``` ``` c:\temp\codedeploy-agent-updater.msi /quiet /l c:\temp\host-agent-updater-log.txt ``` ``` powershell.exe -Command Get-Service -Name codedeployagent ``` *bucket-name*ist 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* durch`aws-codedeploy-us-east-2`. Eine Liste der Bucket-Namen finden Sie unter[Bucket-Namen für das Resource Kit nach Regionen](resource-kit.md#resource-kit-bucket-names). Wenn Sie einen Fehler beim Aktualisierungsvorgang beheben müssen, geben Sie den folgenden Befehl ein, um die Protokolldatei des CodeDeploy Agenten-Updaters zu öffnen: ``` notepad C:\ProgramData\Amazon\CodeDeployUpdater\log\codedeploy-agent.updater.log ``` ### Verwenden eines Direkt-Links Wenn die Sicherheitseinstellungen des Browsers auf der Windows Server-Instanz die erforderlichen Berechtigungen bereitstellen (z. B. für ` http://s3.*.amazonaws.com `), können Sie den CodeDeploy Agent-Updater über einen direkten Link herunterladen. Der Link lautet: ``` https://s3.region.amazonaws.com/aws-codedeploy-region/latest/codedeploy-agent-updater.msi ``` ... wo *region* ist die AWS Region, in der Sie Ihre Anwendung aktualisieren. Beispiel: ``` https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latest/codedeploy-agent-updater.msi ``` ### Verwenden Sie einen Amazon S3 S3-Kopierbefehl Wenn der auf der Instance installiert AWS CLI ist, können Sie den CodeDeploy Agent-Updater mit dem Amazon S3 S3-Befehl [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) herunterladen und dann das Installationsprogramm manuell ausführen. Weitere Informationen finden [Sie unter Installieren von AWS Command Line Interface unter Microsoft Windows](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html). Der Amazon S3 S3-Befehl lautet: ``` aws s3 cp s3://aws-codedeploy-region/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi --region region ``` ... wo *region* ist die AWS Region, in der Sie Ihre Anwendung aktualisieren. Beispiel: ``` aws s3 cp s3://aws-codedeploy-af-south-1/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi --region af-south-1 ``` # Deinstallieren Sie den Agenten CodeDeploy Sie können den CodeDeploy Agenten aus Instanzen entfernen, wenn er nicht mehr benötigt wird oder wenn Sie eine Neuinstallation durchführen möchten. ## Deinstallieren Sie den CodeDeploy Agenten von Amazon Linux oder RHEL Um den CodeDeploy Agenten zu deinstallieren, melden Sie sich bei der Instance an und führen Sie den folgenden Befehl aus: ``` sudo yum erase codedeploy-agent ``` ## Deinstallieren Sie den CodeDeploy Agenten von Ubuntu Server Um den CodeDeploy Agenten zu deinstallieren, melden Sie sich bei der Instanz an und führen Sie den folgenden Befehl aus: ``` sudo dpkg --purge codedeploy-agent ``` ## Deinstallieren Sie den CodeDeploy Agenten von Windows Server Um den CodeDeploy Agenten zu deinstallieren, melden Sie sich bei der Instanz an und führen Sie nacheinander die folgenden drei Befehle aus: ``` wmic ``` ``` product where name="CodeDeploy Host Agent" call uninstall /nointeractive ``` ``` exit ``` Sie können sich auch bei der Instanz anmelden und in der **Systemsteuerung** **Programme und Funktionen** öffnen, **CodeDeploy Host Agent** und anschließend **Deinstallieren** auswählen. # CodeDeploy Agentenprotokolle senden an CloudWatch Sie können Metrik- und Protokolldaten für CodeDeploy Agenten an CloudWatch den [Unified CloudWatch Agent](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/UseCloudWatchUnifiedAgent.html) oder, einfacher gesagt, an den CloudWatch Agenten senden. Verwenden Sie die folgenden Anweisungen, um den CloudWatch Agenten zu installieren und ihn für die Verwendung mit CodeDeploy Agenten zu konfigurieren. ## Voraussetzungen Führen Sie als Erstes die folgenden Schritte aus: + Installieren Sie den CodeDeploy Agenten und stellen Sie sicher, dass er läuft. Weitere Informationen erhalten Sie unter [Installieren Sie den CodeDeploy Agenten](codedeploy-agent-operations-install.md) und [Stellen Sie sicher, dass der CodeDeploy Agent läuft](codedeploy-agent-operations-verify.md). + Installieren Sie den CloudWatch Agenten. Weitere Informationen finden Sie unter [Installation des CloudWatch Agenten](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance.html). + Fügen Sie dem CodeDeploy IAM-Instanzprofil die folgenden Berechtigungen hinzu: + CloudWatchLogsFullAccess + CloudWatchAgentServerPolicy Weitere Informationen zum CodeDeploy Instanzprofil finden Sie unter [Schritt 4: Erstellen Sie ein IAM-Instance-Profil für Ihre Amazon EC2 EC2-Instances](getting-started-create-iam-instance-profile.md) von[Erste Schritte mit CodeDeploy](getting-started-codedeploy.md). ## Konfigurieren Sie den CloudWatch Agenten für die Erfassung von CodeDeploy Protokollen Sie können den CloudWatch Agenten konfigurieren, indem Sie einen Assistenten ausführen oder eine Konfigurationsdatei manuell erstellen oder bearbeiten. **So konfigurieren Sie den CloudWatch Agenten mit dem Assistenten (Linux)** 1. Führen Sie den Assistenten aus, wie unter Den [Assistenten zur CloudWatch Agentenkonfiguration ausführen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard) beschrieben. 1. Geben Sie im Assistenten die `Do you want to monitor any log files?` Eingabetaste ein, wenn Sie dazu aufgefordert **1** werden. 1. Geben Sie die CodeDeploy Agent-Protokolldatei wie folgt an: 1. `Log file path`Geben Sie den Pfad für die CodeDeploy Protokolldatei ein, zum Beispiel:**/var/log/aws/codedeploy-agent/codedeploy-agent.log**. 1. `Log group name`Geben Sie einen Namen für die Protokollgruppe ein, zum Beispiel:**codedeploy-agent-log**. 1. `Log stream name`Geben Sie einen Namen für den Protokollstream ein, zum Beispiel:**\$1instance\$1id\$1-codedeploy-agent-log**. 1. Wenn Sie dazu aufgefordert werden`Do you want to specify any additional log files?`, geben Sie ein**1**. 1. Geben Sie die CodeDeploy Agenten-Bereitstellungsprotokolle wie folgt an: 1. `Log file path`Geben Sie zum Beispiel den Pfad für die CodeDeploy Bereitstellungsprotokolldatei ein:**/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log**. 1. `Log group name`Geben Sie einen Namen für die Protokollgruppe ein, zum Beispiel:**codedeploy-agent-deployment-log**. 1. `Log stream name`Geben Sie einen Namen für den Protokollstream ein, zum Beispiel:**\$1instance\$1id\$1-codedeploy-agent-deployment-log**. 1. Wenn Sie dazu aufgefordert werden`Do you want to specify any additional log files?`, geben Sie ein**1**. 1. Geben Sie die CodeDeploy Agent-Updater-Protokolle wie folgt an: 1. `Log file path`Geben Sie zum Beispiel den Pfad für die CodeDeploy Updater-Protokolldatei ein:. **/tmp/codedeploy-agent.update.log** 1. `Log group name`Geben Sie einen Namen für die Protokollgruppe ein, zum Beispiel:**codedeploy-agent-updater-log**. 1. `Log stream name`Geben Sie einen Namen für den Protokollstream ein, zum Beispiel:**\$1instance\$1id\$1-codedeploy-agent-updater-log**. **Um den CloudWatch Agenten mit dem Assistenten zu konfigurieren (Windows)** 1. Führen Sie den Assistenten aus, wie unter Den [Assistenten zur CloudWatch Agentenkonfiguration ausführen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard) beschrieben. 1. Geben Sie im Assistenten die `Do you want to monitor any customized log files?` Eingabetaste ein, wenn Sie dazu aufgefordert **1** werden. 1. Geben Sie die CodeDeploy Protokolldatei wie folgt an: 1. `Log file path`Geben Sie für den Pfad oder die CodeDeploy Agenten-Protokolldatei ein, zum Beispiel:**C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1log\$1codedeploy-agent-log.txt**. 1. `Log group name`Geben Sie einen Protokollgruppennamen ein, zum Beispiel:**codedeploy-agent-log**. 1. `Log stream name`Geben Sie einen Namen für den Protokollstream ein, zum Beispiel:**\$1instance\$1id\$1-codedeploy-agent-log**. 1. Wenn Sie dazu aufgefordert werden`Do you want to specify any additional log files?`, geben Sie ein**1**. 1. Geben Sie die CodeDeploy Agenten-Bereitstellungsprotokolle wie folgt an: 1. `Log file path`Geben Sie den Pfad der CodeDeploy Bereitstellungsprotokolldatei ein, zum Beispiel:**C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1deployment-logs\$1codedeploy-agent-deployments.log**. 1. `Log group name`Geben Sie einen Namen für die Protokollgruppe ein, zum Beispiel:**codedeploy-agent-deployment-log**. 1. `Log stream name`Geben Sie einen Namen für den Protokollstream ein, zum Beispiel:**\$1instance\$1id\$1-codedeploy-agent-deployment-log**. **Um den CloudWatch Agenten durch manuelles Erstellen oder Bearbeiten einer Konfigurationsdatei zu konfigurieren (Linux)** 1. Erstellen oder bearbeiten Sie die CloudWatch Agenten-Konfigurationsdatei wie unter [Manuelles Erstellen oder Bearbeiten der CloudWatch Agenten-Konfigurationsdatei](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html) beschrieben. 1. Stellen Sie sicher, dass die Datei aufgerufen wird `/opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.json` und den folgenden Code enthält: ``` ... "logs": { "logs_collected": { "files": { "collect_list": [ { "file_path": "/var/log/aws/codedeploy-agent/codedeploy-agent.log", "log_group_name": "codedeploy-agent-log", "log_stream_name": "{instance_id}-agent-log" }, { "file_path": "/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log", "log_group_name": "codedeploy-agent-deployment-log", "log_stream_name": "{instance_id}-codedeploy-agent-deployment-log" }, { "file_path": "/tmp/codedeploy-agent.update.log", "log_group_name": "codedeploy-agent-updater-log", "log_stream_name": "{instance_id}-codedeploy-agent-updater-log" } ] } } } ... ``` **Um den CloudWatch Agenten durch manuelles Erstellen oder Bearbeiten einer Konfigurationsdatei zu konfigurieren (Windows)** 1. Erstellen oder bearbeiten Sie die CloudWatch Agent-Konfigurationsdatei wie unter [Manuelles Erstellen oder Bearbeiten der CloudWatch Agenten-Konfigurationsdatei](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html) beschrieben. 1. Stellen Sie sicher, dass die Datei aufgerufen wird `C:\ProgramData\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent.json` und den folgenden Code enthält: ``` ... "logs": { "logs_collected": { "files": { "collect_list": [ { "file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\log\\codedeploy-agent-log.txt", "log_group_name": "codedeploy-agent-log", "log_stream_name": "{instance_id}-codedeploy-agent-log" }, { "file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\deployment-logs\\codedeploy-agent-deployments.log", "log_group_name": "codedeploy-agent-deployment-log", "log_stream_name": "{instance_id}-codedeploy-agent-deployment-log" } ] }, ... } }, ... ``` ## Starten Sie den CloudWatch Agenten neu Nachdem Sie Ihre Änderungen vorgenommen haben, starten Sie den CloudWatch Agenten neu, wie unter [ CloudWatch Agent starten](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance-fleet.html#start-CloudWatch-Agent-EC2-fleet) beschrieben.