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. # Zusammenarbeit mit dem CodeDeploy Agenten **Status des Rollouts von Version 2.0.x** Version 2.0.x des CodeDeploy Agenten wird derzeit eingeführt AWS-Regionen und ist möglicherweise noch nicht in allen Regionen verfügbar. Version 2.0.0 ist ein optionales Upgrade. Informationen zur Aktualisierung von älteren Versionen auf Version 2.0.x finden Sie unter. [Installieren Sie den CodeDeploy Agenten](codedeploy-agent-operations-install.md) 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 aktiv die neueste Nebenversion des CodeDeploy Agenten. Die neueste veröffentlichte Version finden Sie unter[Versionsverlauf des Agenten CodeDeploy](#codedeploy-agent-version-history). **Anmerkung** Der CodeDeploy Agent ist nur erforderlich, wenn Sie die Bereitstellung auf einer EC2/On-Premises Rechenplattform durchführen. Der Agent ist nicht für Bereitstellungen erforderlich, die die Amazon ECS- oder AWS Lambda-Rechenplattform verwenden. Eine Konfigurationsdatei wird auf der Instance platziert, wenn der Agent installiert wird. Diese Datei wird verwendet, um festzulegen, wie der Agent arbeitet. Diese Konfigurationsdatei gibt Verzeichnispfade und andere Einstellungen AWS CodeDeploy an, die bei der Interaktion mit der Instance verwendet werden sollen. Sie können einige der Konfigurationsoptionen in der Datei ändern. Hinweise zur Arbeit mit der CodeDeploy Agenten-Konfigurationsdatei finden Sie unter[CodeDeploy Referenz zur Agentenkonfiguration](reference-agent-configuration.md). Weitere Informationen zur Arbeit mit dem CodeDeploy Agenten, z. B. Schritte zum Installieren, Aktualisieren und Überprüfen von Versionen, finden Sie unter[Verwaltung des CodeDeploy Agentenbetriebs](codedeploy-agent-operations.md). **Topics** + [Vom Agenten unterstützte Betriebssysteme 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) ## Vom Agenten unterstützte Betriebssysteme CodeDeploy ### Unterstützte Amazon EC2 AMI-Betriebssysteme Der CodeDeploy Agent wurde auf den folgenden Amazon EC2 AMI-Betriebssystemen getestet: + Amazon Linux 2023 (x86\_64, aarch64) + Amazon Linux 2 (x86\_64, aarch64) + Red Hat Enterprise Linux (RHEL) 8, 9, 10 (x86\_64, aarch64) + Oracle Linux 8, 9, 10 (x86\_64, aarch64) + Rocky Linux 9, 10 (x86\_64, aarch64) + CentOS Stream 9, 10 (x86\_64, aarch64) + SLES 15 (x86\_64, aarch64) + Debian 11, 12, 13 (x86\_64, aarch64) + Ubuntu Server 16.04 LTS, 18.04 LTS, 20.04 LTS, 22,04 LTS, 24,04 LTS, 25.04, 26,04 LTS (x86\_64, aarch64) + Windows Server 2016, 2019, 2022, 2025 (x86\_64) **Anmerkung** Die folgenden Plattformen wurden nur auf der CodeDeploy Agentenversion 2.0.x und höher getestet: Windows Server 2025, RHEL 10, Oracle Linux 8, 9, 10, Rocky Linux 9, 10, CentOS Stream 9, 10, SLES 15, Debian 11, 12, 13 und Ubuntu Server 24.04, 25.04, 26.04. Der CodeDeploy Agent ist als Open Source verfügbar, sodass Sie ihn an Ihre Bedürfnisse anpassen können. Er kann mit anderen Amazon EC2 AMI-Betriebssystemen verwendet werden. Weitere Informationen finden Sie im [ CodeDeploy ](https://github.com/aws/aws-codedeploy-agent) Agenten-Repository unter GitHub. ### Unterstützte lokale Betriebssysteme Der CodeDeploy Agent wurde auf den folgenden lokalen Betriebssystemen getestet: + Windows Server 2016, 2019, 2022, 2025 (x86\_64) + Red Hat Enterprise Linux (RHEL) 8, 9, 10 (x86\_64, aarch64) + Oracle Linux 8, 9, 10 (x86\_64, aarch64) + Rocky Linux 9, 10 (x86\_64, aarch64) + CentOS Stream 9, 10 (x86\_64, aarch64) + SLES 15 (x86\_64, aarch64) + Debian 11, 12, 13 (x86\_64, aarch64) + Ubuntu Server 16.04 LTS, 18.04 LTS, 20.04 LTS, 22,04 LTS, 24,04 LTS, 25.04, 26,04 LTS (x86\_64, aarch64) **Anmerkung** Die folgenden Plattformen wurden nur auf der CodeDeploy Agentenversion 2.0.x und höher getestet: Windows Server 2025, RHEL 10, Oracle Linux 8, 9, 10, Rocky Linux 9, 10, CentOS Stream 9, 10, SLES 15, Debian 11, 12, 13 und Ubuntu Server 24.04, 25.04, 26.04. Der CodeDeploy Agent ist als Open Source verfügbar, 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 ](https://github.com/aws/aws-codedeploy-agent) Agenten-Repository 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 [https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html) EC2-Metadaten-Endpunkt, 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 aktuelle 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 den AWS Support kontaktieren. Informationen zum Upgrade finden Sie unter[Aktualisieren Sie den Agenten CodeDeploy](codedeploy-agent-operations-update.md). **Status des Rollouts von Version 2.0.x** Version 2.0.x des CodeDeploy Agenten wird derzeit eingeführt AWS-Regionen und ist möglicherweise noch nicht in allen Regionen verfügbar. Version 2.0.0 ist ein optionales Upgrade. Informationen zur Aktualisierung von älteren Versionen auf Version 2.0.x finden Sie unter. [Installieren Sie den CodeDeploy Agenten](codedeploy-agent-operations-install.md) In der folgenden Tabelle sind alle Versionen des CodeDeploy Agenten sowie die in jeder Version enthaltenen Funktionen und Verbesserungen aufgeführt. | Version | Datum der Veröffentlichung | Details | | --- | --- | --- | | 2.0.1 | 24. August 2026 | **Problem behoben**: Unter Windows werden AppSpec Dateipfade, die mit einem umgekehrten Schrägstrich (`\`) oder mit mehr als einem Trennzeichen (z. B.`//my-folder`) beginnen, jetzt innerhalb der Revision aufgelöst, nicht im Stammverzeichnis des Laufwerks.
Beispiele für unterstützte `source` Werte finden Sie unter. [AppSpec Abschnitt „Dateien“ (nur EC2/On-Premises Bereitstellungen)](reference-appspec-file-structure-files.md) | | 2.0.0 | 15. Juli 2026 | **Geändert**: Der CodeDeploy Agent ist jetzt Rust-based und wird als einzelne eigenständige native Binärdatei ausgeliefert. Die Ruby-Laufzeitabhängigkeit wurde entfernt. Ruby ist nicht mehr erforderlich, um den Agenten zu installieren oder auszuführen. Der Agent ist standardmäßig verhaltenskompatibel mit Version 1.8.x; die vorhandenen Konfigurationsdateien, die AppSpec Handhabung, die Lifecycle-Hook-Semantik, das Festplatten-Layout und die Bereitstellungsergebnisse bleiben unverändert, sofern unten nichts anderes angegeben ist.
**Hinzugefügt**: Erweiterte Betriebssystemunterstützung, einschließlich Windows Server 2025, RHEL 10 und Ubuntu Server 26.04, sowie zusätzlicher Linux-Distributionen und ARM-Varianten (aarch64). Eine vollständige Liste der mit dieser Version getesteten Plattformen finden Sie unter. [Vom Agenten unterstützte Betriebssysteme CodeDeploy](#codedeploy-agent-supported-operating-systems)
**Hinzugefügt**: Ein `codedeploy-agent update` Befehl für die Selbstaktualisierung von Agenten auf Abruf.
**Hinzugefügt**: Ein lokaler Befehls-Port. Dies ist eine optionale TCP-Verwaltungsschnittstelle, die nur die Loopback-Adresse (127.0.0.1) abhört, um den Agentenstatus abzufragen und Befehle lokal einzufügen. Sie ist standardmäßig deaktiviert und ist aktiviert mit. `enable_command_port`
**Geändert**: Der lokale Bereitstellungsbefehl ist jetzt`codedeploy-agent deploy-local`. Der `codedeploy-local` Befehl bleibt aus Gründen der Abwärtskompatibilität verfügbar. Alle Befehlsoptionen werden beibehalten, und lokale Pfade, Amazon S3 (`s3://`) und GitHub Bundle-Quellen werden weiterhin unterstützt.
**Geändert**: Unter Linux wird der Agent von einer nativen Systemd-Unit (`codedeploy-agent.service`) verwaltet; das SysV-init.d-Skript ist nicht mehr installiert. Wird verwendet, um den Agenten `systemctl` zu verwalten.
**Geändert (Sicherheit)**: Die TLS-Zertifikatsüberprüfung ist immer aktiviert und Core-Dumps sind standardmäßig deaktiviert.
**Hinzugefügt**: Optionale Hardening-Einstellungen, die Sie aktivieren können, um Ihre eigenen Sicherheitsanforderungen zu erfüllen. Jede Einstellung ist standardmäßig deaktiviert, und Sie aktivieren die gewünschten Einstellungen einzeln. Sie können Pakete ablehnen, die symbolische Links, Pfaddurchquerung oder unsichere Berechtigungen enthalten, die Umgebung von Lifecycle-Event-Hooks einschränken und die Berechtigungen von Agentenverzeichnissen und Protokolldateien einschränken. Eine vollständige Liste finden Sie unter [CodeDeploy Referenz zur Agentenkonfiguration](reference-agent-configuration.md).
**Geändert**: Das Befehlszeilen-Installationsskript ist jetzt in Bash (zuvor Ruby) geschrieben. Es erfordert entweder oder. `curl` `wget`
**Geändert**: Das Installationsskript für Version 2.0.x wird unter dem `latestv2/` Präfix in den regionalen `aws-codedeploy-{{region-identifier}}` Buckets veröffentlicht. Das `latest/` Präfix dient weiterhin dem Installationsskript der Version 1.8.x.
**Geändert**: veröffentlicht AWS jetzt Version 2.0.x als `AWSCodeDeployAgentV2` Systems Manager Distributor-Paket. Das `AWSCodeDeployAgent` Paket unterstützt weiterhin Version 1.8.x.
**Entfernt**: Die `ssl_verify_peer` Konfigurationseinstellung und die ProcessManager Ruby-Konfigurationsschlüssel.
**Wichtig**: Derzeit gibt es keinen automatischen Aktualisierungspfad von Version 1.8.x auf 2.0.0. Um auf 2.0.0 zu aktualisieren, installieren Sie es mit dem `AWSCodeDeployAgentV2` Systems Manager Distributor-Paket oder führen Sie das regionale Skript manuell aus. `latestv2/install` Detaillierte Anweisungen finden Sie unter [Installieren Sie den CodeDeploy Agenten](codedeploy-agent-operations-install.md). | | 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 im Paket enthaltene Ruby wurde im CodeDeploy Agenten für Windows auf Version 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 das Fallback auf IMDSv1 zu deaktivieren, wenn IMDSv2-Fehler auftreten. Die Standardeinstellung ist (Fallback aktivieren). `false` Weitere Informationen finden Sie in der Referenz zur [ CodeDeploy Agentenkonfiguration. ](https://docs.aws.amazon.com/codedeploy/latest/userguide/reference-agent-configuration.html)
**Hinzugefügt**: Unterstützung für das Betriebssystem Red Hat Enterprise Linux 9 (RHEL 9).
**Hinzugefügt**: Unterstützung für Ruby-Versionen 3.1 und 3.2 auf Ubuntu Server.
**Problem 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**: Unterstützung für Ruby 3.1, 3.2.
**Hinzugefügt**: Unterstützung für Amazon Linux 2023.
**Hinzugefügt**: Unterstützung für Windows Server 2022.
**Geändert**: Die Standardeinstellung von `verbose` gilt jetzt `false` für Windows Server-Instanzen. Um unter Windows weiterhin Debug-Meldungen in Protokolldateien zu drucken, müssen Sie `verbose` auf setzen`true`.
**Entfernt**: Unterstützung für Windows Server 2016 und Windows Server 2012 R2.
**Entfernt**: Unterstützung für Amazon Linux 2018.03.x. | | 1.5.0 | 03. März 2023 | **Hinzugefügt**: Unterstützung für Ruby 3.
**Hinzugefügt**: Unterstützung 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 beim Start des Agenten bei der Hostbereitstellung fehl, wenn der Agentendienst unerwartet neu gestartet wird, während ein Hook-Skript ausgeführt wird. Mit diesem Fix können Sie vermeiden, das Zeitlimit von 70 Minuten abzuwarten, bevor Sie eine Bereitstellung erneut versuchen.
**Hinweis als veraltet**: CodeDeploy Agent 1.5.0 ist die letzte Version, die Windows Server 2016 und Windows Server 2012 R2 unterstützt.
**Entfernt: ** Unterstützung 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.
**Erweiterung**: Verbesserte Protokollierung bei der Abfrage des Host-Befehls. | | 1.4.0 | 31. August 2022 | **Hinzugefügt**: Unterstützung für Red Hat Enterprise Linux 8.
**Hinzugefügt**: Unterstützung 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 des Entpackens, der ](https://linux.die.net/man/1/unzip) 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 über ein Lebenszyklusereignis sichtbar, und die Bereitstellung auf Host-Ebene wird beendet, ohne dass es zu einem Stillstand kommt oder es zu einem Timeout kommt.
**Behoben**: Ein Problem, das zum Ausfall des Agenten führen würde.
**Behoben**: Ein Problem, bei dem Hooks während eines Rennens im Edge-Case-Modus zu einem Timeout kamen. Hooks ohne Skripte laufen jetzt weiter und führen nicht mehr zu Ausfällen oder Timeouts.
**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 enthält jetzt Ruby 2.7.
**Geändert**: Es wurden neue Umgebungsvariablen 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). **Hinweis als veraltet**: CodeDeploy Agent 1.4.0 ist die letzte Version, die Installationsprogramme für 32-Bit-Windows Server enthalten wird.
**Hinweis als veraltet**: CodeDeploy Agent 1.4.0 ist die letzte Version, die Windows Server 2008 R2 unterstützt.
**Entfernt**: Unterstützung für den CodeDeploy Agenten auf den 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-Adressen, die sich auf Windows-Hosts auswirken, auf denen der Agent ausgeführt wird. [ CVE-2018-1000201 ](https://nvd.nist.gov/vuln/detail/CVE-2018-1000201) Die CVE zitiert ruby-ffi, eine Abhängigkeit des Agenten. CodeDeploy Wenn Ihr Agent mit Amazon EC2 Systems Manager (SSM) installiert wurde und so eingestellt ist, dass er automatisch aktualisiert wird, sind keine Maßnahmen erforderlich. Andernfalls ist eine Aktion erforderlich, um den Agenten manuell zu aktualisieren. Um den Agenten zu [ aktualisieren, folgen Sie den Anweisungen unter CodeDeploy Agent 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**: Unterstützung 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.+ Sie können jetzt einen benutzerdefinierten Dateinamen für die AppSpec Datei angeben, wenn Sie eine lokale Bereitstellung erstellen. Weitere Informationen finden Sie unter [Erstellen Sie eine lokale Bereitstellung](deployments-local.md#deployments-local-deploy).
+ Die AppSpec Datei kann jetzt eine `.yaml` Dateierweiterung haben.
+ Sie können jetzt bereitgestellte Dateien mit einer neuen, optionalen `file_exists_behavior` Einstellung in der AppSpec Datei überschreiben. Weitere Informationen finden Sie unter [AppSpec Abschnitt „Dateien“ (nur EC2/On-Premises Bereitstellungen)](reference-appspec-file-structure-files.md).
**Aktualisiert**: verwendet CodeDeploy jetzt das AWS SDK für Ruby 3.0. | | 1.3.1 | 22. Dezember 2020 | **Behoben**: 1.3.0-Problem, das das Starten von lokalen Instanzen verhinderte. | | 1.3.0 | 10. November 2020 | Diese Version ist veraltet. **Problem behoben**: Ein abgelaufenes Zertifikat wurde entfernt, das nicht mehr verwendet wurde.
**Problem behoben**: Die Aufforderungsmeldung aus dem von verwendeten Agenten-Deinstallationsskript wurde entfernt. Dadurch ist es einfacher AWS Systems Manager, 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 v2 auf v3 aktualisiert.
**Hinzugefügt**: Unterstützung für IMDSv2. Beinhaltet ein automatisches Fallback auf IMDSv1, falls IMDSv2-HTTP-Anfragen fehlschlagen.
**Geändert**: Die Abhängigkeiten von Rake und Rubyzip für Sicherheitspatches wurden aktualisiert.
**Problem behoben**: Stellen Sie sicher, dass eine leere PID-Datei den Status von zurückgibt, `No CodeDeploy Agent Running` und bereinigen Sie die PID-Datei beim Start des Agenten. | | 1.1.2 | 4. August 2020 | **Hinzugefügt**: Unterstützung für Ubuntu Server 19.10 und 20.04.
**Hinweis**: Version 19.10 hat ihr Enddatum erreicht und wird von Ubuntu oder nicht mehr unterstützt. CodeDeploy
**Hinzugefügt**: Verbesserungen der Speichereffizienz für Linux und Ubuntu, um reservierten Speicher schneller freizugeben.
**Hinzugefügt**: Kompatibilität mit der „automatischen Säuberung“ von Windows Server, was in einigen Fällen dazu führte, dass der Agent nicht reagierte.
**Hinzugefügt**: Ignoriere nicht leere Verzeichnisse während der Bereinigung, um Fehler bei der Bereitstellung zu vermeiden.
**Hinzugefügt**: Unterstützung für AWS Local Zone in Los Angeles (LA).
**Hinzugefügt**: Extrahieren Sie AZ aus Instanz-Metadaten, um die Kompatibilität für AWS lokale Zonen 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 erkannt, das zu Speicherlecks führen könnte. Der Befehl unzip wurde aktualisiert, sodass zuerst versucht wird, ein vom System installiertes Unzip-Programm zu verwenden, bevor Rubyzip verwendet wird.
**Hinzugefügt**: `:enable_auth_policy:` als Agentenkonfigurationseinstellung.
**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 CodeDeploy Agent Auto Updater für Linux und Ubuntu wurde entfernt. Informationen zur Konfiguration der automatischen Updates des CodeDeploy Agenten finden [ Sie unter Installieren Sie den 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.
**Erweiterung**: 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 [ CodeDeploy Regionen und Endpunkte. ](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) | | 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 annahm.
**Verbesserung**: Es wurde eine Funktion zur Nachverfolgung von Bereitstellungen hinzugefügt, die verhindert, dass der CodeDeploy Agent geschlossen wird, während eine Bereitstellung im Gange ist.
**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, ausfiel.
**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 lokalen 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.
**Erweiterung**: Der CodeDeploy Agent wurde mit Version 2.9.2 von AWS SDK für Ruby (aws-sdk-core 2.9.2) kompatibel gemacht. | | 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.
**Erweiterung**: Unterstützung für den CodeDeploy Agenten in der Region China (Peking) eingeführt.
**Verbesserung**: Puppet kann jetzt 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 ermitteln konnte, die bereitgestellt werden sollte.
**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-core 2.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.Erweiterung: Unterstützung für alle Versionen von Ruby 2.x im Agenten und im CodeDeploy Agent-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 Agenteninstallationsprogramms 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.
**Erweiterung**: Der CodeDeploy Agent wurde mit Version 2.3 von AWS SDK für Ruby (aws-sdk-core 2.3) kompatibel gemacht.
**Verbesserung**: Probleme mit UTF-8 der Kodierung bei Bereitstellungen wurden behoben.
**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.
**Erweiterung**: 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.
**Feature**: Unterstützung für den SHA-256 Hash-Algorithmus eingeführt.
**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 hinzugefügt](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatchLogs.html). | 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 Der CodeDeploy Agent verwendet [ systemd](https://systemd.io/), um den Agentenprozess auf allen unterstützten Linux-Distributionen zu verwalten. Für Version 2.0.x und höher liefert der Agent nur eine native systemd-Unit () aus. `codedeploy-agent.service` Es gibt kein Skript. `/etc/init.d/codedeploy-agent` Wird verwendet, `systemctl` um den Agenten zu verwalten, oder um die Binärdatei direkt mit den `start` `status` Unterbefehlen, `stop``restart`, oder aufzurufen. Für Version 1.8.x und frühere Versionen werden sowohl die rpm- als auch die deb-Distribution mit Startskripten unter ausgeliefert. `/etc/init.d/codedeploy-agent` Auf Systemen, die Systemd unterstützen, kann die Verwendung des `service` Befehls versehentlich die init.d-Skripte ausführen, anstatt Systemd zu erlauben, den Prozess zu verwalten. Wird für Agentenoperationen verwendet, um dieses `systemctl` Problem zu vermeiden. Verwenden Sie das folgende `systemctl` Hilfsprogramm, um den CodeDeploy Agenten zu verwalten: ``` sudo systemctl start codedeploy-agent sudo systemctl stop codedeploy-agent sudo systemctl restart codedeploy-agent sudo systemctl status codedeploy-agent ``` ## 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\_revisions**: ** in der Agentenkonfigurationsdatei verwenden, um die Anzahl der zu archivierenden Anwendungsrevisionen anzugeben, indem Sie eine positive Ganzzahl eingeben. 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 wird, werden die fünf neuesten Revisionen zusätzlich zur aktuell bereitgestellten Revision CodeDeploy beibehalten. **CodeDeploy Protokolle**: Für Amazon Linux-, Ubuntu Server- und RHEL-Instances rotiert der CodeDeploy Agent die Protokolldateien unter dem Ordner. `/var/log/aws/codedeploy-agent` Die Protokolldatei wird täglich um 00:00:00 (Instanzzeit) rotiert, oder wenn die Datei 64 MB erreicht, je nachdem, was zuerst eintritt. Wenn am selben Tag eine zweite Rotation stattfindet, hängt der Agent ein numerisches Suffix an (z. B.). `codedeploy-agent.20260715.1.log` Der Agent löscht die Protokolldateien nach sieben Tagen. Das Benennungsmuster für rotierte Protokolldateien ist `codedeploy-agent.{{YYYYMMDD}}.log`. ## Vom Agenten installierte Dateien CodeDeploy Der CodeDeploy Agent speichert Revisionen, den Bereitstellungsverlauf und die Bereitstellungsskripts in seinem Stammverzeichnis auf einer Instance. 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\_dir in der CodeDeploy Agentenkonfigurationsdatei 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. Sie können den [ Befehl ](https://docs.aws.amazon.com/cli/latest/reference/deploy/batch-get-deployments.html) batch-get-deployments verwenden, um eine Bereitstellungsgruppen-ID zu 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. Diese Datei listet die Ausgabe aller in der Bereitstellungsdatei angegebenen Skripts auf. AppSpec Wenn Sie den Ordner für eine Bereitstellung finden möchten, aber dessen Bereitstellungs-ID 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\_revisions 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\_revisions** auf eine niedrige Zahl, etwa 1 oder 2. Bei der nächsten Bereitstellung werden archivierte Bereitstellungen gelöscht, sodass die Anzahl der von Ihnen angegebenen Anzahl 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`. + **[Bereitstellungsgruppen-ID] \_last\_successful\_install**, 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` und welche `BeforeInstall` Skripts ausgeführt werden sollen. Der Dateiname lautet z. B. `acde1916-9099-7caf-fd21-012345abcdef_last_successful_install`. + **[Deployment Group ID]\_most\_recent\_install**, 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-Gruppen-ID] \_last\_successful\_install-Datei wird nach dieser Datei erstellt, wenn die heruntergeladenen Dateien an ihr endgültiges 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 von `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 `codedeploy-agent-deployments.log` die maximale Größe erreicht ist, schreibt der CodeDeploy Agent weiter in die Datei und löscht gleichzeitig alte Inhalte.