Travailler avec l' CodeDeploy agent

2.0.1

24 août 2026

Corrigé  : sous Windows, les chemins de AppSpec fichiers commençant par une barre oblique inverse (\) ou par plusieurs séparateurs (par exemple//my-folder) sont désormais résolus dans la révision, et non à la racine du lecteur.

Pour des exemples de source valeurs prises en charge, consultezAppSpec section « fichiers » (EC2/On-Premises déploiements uniquement).

2.0.0

15 juillet 2026

Modifié  : L' CodeDeploy agent existe désormais Rust-based et est livré sous la forme d'un seul binaire natif autonome. La dépendance à l'exécution de Ruby a été supprimée. Ruby n'est plus nécessaire pour installer ou exécuter l'agent. Le comportement de l'agent est compatible avec la version 1.8.x par défaut ; les fichiers de configuration existants, la AppSpec gestion, la sémantique du cycle de vie, la disposition sur disque et les résultats du déploiement restent inchangés, sauf indication contraire ci-dessous.

Ajouté  : prise en charge étendue des systèmes d'exploitation, y compris Windows Server 2025, RHEL 10 et Ubuntu Server 26.04, ainsi que des distributions Linux supplémentaires et des variantes ARM (aarch64). Pour la liste complète des plateformes testées avec cette version, consultezSystèmes d'exploitation pris en charge par l' CodeDeploy agent.

Ajouté  : une codedeploy-agent update commande pour la mise à jour automatique des agents à la demande.

Ajouté  : un port de commande local. Il s'agit d'une interface de gestion TCP optionnelle qui écoute uniquement l'adresse de bouclage (127.0.0.1) pour interroger l'état de l'agent et injecter des commandes localement. Il est désactivé par défaut et est activé avecenable_command_port.

Modifié  : la commande de déploiement local est désormais disponiblecodedeploy-agent deploy-local. La codedeploy-local commande reste disponible pour des raisons de rétrocompatibilité. Toutes les options de commande sont préservées et les chemins locaux, Amazon S3 (s3://) et les sources de GitHub bundle sont toujours pris en charge.

Modifié  : sous Linux, l'agent est géré par une unité systemd native (codedeploy-agent.service) ; le script SysV init.d n'est plus installé. systemctlUtilisez-le pour gérer l'agent.

Modifié (sécurité)  : la vérification des certificats TLS est toujours activée et les core dumps sont désactivés par défaut.

Ajouté  : paramètres de renforcement facultatifs que vous pouvez activer pour répondre à vos propres exigences de sécurité. Chaque paramètre est désactivé par défaut et vous activez ceux que vous souhaitez individuellement. Vous pouvez rejeter les ensembles contenant des liens symboliques, des traversées de chemins ou des autorisations dangereuses ; restreindre l'environnement des hooks d'événements du cycle de vie ; et restreindre les autorisations des répertoires d'agents et des fichiers journaux. Pour obtenir la liste complète, consultez CodeDeploy référence de configuration de l'agent.

Modifié  : le script d'installation en ligne de commande est désormais écrit en Bash (anciennement Ruby). Cela nécessite l'un curl ou l'autrewget.

Modifié  : Le script d'installation de la version 2.0.x est publié sous le latestv2/ préfixe dans les compartiments régionaux. aws-codedeploy-region-identifier Le latest/ préfixe continue de servir le script d'installation de la version 1.8.x.

Modifié  : publie AWS désormais la version 2.0.x en tant que package AWSCodeDeployAgentV2 Systems Manager Distributor. Le AWSCodeDeployAgent package continue de servir la version 1.8.x.

Supprimé  : le paramètre ssl_verify_peer de configuration et les clés ProcessManager de configuration Ruby.

Important  : aucun chemin de mise à jour automatique n'existe actuellement entre la version 1.8.x et la version 2.0.0. Pour effectuer la mise à niveau vers la version 2.0.0, installez-la avec le package AWSCodeDeployAgentV2 Systems Manager Distributor ou exécutez le latestv2/install script régional manuellement. Pour obtenir des instructions, veuillez consulter Installation de l' CodeDeploy agent.

1.8.1

3 février 2026

Corrigé  : correction d'un bogue sur le terminal S3.

Ajouté  : certificat Sectigo CA à la liste Windows CA.

1.8.0

31 juillet 2025

Modifié  : mise à niveau du package Ruby vers la version 3.2 dans l' CodeDeploy agent pour Windows.

1.7.1

14 novembre 2024

Modifié  : mise à jour des dépendances pour les correctifs de sécurité.

1.7.0

6 mars 2024

Ajouté  : un paramètre :disable_imds_v1: de configuration dans le fichier de configuration de l' CodeDeploy agent. Utilisez ce paramètre pour désactiver le retour à IMDSv1 lorsque des erreurs IMDSv2 se produisent. La valeur par défaut est false (active le repli). Pour plus d'informations, consultez la référence de configuration de CodeDeploy l'agent.

Ajouté  : prise en charge du système d'exploitation Red Hat Enterprise Linux 9 (RHEL 9).

Ajouté  : support pour les versions 3.1 et 3.2 de Ruby sur Ubuntu Server.

Corrigé  : L' CodeDeploy agent génère désormais une erreur conviviale si le fichier de configuration de l' CodeDeploy agent ne se charge pas.

Modifié  : mise à niveau de Ruby vers la version 2.7.8-1 dans l' CodeDeploy agent pour Windows.

1.6.0

30 mars 2023

Ajouté  : Support pour Ruby 3.1, 3.2.

Ajouté  : support pour Amazon Linux 2023.

Ajouté  : support pour Windows Server 2022.

Modifié  : le paramètre par défaut de verbose concerne désormais false les instances Windows Server. Pour continuer à imprimer les messages de débogage dans les fichiers journaux de Windows, vous devez verbose définir true sur.

Supprimé : support pour Windows Server 2016 et Windows Server 2012 R2.

Supprimé  : support pour Amazon Linux 2018.03.x.

1.5.0

3 mars 2023

Ajouté  : Support pour Ruby 3.

Ajouté  : Support pour Ubuntu 22.04.

Corrigé  : le redémarrage de l' CodeDeploy agent peu de temps après son démarrage entraînait le blocage de l'agent.

Modifié  : l' CodeDeploy agent échoue désormais lors du déploiement d'un hôte au démarrage de l'agent si le service de l'agent redémarre de manière inattendue lors de l'exécution d'un script hook. Ce correctif vous permet d'éviter d'attendre le délai de 70 minutes avant de réessayer un déploiement.

Avis d'obsolescence  : l' CodeDeploy agent 1.5.0 est la dernière version à prendre en charge Windows Server 2016 et Windows Server 2012 R2.

Supprimé : support de l' CodeDeployagent sur Ubuntu 14.04 LTS, Windows Server 2008 R2 et Windows Server 2008 R2 32 bits.

1.4.1

6 décembre 2022

Corrigé  : faille de sécurité liée à la journalisation.

Amélioration  : amélioration de la journalisation lors de l'interrogation de la commande host.

1.4.0

31 août 2022

Ajouté  : support pour Red Hat Enterprise Linux 8.

Ajouté  : prise en charge des longs chemins de fichiers sur l' CodeDeploy agent pour Windows. Pour activer les longs chemins de fichiers, vous devez définir la clé de registre Windows appropriée, puis redémarrer votre agent. Pour de plus amples informations, veuillez consulter Les longs chemins de fichier provoquent des erreurs « Aucun fichier ou répertoire de ce type ».

Corrigé  : Un problème lié à l'opération de décompression lorsque le disque était plein. L' CodeDeploy agent détecte désormais le code de sortie 50 du dézip indiquant un disque plein, supprime les fichiers partiellement extraits et déclenche une exception pour signaler un échec au CodeDeploy serveur. Le message d'erreur est visible sous la forme d'un message d'erreur lié à un événement du cycle de vie, et le déploiement au niveau de l'hôte s'arrête sans blocage ni expiration du délai.

Corrigé  : un problème qui provoquait l'échec de l'agent.

Corrigé  : Un problème à cause duquel les crochets expiraient en cas de situation de course extrême. Les hooks sans script se poursuivront désormais et ne provoqueront plus d'échecs ni de délais d'attente.

Modifié  : le update script du bin répertoire de l' CodeDeploy agent a été supprimé car il n'est plus utilisé.

Modifié  : l' CodeDeploy agent pour Windows Server intègre désormais Ruby 2.7.

Modifié  : de nouvelles variables d'environnement ont été ajoutées, à utiliser par les scripts hook en fonction de la source du bundle de déploiement (Amazon S3 ou GitHub).

Pour de plus amples informations, veuillez consulter Disponibilité des variables d'environnement pour les hooks.

1.3.2

6 mai 2021

Corrigé  : problème lors de l'installation de l' CodeDeploy agent sur Ubuntu 20.04 et versions ultérieures.

Corrigé  : Un problème intermittent se produisait lors de l'extraction de fichiers compressés car les chemins relatifs n'étaient pas gérés correctement.

Ajouté  : support AWS PrivateLink et points de terminaison VPC pour les instances Windows.

Ajouté  : améliorations des AppSpec fichiers, comme décrit ci-dessous.

Mise à niveau  : utilise CodeDeploy désormais le AWS SDK pour Ruby 3.0.

1.3.1

22 décembre 2020

Correction  : problème de la version 1.3.0 qui empêchait les instances locales de démarrer.

1.3.0

10 novembre 2020

Corrigé  : Suppression d'un certificat expiré qui n'était plus utilisé.

Corrigé  : suppression du message d'invite du script de désinstallation de l'agent utilisé par AWS Systems Manager, ce qui facilitait la rétrogradation d'un hôte ou d'une flotte vers une version précédente de l'agent.

1.2.1

23 septembre 2020

Modifié  : AWS SDK pour Ruby dépendance améliorée de la v2 à la v3.

Ajouté  : Support pour IMDSv2. Inclut un retour silencieux vers IMDSv1 en cas d'échec des requêtes HTTP IMDSv2.

Modifié  : mise à jour des dépendances Rake et Rubyzip pour les correctifs de sécurité.

Corrigé  : Assurez-vous qu'un fichier PID vide renvoie l'état du fichier PID No CodeDeploy Agent Running et le nettoie au démarrage de l'agent.

1.1.2

4 août 2020

Ajouté  : support pour Ubuntu Server 19.10 et 20.04.

Remarque  : La version 19.10 a atteint sa date de fin de vie et n'est plus prise en charge par Ubuntu ou. CodeDeploy

Ajouté  : Améliorations de l'efficacité de la mémoire pour Linux et Ubuntu afin de libérer la mémoire réservée plus rapidement.

Ajouté  : compatibilité avec le « nettoyage silencieux » de Windows Server, qui empêchait parfois l'agent de répondre.

Ajouté  : Ignorez les répertoires non vides pendant le nettoyage pour éviter les échecs lors du déploiement.

Ajouté  : Support pour la zone AWS locale de Los Angeles (LA).

Ajouté  : extrayez AZ des métadonnées de l'instance pour assurer la compatibilité avec les zones AWS locales.

Ajouté  : Les utilisateurs peuvent désormais fournir leurs archives dans des sous-répertoires et ne sont pas tenus de les stocker dans le répertoire racine.

Ajouté  : détection d'un problème avec Rubyzip qui pourrait entraîner des fuites de mémoire. Mise à jour de la commande unzip pour essayer d'abord d'utiliser un utilitaire de décompression installé sur le système avant d'utiliser Rubyzip.

Ajouté  : :enable_auth_policy: en tant que paramètre de configuration de l'agent.

Modifié  : les avertissements de décompression sont désormais ignorés et les déploiements se poursuivront.

1.1.0

30 juin 2020

Modifié  : La gestion des versions de l' CodeDeployagent suit désormais la convention de gestion des versions standard de Ruby.

Ajouté : nouveau paramètre de commande d'installation et de mise à jour pour permettre l'installation d'une la version spécifique de l'agent à partir de la ligne de commande.

Supprimé : suppression de l' CodeDeploy agent Auto Updater pour Linux et Ubuntu. Pour configurer les mises à jour automatiques de l' CodeDeploy agent, voir Installer l' CodeDeploy agent à l'aide de AWS Systems Manager.

1.0.1.1597

15 novembre 2018

Amélioration  : CodeDeploy prend en charge Ubuntu 18.04.

Amélioration  : CodeDeploy prend en charge Ruby 2.5.

Amélioration  : CodeDeploy prend en charge les points de terminaison FIPS. Pour de plus amples informations sur les points de terminaison FIPS, veuillez consulter Présentation de FIPS 140-2. Pour les points de terminaison qui peuvent être utilisés avec CodeBuild, voir CodeDeploy Régions et points de terminaison.

1.0.1.1518

12 juin 2018

Amélioration  : correction d'un problème qui provoquait une erreur lorsque l' CodeDeploy agent était fermé alors qu'il acceptait des demandes de sondage.

Amélioration  : ajout d'une fonctionnalité de suivi des déploiements qui empêche la fermeture de l' CodeDeploy agent lorsqu'un déploiement est en cours.

Amélioration : Amélioration des performances lors de la suppression des fichiers.

1.0.1.1458

6 mars 2018

Remarque : Cette version n'est plus prise en charge. Si vous utilisez cette version, vos déploiements peuvent échouer.

Amélioration : Amélioration des validations de certificat pour prendre en charge un nombre plus important d'autorités approuvées.

Amélioration  : correction d'un problème qui provoquait l'échec de l'interface de ligne de commande locale lors d'un déploiement incluant un événement BeforeInstall du cycle de vie.

Amélioration  : correction d'un problème qui pouvait entraîner l'échec d'un déploiement actif lors de la mise à jour de l' CodeDeploy agent.

1.0.1.1352

16 novembre 2017

Remarque : Cette version n'est plus prise en charge. Si vous utilisez cette version, vos déploiements peuvent échouer.

Fonctionnalité  : introduction d'une nouvelle fonctionnalité permettant de tester et de déboguer un EC2/On-Premises déploiement sur une machine ou une instance locale sur laquelle l' CodeDeploy agent est installé.

1.0.1.1106

16 mai 2017

Remarque : Cette version n'est plus prise en charge. Si vous utilisez cette version, vos déploiements peuvent échouer.

Fonctionnalité : Introduction de la nouvelle prise en charge de la gestion des contenus dans un emplacement cible qui ne faisait pas partie de la révision de l'application depuis le déploiement réussi le plus récent. Les options de déploiement pour le contenu existant incluent désormais la conservation du contenu, le remplacement du contenu ou l'échec du déploiement.

Amélioration  : l' CodeDeploy agent a été rendu compatible avec la version 2.9.2 du AWS SDK pour Ruby (aws-sdk-core 2.9.2).

1.0.1.1095

29 mars 2017

Remarque : Cette version n'est plus prise en charge. Si vous utilisez cette version, vos déploiements peuvent échouer.

Amélioration  : prise en charge de l' CodeDeploy agent dans la région de Chine (Pékin).

Amélioration  : Puppet a été activé pour qu'il s'exécute sur des instances Windows Server lorsqu'il est invoqué par un hook d'événement du cycle de vie.

Amélioration: Amélioration de la gestion des untar opérations.

Remarque : Cette version n'est plus prise en charge. Si vous utilisez cette version, vos déploiements peuvent échouer.

Amélioration : révision de nombreux messages d'erreur afin de décrire plus précisément l'origine de l'échec du déploiement.

Amélioration  : correction d'un problème qui empêchait l' CodeDeploy agent d'identifier la révision d'application correcte à déployer lors de certains déploiements.

Amélioration : rétablissement de l'utilisation de pushd et popd avant et après l'opération untar.

Remarque : Cette version n'est plus prise en charge. Si vous utilisez cette version, vos déploiements peuvent échouer.

Amélioration  : l' CodeDeploy agent a été rendu compatible avec la version 2.6.11 du AWS SDK pour Ruby (aws-sdk-core 2.6.11).

Remarque : Cette version n'est plus prise en charge. Si vous utilisez cette version, vos déploiements peuvent échouer.

L' CodeDeploy agent pour les instances Amazon Linux, RHEL et Ubuntu Server a été mis à jour avec les modifications suivantes. Pour les instances Windows Server, la dernière version reste la 1.0.1.998.

Amélioration : l'agent peut désormais déterminer quelle version de Ruby est installée sur une instance afin de s'en servir pour appeler le script codedeploy-agent.

Remarque : Cette version n'est plus prise en charge. Si vous utilisez cette version, vos déploiements peuvent échouer.

Amélioration : suppression des modifications apportées par la version 1.0.1.1011 en raison de problèmes liés à la prise en charge du shell. Cette version de l'agent équivaut d'un point de vue fonctionnel à la version 1.0.1.998 publiée le 11 juillet 2016.

Remarque : Cette version n'est plus prise en charge. Si vous utilisez cette version, vos déploiements peuvent échouer.

L' CodeDeploy agent pour les instances Amazon Linux, RHEL et Ubuntu Server a été mis à jour avec les modifications suivantes. Pour les instances Windows Server, la dernière version reste la 1.0.1.998.

Fonctionnalité  : Ajout de la prise en charge de l'appel de l' CodeDeploy agent à l'aide du shell bash sur les systèmes d'exploitation sur lesquels le système d'initialisation systemd est utilisé.

Remarque : Cette version n'est plus prise en charge. Si vous utilisez cette version, vos déploiements peuvent échouer.

Amélioration  : correction de la prise en charge de l'exécution de l' CodeDeploy agent avec des profils utilisateur autres que root. La variable nommée USER est remplacée par CODEDEPLOY_USER pour éviter les conflits avec les variables environnementales.

Remarque : Cette version n'est plus prise en charge. Si vous utilisez cette version, vos déploiements peuvent échouer.

Fonctionnalité  : Ajout de la prise en charge de l'exécution de l' CodeDeploy agent avec des profils utilisateur autres que root.

Amélioration : Correction de la prise en charge pour spécifier le nombre de révisions d'application que vous voulez que l'agent CodeDeploy archive pour un groupe de déploiement.

Amélioration  : l' CodeDeploy agent a été rendu compatible avec la version 2.3 du AWS SDK pour Ruby (aws-sdk-core 2.3).

Amélioration  : correction de problèmes d' UTF-8 encodage lors des déploiements.

Amélioration : meilleure précision lors de l'identification des noms de processus.

Remarque : Cette version n'est plus prise en charge. Si vous utilisez cette version, vos déploiements peuvent échouer.

Fonctionnalité : Ajout de la prise en charge du serveur proxy d'installation.

Amélioration  : mise à jour du script d'installation pour ne pas télécharger l' CodeDeploy agent si la dernière version est déjà installée.

Remarque : Cette version n'est plus prise en charge. Si vous utilisez cette version, vos déploiements peuvent échouer.

Fonctionnalité : Introduction de la prise en charge pour spécifier le nombre de révisions d'application que vous voulez que l'agent CodeDeploy archive pour un groupe de déploiement.

Remarque : Cette version n'est plus prise en charge et peut entraîner l'échec des déploiements.

Amélioration  : l' CodeDeploy agent a été rendu compatible avec la version 2.2 du AWS SDK pour Ruby (aws-sdk-core 2.2). La version 2.1.2 est encore prise en charge.

Remarque : Cette version n'est plus prise en charge. Si vous utilisez cette version, vos déploiements peuvent échouer.

Fonctionnalité  : Ajout de la prise en charge de l'algorithme de SHA-256 hachage.

Fonctionnalité : Introduction de la prise en charge du suivi des versions dans les fichiers .version.

Fonctionnalité : Mise à disposition de l'ID de groupe de déploiement via l'utilisation d'une variable d'environnement.

Amélioration  : ajout de la prise en charge de la surveillance des journaux des CodeDeploy agents à l'aide d'Amazon CloudWatch Logs.