Zusammenarbeit mit dem CodeDeploy Agenten

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)

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

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

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.

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.

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

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

Behoben: Ein Problem beim Entpacken, wenn die Festplatte voll war. Der CodeDeploy Agent erkennt jetzt den Exit-Code 50 des Entpackens, 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 ü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.

1.3.2

6. Mai 2021

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 für Windows-Instances.

Hinzugefügt: AppSpec Dateiverbesserungen, wie unten beschrieben.

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

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.

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. Informationen zu Endpunkten, die mit verwendet werden können CodeBuild, finden Sie unter CodeDeploy Regionen 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 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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.