Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Travailler avec l' CodeDeploy agent L' AWS CodeDeploy agent est un progiciel qui, une fois installé et configuré sur une instance, permet à cette instance d'être utilisée dans CodeDeploy des déploiements. AWS prend en charge la dernière version mineure de l' CodeDeploy agent. Actuellement, la dernière version mineure est 1.8.x. **Note** L' CodeDeploy agent n'est requis que si vous déployez sur une plate-forme informatique EC2/sur site. L'agent n'est pas requis pour les déploiements qui utilisent la plateforme de calcul Amazon ECS ou AWS Lambda. Un fichier de configuration est placé sur l'instance lorsque l'agent ∿ est installé. Ce fichier est utilisé pour spécifier la manière dont l'agent fonctionne. Ce fichier de configuration spécifie les chemins de répertoire et les autres paramètres AWS CodeDeploy à utiliser lorsqu'il interagit avec l'instance. Vous pouvez modifier certaines options de configuration dans ce fichier. Pour plus d'informations sur l'utilisation du fichier de configuration de l' CodeDeploy agent, consultez[CodeDeploy référence de configuration de l'agent](reference-agent-configuration.md). Pour plus d'informations sur l'utilisation de l' CodeDeploy agent, telles que les étapes d'installation, de mise à jour et de vérification des versions, consultez[Gestion des opérations des CodeDeploy agents](codedeploy-agent-operations.md). **Topics** + [Systèmes d'exploitation pris en charge par l' CodeDeploy agent](#codedeploy-agent-supported-operating-systems) + [Protocole de communication et port pour l' CodeDeploy agent](#codedeploy-agent-outbound-port) + [Historique des versions de l' CodeDeploy agent](#codedeploy-agent-version-history) + [Gérer le CodeDeploy processus](#codedeploy-agent-processes) + [Révision de l'application et nettoyage des fichiers journaux](#codedeploy-agent-revisions-logs-cleanup) + [Fichiers installés par l' CodeDeploy agent](#codedeploy-agent-install-files) + [Gestion des opérations des CodeDeploy agents](codedeploy-agent-operations.md) ## Systèmes d'exploitation pris en charge par l' CodeDeploy agent ### Systèmes d'exploitation Amazon EC2 AMI pris en charge L' CodeDeploy agent a été testé sur les systèmes d'exploitation Amazon EC2 AMI suivants : + Amazon Linux 2023 (ARM, x86) + Amazon Linux 2 (ARM, x86) + Microsoft Windows Server 2022, 2019 + Red Hat Enterprise Linux (RHEL) 9.x, 8.x, 7.x + Serveur Ubuntu 22,04 LTS, 20,04 LTS, 18,04 LTS, 16,04 LTS L' CodeDeploy agent est disponible en open source pour que vous puissiez l'adapter à vos besoins. Il peut être utilisé avec d'autres systèmes d'exploitation AMI Amazon EC2. Pour plus d'informations, accédez au référentiel des [CodeDeploy agents](https://github.com/aws/aws-codedeploy-agent) dans GitHub. ### Systèmes d'exploitation sur site pris en charge L' CodeDeploy agent a été testé sur les systèmes d'exploitation locaux suivants : + Microsoft Windows Server 2022, 2019 + Red Hat Enterprise Linux (RHEL) 9.x, 8.x, 7.x + Serveur Ubuntu 22.04 LTS, 20.04 LTS L' CodeDeploy agent est disponible en open source pour que vous puissiez l'adapter à vos besoins. Il peut être utilisé avec d'autres systèmes d'exploitation d'instance sur site. Pour plus d'informations, accédez au référentiel des [CodeDeploy agents](https://github.com/aws/aws-codedeploy-agent) dans GitHub. ## Protocole de communication et port pour l' CodeDeploy agent L' CodeDeploy agent communique avec le trafic sortant via le protocole HTTPS via le port 443. Lorsque l' CodeDeploy agent s'exécute sur une instance EC2, il utilise le point de terminaison des [métadonnées EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html) pour récupérer les informations relatives à l'instance. Découvrez-en plus sur la [limitation et l'octroi de l'accès au service des métadonnées d'instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html#instance-metadata-limiting-access). ## Historique des versions de l' CodeDeploy agent Vos instances doivent exécuter une version prise en charge de l' CodeDeploy agent. La version minimale actuellement prise en charge est 1.8.x. **Note** Nous vous recommandons d'utiliser la dernière version de l' CodeDeploy agent. Si vous rencontrez des problèmes, effectuez la mise à jour vers la dernière version avant de contacter le AWS Support. Pour plus d'informations sur la mise à niveau, consultez[Mettre à jour l' CodeDeploy agent](codedeploy-agent-operations-update.md). Le tableau suivant répertorie toutes les versions de l' CodeDeploy agent ainsi que les fonctionnalités et améliorations incluses dans chaque version. | Version | Date de publication | Détails | | --- | --- | --- | | 1.8.1 | 3 février 2026 | **Corrigé** : correction du bogue du point de terminaison S3. **Ajouté** : certificat Sectigo CA à la liste des autorités de certification Windows. | | 1.8.0 | 31 juillet 2025 | **Modifié** : mise à niveau du Ruby intégré vers la version 3.2 dans l' CodeDeploy agent pour Windows. | | 1.7.1 | 14 novembre 2024 | **Modifié : dépendances mises à jour 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 la fonction de secours IMDSv1 lorsque des IMDSv2 erreurs 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](https://docs.aws.amazon.com/codedeploy/latest/userguide/reference-agent-configuration.html). **Ajouté** : Support pour le 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 parvient pas à se charger. **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` est désormais `false` pour les instances Windows Server. Pour continuer à imprimer les messages de débogage dans les fichiers journaux sous 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 après le démarrage entraînait son blocage. **Modifié** : L' CodeDeploy agent échoue désormais au déploiement d'un hôte au démarrage de l'agent si le service de l'agent redémarre de façon inattendue lors de l'exécution d'un script hook. Ce correctif vous permet d'éviter d'attendre le délai d'expiration de 70 minutes avant de réessayer un déploiement. **Avis d'obsolescence** : CodeDeploy l'agent 1.5.0 est la dernière version compatible avec 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é** : vulnérabilité de sécurité liée à la journalisation. **Amélioration : amélioration** de la journalisation lors de l'interrogation de la commande hôte. | | 1.4.0 | 31 août 2022 | **Ajouté** : Support pour Red Hat Enterprise Linux 8. **Ajouté** : Support pour les longs chemins de fichiers sur l' CodeDeploy agent pour Windows. Pour activer les longs chemins de fichier, 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 »](troubleshooting-deployments.md#troubleshooting-long-file-paths). **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](https://linux.die.net/man/1/unzip) du dézip indiquant un disque plein, supprime les fichiers partiellement extraits et déclenche une exception pour signaler une défaillance 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 être bloqué ni expiration du délai imparti. **Corrigé** : un problème qui provoquait l'échec de l'agent. **Corrigé** : problème à cause duquel les hameçons expiraient en cas de course difficile. 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, destinées à être utilisées 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](reference-appspec-file-structure-hooks.md#reference-appspec-file-structure-environment-variable-availability). **Avis d'obsolescence** : l' CodeDeployagent 1.4.0 est la dernière version qui inclura des programmes d'installation pour Windows Server 32 bits. **Avis d'obsolescence** : CodeDeploy l'agent 1.4.0 est la dernière version compatible avec Windows Server 2008 R2. **Supprimé** : Support de l' CodeDeploy agent sur les Amazon EC2 suivants : AMIs Amazon Linux 2014.09, 2016.03, 2016.09 et 2017.03. | | 1.3.2 | 6 mai 2021 | CodeDeploy l'agent 1.3.2 résout le problème [CVE-2018-1000201](https://nvd.nist.gov/vuln/detail/CVE-2018-1000201) qui affecte les hôtes Windows exécutant l'agent. Le CVE cite ruby-ffi, qui est une dépendance de l'agent. CodeDeploy Si votre agent a été installé avec Amazon EC2 Systems Manager (SSM) et qu'il est configuré pour être mis à jour automatiquement, aucune action n'est requise. Dans le cas contraire, une action est requise pour mettre à jour manuellement l'agent. Pour mettre à niveau l'agent, suivez les instructions de [la section Mettre à jour l' CodeDeploy agent sous Windows Server](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-update-windows.html). **Corrigé** : problème lors de l'installation de l' CodeDeploy agent sur Ubuntu 20.04 et versions ultérieures. **Corrigé** : un problème intermittent survenait 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](https://docs.aws.amazon.com//vpc/latest/userguide/endpoint-services-overview.html). **Ajouté** : améliorations des AppSpec fichiers, comme décrit ci-dessous. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/codedeploy/latest/userguide/codedeploy-agent.html) **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 le démarrage des instances locales. | | 1.3.0 | 10 novembre 2020 | Cette version est obsolète. **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 facilite le rétrogradation d'un hôte ou d'un parc 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 une solution de secours silencieuse en IMDSv1 cas d'échec des requêtes IMDSv2 HTTP. **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 de `No CodeDeploy Agent Running` et nettoie le fichier PID 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 end-of-life date limite 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 l'agent de répondre dans certains cas. **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 l'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é** : Un problème avec Rubyzip susceptible d'entraîner des fuites de mémoire a été détecté. 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, les déploiements se poursuivront donc. | | 1.1.0 | 30 juin 2020 | **Modifié** : la gestion des versions de l' CodeDeployagent suit désormais la convention de version 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](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html) de AWS Systems Manager. | | 1.0.1.1597 | 15 novembre 2018 | **Amélioration** : CodeDeploy supporte Ubuntu 18.04. **Amélioration** : CodeDeploy supporte 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](https://aws.amazon.com/compliance/fips/). Pour les points de terminaison pouvant être utilisés avec CodeBuild, voir [CodeDeployRégions et points de terminaison](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region). | | 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 du déploiement 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 la CLI 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 déploiement EC2/sur site 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** : rendu l' CodeDeploy agent compatible avec la version 2.9.2 du AWS SDK pour Ruby (aws-sdk-core2.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** : introduction du support pour 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énements du cycle de vie. **Amélioration**: Amélioration de la gestion des `untar` opérations. | | 1.0.1.1067 | 6 janvier 2017 | **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`. | | 1.0.1.1045 | 21 novembre 2016 | **Remarque** : Cette version n'est plus prise en charge. Si vous utilisez cette version, vos déploiements peuvent échouer. **Amélioration** : rendu l' CodeDeploy agent compatible avec la version 2.6.11 du AWS SDK pour Ruby (aws-sdk-core2.6.11). | | 1.0.1.1037 | 19 octobre 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 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`. | | 1.0.1.1011.1 | 17 août 2016 | **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. | | 1.0.1.1011 | 15 août 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 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é.Amélioration : prise en charge de toutes les versions de Ruby 2.x dans l' CodeDeploy agent et dans le programme de mise à jour de l' CodeDeploy agent. Les CodeDeploy agents mis à jour ne dépendent plus uniquement de Ruby 2.0. (Ruby 2.0 est toujours requis pour les versions deb et rpm du programme d'installation de l' CodeDeploy agent.) | | 1.0.1.998 | 11 juillet 2016 | **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. | | 1.0.1.966 | 16 juin 2016 | **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** : rendu l' CodeDeploy agent compatible avec la version 2.3 du AWS SDK pour Ruby (aws-sdk-core 2.3). **Amélioration** : Correction des problèmes liés à l'encodage UTF-8 au cours des déploiements. **Amélioration** : meilleure précision lors de l'identification des noms de processus. | | 1.0.1.950 | 24 mars 2016 | **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** : le script d'installation a été mis à jour afin de ne pas télécharger l' CodeDeploy agent si la dernière version est déjà installée. | | 1.0.1.934 | 11 février 2016 | **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. | | 1.0.1.880 | 11 janvier 2016 | **Remarque** : Cette version n'est plus prise en charge et peut entraîner l'échec des déploiements. **Amélioration** : rendu l' CodeDeploy agent 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. | | 1.0.1.854 | 17 novembre 2015 | **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 l'algorithme de hachage SHA-256. **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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatchLogs.html). | Pour obtenir des informations connexes, consultez les ressources suivantes : + [Déterminer la version de l' CodeDeploy agent](codedeploy-agent-operations-version.md) + [Installation de l' CodeDeploy agent](codedeploy-agent-operations-install.md) Pour un historique des versions de l' CodeDeploy agent, consultez le [référentiel des versions sur GitHub](https://github.com/aws/aws-codedeploy-agent/releases). ## Gérer le CodeDeploy processus Toutes les distributions Linux de l' CodeDeploy agent (rpm et deb) utilisent [systemd](https://systemd.io/) par défaut pour gérer le processus de l'agent. Cependant, les distributions rpm et deb sont fournies avec des scripts de démarrage résidant à l'adresse`/etc/init.d/codedeploy-agent`. Selon la distribution que vous utilisez, lorsque vous utilisez une commande telle que`sudo service codedeploy-agent restart`, les scripts `/etc/init.d` peuvent être exécutés pour lancer le processus de l'agent au lieu d'`systemd`autoriser la gestion du processus. `/etc/init.d`Il n'est pas souhaitable d'exécuter des scripts sur. Pour éviter ce problème, pour les systèmes compatibles, `systemd` nous recommandons d'utiliser l'`systemctl`utilitaire pour toutes les opérations de l'agent au lieu d'utiliser la `service` commande. Par exemple, pour redémarrer l' CodeDeploy agent, utilisez `sudo systemctl restart codedeploy-agent` au lieu de la commande équivalente avec l'`service`utilitaire. ## Révision de l'application et nettoyage des fichiers journaux L' CodeDeploy agent archive les révisions et les fichiers journaux sur les instances. L' CodeDeploy agent nettoie ces artefacts pour économiser de l'espace disque. **Journaux de déploiement des révisions d'applications** : vous pouvez utiliser l'option:max\$1revisions **:** dans le fichier de configuration de l'agent pour spécifier le nombre de révisions d'applications à archiver en saisissant un entier positif. CodeDeploy archive également les fichiers journaux de ces révisions. Tous les autres sont supprimés, à l'exception du fichier journal du dernier déploiement réussi. Ce fichier journal est toujours conservé, même si le nombre de déploiements ayant échoué dépasse le nombre de révisions conservées. Si aucune valeur n'est spécifiée, CodeDeploy conserve les cinq révisions les plus récentes en plus de la révision actuellement déployée. **CodeDeploy journaux** : pour les instances Amazon Linux, Ubuntu Server et RHEL, l' CodeDeploy agent fait pivoter les fichiers journaux sous le `/var/log/aws/codedeploy-agent` dossier. Le fichier journal est permuté tous les jours à 00:00:00 (heure de l'instance). Les fichiers journaux sont supprimés après sept jours. Le modèle d'affectation de noms des fichiers journaux permutés est `codedeploy-agent.YYYYMMDD.log`. ## Fichiers installés par l' CodeDeploy agent L' CodeDeploy agent stocke les révisions, l'historique des déploiements et les scripts de déploiement dans son répertoire racine sur une instance. Le nom et l'emplacement par défaut de cet annuaire sont : `'/opt/codedeploy-agent/deployment-root'`pour les instances Amazon Linux, Ubuntu Server et RHEL. `'C:\ProgramData\Amazon\CodeDeploy'`pour les instances de Windows Server. Vous pouvez utiliser le paramètre **root\$1dir** dans le fichier de configuration de l' CodeDeploy agent pour configurer le nom et l'emplacement du répertoire. Pour de plus amples informations, veuillez consulter [CodeDeploy référence de configuration de l'agent](reference-agent-configuration.md). Ci-dessous figure un exemple de la structure du fichier et de l'annuaire sous l'annuaire racine. La structure suppose qu'il existe un nombre N de groupes de déploiement et que chaque groupe de déploiement comprend N déploiements. ``` |--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 ``` + Les dossiers relatifs aux **ID de groupes de déploiement** représentent chacun de vos groupes de déploiement. Le nom d'un annuaire de groupes de déploiement est son ID (par exemple, `acde1916-9099-7caf-fd21-012345abcdef`). Un annuaire de groupe de déploiement abrite un sous-annuaire pour chaque tentative de déploiement dans ce groupe. Vous pouvez utiliser la commande [batch-get-deployments](https://docs.aws.amazon.com/cli/latest/reference/deploy/batch-get-deployments.html) pour rechercher un ID de groupe de déploiement. + Les dossiers relatifs aux **ID de déploiement** représentent chacun des déploiements d'un groupe. Le nom d'un annuaire de déploiement est son ID. Chaque dossier contient les éléments suivants : + **bundle.tar**, un fichier compressé hébergeant le contenu de la révision de déploiement. Utilisez un utilitaire de décompression zip si vous souhaitez afficher la révision. + **deployment-archive**, un annuaire comportant le contenu de la révision de déploiement. + **logs**, un annuaire contenant un fichier `scripts.log`. Ce fichier répertorie les résultats de tous les scripts spécifiés dans le AppSpec fichier de déploiement. Si vous souhaitez rechercher le dossier d'un déploiement mais que vous ne connaissez pas son ID de déploiement ou son ID de groupe de déploiement, vous pouvez utiliser la [AWS CodeDeploy console](https://console.aws.amazon.com/codedeploy) ou le AWS CLI pour les trouver. Pour de plus amples informations, veuillez consulter [Afficher les détails CodeDeploy du déploiement](deployments-view-details.md). Le nombre maximal par défaut de déploiements pouvant être archivés dans un groupe de déploiements est cinq. Lorsque ce nombre est atteint, les déploiements ultérieurs écrasent l'archive la plus ancienne. Vous pouvez utiliser le paramètre **max\$1revisions** dans le fichier de configuration de l' CodeDeploy agent pour modifier la valeur par défaut. Pour de plus amples informations, veuillez consulter [CodeDeploy référence de configuration de l'agent](reference-agent-configuration.md). **Note** SI vous souhaitez récupérer de l'espace de disque dur utilisé par les déploiements archivés, mettez à jour le paramètre **max\$1revisions** sur une valeur plus faible, comme 1 ou 2. Le prochain déploiement écrasant les déploiements archivés, le nombre est égal à la valeur spécifiée. + **deployment-instructions** comporte quatre fichiers texte pour chacun des groupes de déploiement : + **[Deployment Group ID]-cleanup**, un fichier texte avec une version d'annulation de chaque commande exécutée durant un déploiement. Comme nom de fichier, citons par exemple `acde1916-9099-7caf-fd21-012345abcdef-cleanup`. + **[Deployment Group ID]-install.json**, un fichier JSON créé durant le déploiement le plus récent. Il contient les commandes exécutées durant le déploiement. Comme nom de fichier, citons par exemple `acde1916-9099-7caf-fd21-012345abcdef-install.json`. + **[Deployment Group ID]\$1last\$1successfull\$1install**, un fichier texte répertoriant l'annuaire d'archivage du dernier déploiement réussi. Ce fichier est créé lorsque l' CodeDeploy agent a copié tous les fichiers de l'application de déploiement sur l'instance. Il est utilisé par l' CodeDeploy agent lors du prochain déploiement pour déterminer les `BeforeInstall` scripts `ApplicationStop` et les scripts à exécuter. Comme nom de fichier, citons par exemple `acde1916-9099-7caf-fd21-012345abcdef_last_successfull_install`. + **[Deployment Group ID]\$1most\$1recent\$1install**, un fichier texte qui répertorie le nom de l'annuaire d'archivage du déploiement le plus récent. Ce fichier est créé une fois que les fichiers du déploiement ont été téléchargés. Le fichier [deployment group ID]\$1last\$1successfull\$1install file est créé après ce fichier, une fois que les fichiers téléchargés ont été copiés vers leur destination finale. Comme nom de fichier, citons par exemple `acde1916-9099-7caf-fd21-012345abcdef_most_recent_install`. + **deployment-logs** comporte les fichiers journaux suivants : + Les fichiers **codedeploy-agent.yyyymmdd.log** sont créés pour chacun des jours au cours desquels un déploiement est exécuté. Chaque fichier journal comporte des informations sur les déploiements de la journée. Ces fichiers peuvent s'avérer utiles pour le débogage de problèmes, liés par exemple aux autorisations. Le fichier journal est initialement nommé `codedeploy-agent.log`. Le jour suivant, la date de ses déploiements est insérée dans le nom du fichier. Par exemple, si nous sommes aujourd'hui le 3 janvier 2018, les données sur l'ensemble des déploiements de la journée sont disponibles dans `codedeploy-agent.log`. Demain, le 4 janvier 2018, le fichier journal est renommé `codedeploy-agent.20180103.log`. + **codedeploy-agent-deployments.log** compile le contenu des `scripts.log` fichiers pour chaque déploiement. Les fichiers `scripts.log` sont hébergés dans le sous-dossier `logs` de chaque dossier `Deployment ID`. Les entrées de ce fichier sont précédées d'un ID de déploiement. Par exemple, « `[d-ABCDEF123]LifecycleEvent - BeforeInstall` » peut être écrit durant le déploiement avec un ID de `d-ABCDEF123`. Lorsque `codedeploy-agent-deployments.log` sa taille maximale est atteinte, l' CodeDeploy agent continue d'y écrire tout en supprimant l'ancien contenu. # Gestion des opérations des CodeDeploy agents Les instructions de cette section vous indiquent comment installer, désinstaller, réinstaller ou mettre à jour l' CodeDeploy agent et comment vérifier que l' CodeDeploy agent est en cours d'exécution. **Topics** + [Vérifiez que l' CodeDeploy agent est en cours d'exécution](codedeploy-agent-operations-verify.md) + [Déterminer la version de l' CodeDeploy agent](codedeploy-agent-operations-version.md) + [Installation de l' CodeDeploy agent](codedeploy-agent-operations-install.md) + [Mettre à jour l' CodeDeploy agent](codedeploy-agent-operations-update.md) + [Désinstallez l' CodeDeploy agent](codedeploy-agent-operations-uninstall.md) + [Envoyer les journaux des CodeDeploy agents à CloudWatch](codedeploy-agent-operations-cloudwatch-agent.md) # Vérifiez que l' CodeDeploy agent est en cours d'exécution Cette section décrit les commandes à exécuter si vous pensez que l' CodeDeploy agent a cessé de s'exécuter sur une instance. **Topics** + [Vérifiez que l' CodeDeploy agent pour Amazon Linux ou RHEL est en cours d'exécution](#codedeploy-agent-operations-verify-linux) + [Vérifiez que l' CodeDeploy agent pour Ubuntu Server est en cours d'exécution](#codedeploy-agent-operations-verify-ubuntu) + [Vérifiez que l' CodeDeploy agent pour Windows Server est en cours d'exécution](#codedeploy-agent-operations-verify-windows) ## Vérifiez que l' CodeDeploy agent pour Amazon Linux ou RHEL est en cours d'exécution Pour vérifier si l' CodeDeploy agent est installé et en cours d'exécution, connectez-vous à l'instance et exécutez la commande suivante : ``` systemctl status codedeploy-agent ``` Si la commande renvoie une erreur, l' CodeDeploy agent n'est pas installé. Installez-le comme cela est décrit dans la rubrique [Installation de l' CodeDeploy agent pour Amazon Linux ou RHEL](codedeploy-agent-operations-install-linux.md). Si l' CodeDeploy agent est installé et en cours d'exécution, vous devriez voir un message tel que`The AWS CodeDeploy agent is running`. Si vous voyez un message tel que `error: No AWS CodeDeploy agent running`, démarrez le service et exécutez les deux commandes suivantes, l'une après l'autre : ``` systemctl start codedeploy-agent ``` ``` systemctl status codedeploy-agent ``` ## Vérifiez que l' CodeDeploy agent pour Ubuntu Server est en cours d'exécution Pour vérifier si l' CodeDeploy agent est installé et en cours d'exécution, connectez-vous à l'instance et exécutez la commande suivante : ``` systemctl status codedeploy-agent ``` Si la commande renvoie une erreur, l' CodeDeploy agent n'est pas installé. Installez-le comme cela est décrit dans la rubrique [Installation de l' CodeDeploy agent pour Ubuntu Server](codedeploy-agent-operations-install-ubuntu.md). Si l' CodeDeploy agent est installé et en cours d'exécution, vous devriez voir un message tel que`The AWS CodeDeploy agent is running`. Si vous voyez un message tel que `error: No AWS CodeDeploy agent running`, démarrez le service et exécutez les deux commandes suivantes, l'une après l'autre : ``` systemctl start codedeploy-agent ``` ``` systemctl status codedeploy-agent ``` ## Vérifiez que l' CodeDeploy agent pour Windows Server est en cours d'exécution Pour vérifier si l' CodeDeploy agent est installé et en cours d'exécution, connectez-vous à l'instance et exécutez la commande suivante : ``` powershell.exe -Command Get-Service -Name codedeployagent ``` Vous devez voir des résultats similaires à ce qui suit : ``` Status Name DisplayName ------ ---- ----------- Running codedeployagent CodeDeploy Host Agent Service ``` Si la commande renvoie une erreur, l' CodeDeploy agent n'est pas installé. Installez-le comme cela est décrit dans la rubrique [Installation de l' CodeDeploy agent pour Windows Server](codedeploy-agent-operations-install-windows.md). Si `Status` montre quelque chose d'autre que `Running`, démarrez le service avec la commande suivante : ``` powershell.exe -Command Start-Service -Name codedeployagent ``` Vous pouvez redémarrer le service avec la commande suivante : ``` powershell.exe -Command Restart-Service -Name codedeployagent ``` Vous pouvez arrêter le service avec la commande suivante : ``` powershell.exe -Command Stop-Service -Name codedeployagent ``` # Déterminer la version de l' CodeDeploy agent Vous pouvez déterminer la version de l' CodeDeploy agent exécutée sur votre instance de deux manières. Tout d'abord, à partir de la version 1.0.1.854 de l' CodeDeploy agent, vous pouvez afficher le numéro de version dans un `.version` fichier de l'instance. Le tableau suivant montre l'emplacement et l'exemple de chaîne de version pour chacun des systèmes d'exploitation pris en charge. | Système d’exploitation | Emplacement du fichier | Exemple de chaîne agent\$1version | | --- | --- | --- | | Amazon Linux et 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 | Ensuite, vous pouvez exécuter une commande sur une instance afin de déterminer la version de l'agent CodeDeploy. **Topics** + [Déterminez la version sur Amazon Linux ou RHEL](#codedeploy-agent-operations-version-linux) + [Déterminer la version sur le serveur Ubuntu](#codedeploy-agent-operations-version-ubuntu) + [Déterminer la version sur Windows Server](#codedeploy-agent-operations-version-windows) ## Déterminez la version sur Amazon Linux ou RHEL Connectez-vous à l'instance et exécutez la commande suivante : ``` sudo yum info codedeploy-agent ``` ## Déterminer la version sur le serveur Ubuntu Connectez-vous à l'instance et exécutez la commande suivante : ``` sudo dpkg -s codedeploy-agent ``` ## Déterminer la version sur Windows Server Connectez-vous à l'instance et exécutez la commande suivante : ``` sc qdescription codedeployagent ``` # Installation de l' CodeDeploy agent Pour être utilisé CodeDeploy sur des instances EC2 ou des serveurs locaux, l' CodeDeploy agent doit d'abord être installé. Nous vous recommandons d'installer et de mettre à jour l' CodeDeploy agent avec AWS Systems Manager. Pour plus d'informations sur Systems Manager, consultez [What is AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html). Vous pouvez configurer l'installation et les mises à jour planifiées de l' CodeDeployagent avec Systems Manager dans la console lorsque vous créez vos groupes de déploiement. Vous pouvez également installer l' CodeDeploy agent directement depuis un compartiment S3 à l'aide de la ligne de commande. Pour connaître la version recommandée à installer, voir[Historique des versions de l' CodeDeploy agent](codedeploy-agent.md#codedeploy-agent-version-history). **Topics** + [Installez l' CodeDeploy agent à l'aide de AWS Systems Manager](codedeploy-agent-operations-install-ssm.md) + [Installation de l' CodeDeploy agent à l'aide de la ligne de commande](codedeploy-agent-operations-install-cli.md) # Installez l' CodeDeploy agent à l'aide de AWS Systems Manager Vous pouvez utiliser le AWS Management Console ou AWS CLI pour installer l' CodeDeploy agent sur vos instances Amazon EC2 ou sur site en utilisant. AWS Systems Manager Vous pouvez choisir d'installer une version spécifique ou de toujours installer la version la plus récente de l'agent. Pour plus d'informations AWS Systems Manager, voir [Qu'est-ce que AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html). L'utilisation AWS Systems Manager est la méthode recommandée pour installer et mettre à jour l' CodeDeploy agent. Vous pouvez également installer l' CodeDeploy agent à partir d'un compartiment Amazon S3. Pour de plus amples informations sur l'utilisation d'un lien de téléchargement Amazon S3, consultez [Installation de l' CodeDeploy agent à l'aide de la ligne de commande](codedeploy-agent-operations-install-cli.md). **Topics** + [Conditions préalables](#install-codedeploy-agent-prereqs) + [Installation de l' CodeDeploy agent](#download-codedeploy-agent-on-EC2-Instance) ## Conditions préalables Suivez les étapes décrites [Commencer avec CodeDeploy](getting-started-codedeploy.md) pour configurer les autorisations IAM et le AWS CLI. Si vous installez l' CodeDeploy agent sur un serveur local avec Systems Manager, vous devez enregistrer votre serveur local auprès d'Amazon EC2 Systems Manager. Pour plus d'informations, consultez la section [Configuration de Systems Manager dans les environnements hybrides](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-managedinstances.html) dans le *Guide de AWS Systems Manager l'utilisateur*. ## Installation de l' CodeDeploy agent Avant de pouvoir utiliser Systems Manager pour installer l' CodeDeploy agent, vous devez vous assurer que l'instance est correctement configurée pour Systems Manager. ### Installation ou mise à jour de l'agent SSM Sur une instance Amazon EC2, l' CodeDeploy agent doit exécuter la version 2.3.274.0 ou ultérieure. Avant d'installer l' CodeDeploy agent, mettez à jour ou installez l'agent SSM sur l'instance si ce n'est déjà fait. L'agent SSM est préinstallé sur certains Amazon AMIs EC2 fournis par. AWS Pour plus d'informations, consultez [Amazon Machine Images (AMIs) avec agent SSM préinstallé](https://docs.aws.amazon.com/systems-manager/latest/userguide/ami-preinstalled-agent.html). **Note** Assurez-vous que le système d'exploitation de l'instance est également pris en charge par l' CodeDeployagent. Pour de plus amples informations, veuillez consulter [Systèmes d'exploitation pris en charge par l' CodeDeploy agent](codedeploy-agent.md#codedeploy-agent-supported-operating-systems). Pour plus d'informations sur l'installation ou la mise à jour de l'agent SSM sur une instance exécutant Linux, consultez la section [Installation et configuration de l'agent SSM sur les instances Linux](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-ssm-agent.html) dans le Guide de l'*AWS Systems Manager utilisateur*. Pour plus d'informations sur l'installation ou la mise à jour de l'agent SSM sur une instance exécutant Windows Server, consultez la section [Installation et configuration de l'agent SSM sur les instances Windows](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-ssm-win.html) dans le Guide de l'*AWS Systems Manager utilisateur*. ### (Facultatif) Vérification des prérequis de Systems Manager Avant d'utiliser la commande Run Command de Systems Manager pour installer l' CodeDeploy agent, vérifiez que vos instances répondent aux exigences minimales de Systems Manager. Pour plus d’informations, consultez [Configuration d’ AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up.html) dans le *Guide de l’utilisateur AWS Systems Manager *. ### Installation de l' CodeDeploy agent Avec SSM, vous pouvez l'installer CodeDeploy une seule fois ou établir un calendrier pour installer les nouvelles versions. Pour installer l' CodeDeploy agent, choisissez le `AWSCodeDeployAgent` package en suivant les étapes décrites dans [Installer ou mettre à jour les packages avec le AWS Systems Manager distributeur](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor-working-with-packages-deploy.html). # Installation de l' CodeDeploy agent à l'aide de la ligne de commande **Note** Nous vous recommandons d'installer l' CodeDeploy agent AWS Systems Manager pour pouvoir configurer les mises à jour planifiées de l'agent. Pour de plus amples informations, veuillez consulter [Installez l' CodeDeploy agent à l'aide de AWS Systems Manager](codedeploy-agent-operations-install-ssm.md). Utilisez les rubriques suivantes pour installer et exécuter l' CodeDeploy agent à l'aide de la ligne de commande. **Topics** + [Installation de l' CodeDeploy agent pour Amazon Linux ou RHEL](codedeploy-agent-operations-install-linux.md) + [Installation de l' CodeDeploy agent pour Ubuntu Server](codedeploy-agent-operations-install-ubuntu.md) + [Installation de l' CodeDeploy agent pour Windows Server](codedeploy-agent-operations-install-windows.md) # Installation de l' CodeDeploy agent pour Amazon Linux ou RHEL Connectez-vous à l'instance et exécutez les commandes suivantes, l'une après l'autre. L'exécution de la commande en `sudo yum update` `yum` premier est considérée comme une bonne pratique lors de l'installation de packages, mais vous pouvez l'ignorer si vous ne souhaitez pas mettre à jour tous vos packages. ``` sudo yum update ``` ``` sudo yum install ruby ``` ``` sudo yum install wget ``` (Facultatif) Pour nettoyer l'AMI de toutes les informations de mise en cache de l'agent précédentes, exécutez le script suivant : ``` #!/bin/bash CODEDEPLOY_BIN="/opt/codedeploy-agent/bin/codedeploy-agent" $CODEDEPLOY_BIN stop yum erase codedeploy-agent -y ``` Accédez à votre répertoire personnel : ``` cd /home/ec2-user ``` **Note** Dans la commande précédente, `/home/ec2-user` représente le nom d'utilisateur par défaut pour une instance Amazon Linux ou RHEL Amazon EC2. Si votre instance a été créée à l'aide d'une image AMI personnalisée, le propriétaire de l'image AMI peut avoir spécifié un nom d'utilisateur par défaut différent. Téléchargez le programme d'installation de l' CodeDeploy agent : ``` wget https://bucket-name.s3.region-identifier.amazonaws.com/latest/install ``` *bucket-name*est le nom du compartiment Amazon S3 qui contient les fichiers du kit de CodeDeploy ressources pour votre région, ainsi *region-identifier* que l'identifiant de votre région. Par exemple : `https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latest/install` Pour obtenir la liste des noms de compartiments et des identificateurs de région, consultez[Noms des compartiments du kit de ressources par région](resource-kit.md#resource-kit-bucket-names). Définissez les autorisations d'exécution sur le `install` fichier : ``` chmod +x ./install ``` Pour installer la dernière version de l' CodeDeploy agent : + ``` sudo ./install auto ``` Pour installer une version spécifique de l' CodeDeploy agent : + Répertoriez les versions disponibles dans votre région : ``` aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.rpm$' ``` + Installez l'une des versions suivantes : ``` sudo ./install auto -v releases/codedeploy-agent-version.noarch.rpm ``` **Note** AWS prend en charge la dernière version mineure de l' CodeDeploy agent. Actuellement, la dernière version mineure est 1.7.x. Pour vérifier que le service est en cours d'exécution, exécutez la commande suivante : ``` systemctl status codedeploy-agent ``` Si l' CodeDeploy agent est installé et en cours d'exécution, vous devriez voir un message tel que`The AWS CodeDeploy agent is running`. Si vous voyez un message tel que `error: No AWS CodeDeploy agent running`, démarrez le service et exécutez les deux commandes suivantes, l'une après l'autre : ``` systemctl start codedeploy-agent ``` ``` systemctl status codedeploy-agent ``` # Installation de l' CodeDeploy agent pour Ubuntu Server **Note** Nous vous recommandons d'installer l' CodeDeploy agent AWS Systems Manager pour pouvoir configurer les mises à jour planifiées de l'agent. Pour de plus amples informations, veuillez consulter [Installez l' CodeDeploy agent à l'aide de AWS Systems Manager](codedeploy-agent-operations-install-ssm.md). **Pour installer l' CodeDeploy agent sur le serveur Ubuntu** 1. Connectez-vous à l'instance. 1. Entrez les commandes suivantes, l'une après l'autre : ``` sudo apt update ``` ``` sudo apt install ruby-full ``` ``` sudo apt install wget ``` 1. Entrez la commande suivante : ``` cd /home/ubuntu ``` */home/ubuntu*représente le nom d'utilisateur par défaut pour une instance de serveur Ubuntu. Si votre instance a été créée à l'aide d'une image AMI personnalisée, le propriétaire de l'image AMI peut avoir spécifié un nom d'utilisateur par défaut différent. 1. Entrez la commande suivante : ``` wget https://bucket-name.s3.region-identifier.amazonaws.com/latest/install ``` *bucket-name*est le nom du compartiment Amazon S3 qui contient les fichiers du kit de CodeDeploy ressources pour votre région, ainsi *region-identifier* que l'identifiant de votre région. Par exemple : `https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latest/install` Pour obtenir la liste des noms de compartiments et des identificateurs de région, consultez[Noms des compartiments du kit de ressources par région](resource-kit.md#resource-kit-bucket-names). 1. Entrez la commande suivante : ``` chmod +x ./install ``` 1. Effectuez l’une des actions suivantes : + Pour installer la dernière version de l' CodeDeploy agent sur n'importe quelle version prise en charge d'Ubuntu Server à l'*exception* de la version 20.04 : ``` sudo ./install auto ``` + Pour installer la dernière version de l' CodeDeploy agent sur Ubuntu Server 20.04 : **Note** L'écriture de la sortie dans un fichier journal temporaire est une solution de contournement qui doit être utilisée lorsque nous corrigeons un bogue connu avec le `install` script sur Ubuntu Server 20.04. ``` sudo ./install auto > /tmp/logfile ``` + Pour installer une version spécifique de l' CodeDeploy agent sur n'importe quelle version prise en charge d'Ubuntu Server à l'*exception* de la version 20.04 : + Répertoriez les versions disponibles dans votre région : ``` aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.deb$' ``` + Installez l'une des versions suivantes : ``` sudo ./install auto -v releases/codedeploy-agent-###.deb ``` **Note** AWS prend en charge la dernière version mineure de l' CodeDeploy agent. Actuellement, la dernière version mineure est 1.7.x. + Pour installer une version spécifique de l' CodeDeploy agent sur Ubuntu Server 20.04 : + Répertoriez les versions disponibles dans votre région : ``` aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.deb$' ``` + Installez l'une des versions suivantes : ``` sudo ./install auto -v releases/codedeploy-agent-###.deb > /tmp/logfile ``` **Note** L'écriture de la sortie dans un fichier journal temporaire est une solution de contournement qui doit être utilisée lorsque nous corrigeons un bogue connu avec le `install` script sur Ubuntu Server 20.04. **Note** AWS prend en charge la dernière version mineure de l' CodeDeploy agent. Actuellement, la dernière version mineure est 1.7.x. **Pour vérifier que le service fonctionne** 1. Entrez la commande suivante : ``` systemctl status codedeploy-agent ``` Si l' CodeDeploy agent est installé et en cours d'exécution, vous devriez voir un message tel que`The AWS CodeDeploy agent is running`. 1. Si vous voyez un message tel que `error: No AWS CodeDeploy agent running`, démarrez le service et exécutez les deux commandes suivantes, l'une après l'autre : ``` systemctl start codedeploy-agent ``` ``` systemctl status codedeploy-agent ``` # Installation de l' CodeDeploy agent pour Windows Server Sur les instances Windows Server, vous pouvez utiliser l'une des méthodes suivantes pour télécharger et installer l' CodeDeploy agent : + Utilisation AWS Systems Manager (recommandée) + Exécutez une série de PowerShell commandes Windows. + Choisissez un lien de téléchargement direct. + Exécutez une commande de copie Amazon S3. **Note** Le dossier dans lequel l' CodeDeploy agent est installé est`C:\Program Data\Amazon\CodeDeploy`. Assurez-vous qu'il n'y a pas de jonctions de répertoires ou de liens symboliques sur ce chemin. **Topics** + [Utiliser Systems Manager](#codedeploy-agent-operations-install-system-manager) + [Utiliser Windows PowerShell](#codedeploy-agent-operations-install-windows-powershell) + [Utilisation d'un lien direct](#codedeploy-agent-operations-install-windows-direct-link) + [Utiliser une commande de copie Amazon S3](#codedeploy-agent-operations-install-windows-s3-copy) ## Utiliser Systems Manager Suivez les instructions [Installez l' CodeDeploy agent à l'aide de AWS Systems Manager](codedeploy-agent-operations-install-ssm.md) pour installer l' CodeDeployagent. ## Utiliser Windows PowerShell Connectez-vous à l'instance et exécutez les commandes suivantes sous Windows PowerShell : 1. Exigez que tous les scripts et les fichiers de configuration téléchargés depuis Internet soient signées par un éditeur de confiance. Si vous êtes invité à modifier la stratégie d'exécution, tapez « **Y** ». ``` Set-ExecutionPolicy RemoteSigned ``` 1. Chargez le AWS Tools for Windows PowerShell. ``` Import-Module AWSPowerShell ``` 1. Créez un répertoire dans lequel le fichier d'installation de l' CodeDeploy agent est téléchargé. ``` New-Item -Path "c:\temp" -ItemType "directory" -Force ``` 1. Configurez AWS les informations d'identification à l'aide `Set-AWSCredential` des `Initialize-AWSDefaultConfiguration` commandes et. Pour plus d'informations, consultez la section [Utilisation des AWS informations d'identification](https://docs.aws.amazon.com/powershell/latest/userguide/specifying-your-aws-credentials.html) dans les *AWS outils du Guide de PowerShell l'utilisateur*. 1. Téléchargez le fichier d'installation de l' CodeDeploy agent. **Note** AWS prend en charge la dernière version mineure de l' CodeDeploy agent. Actuellement, la dernière version mineure est 1.7.x. Pour installer la dernière version de l' CodeDeployagent : + ``` powershell.exe -Command Read-S3Object -BucketName bucket-name -Key latest/codedeploy-agent.msi -File c:\temp\codedeploy-agent.msi ``` Pour installer une version spécifique de l' CodeDeployagent : + ``` powershell.exe -Command Read-S3Object -BucketName bucket-name -Key releases/codedeploy-agent-###.msi -File c:\temp\codedeploy-agent.msi ``` *bucket-name*est le nom du compartiment Amazon S3 qui contient les fichiers du kit de CodeDeploy ressources pour votre région. Par exemple, pour la région USA Est (Ohio), remplacez *bucket-name* par`aws-codedeploy-us-east-2`. Pour obtenir la liste des noms de compartiments, consultez[Noms des compartiments du kit de ressources par région](resource-kit.md#resource-kit-bucket-names). 1. Exécutez le fichier d'installation de l' CodeDeploy agent. ``` c:\temp\codedeploy-agent.msi /quiet /l c:\temp\host-agent-install-log.txt ``` Pour vérifier que le service est en cours d'exécution, exécutez la commande suivante : ``` powershell.exe -Command Get-Service -Name codedeployagent ``` Si l' CodeDeploy agent vient d'être installé et n'a pas été démarré, après avoir exécuté la **Get-Service** commande, sous **État**, vous devriez voir **Start...** : ``` Status Name DisplayName ------ ---- ----------- Start... codedeployagent CodeDeploy Host Agent Service ``` Si l' CodeDeploy agent est déjà en cours d'exécution, après avoir exécuté la **Get-Service** commande, sous **État**, vous devriez voir **Running** : ``` Status Name DisplayName ------ ---- ----------- Running codedeployagent CodeDeploy Host Agent Service ``` ## Utilisation d'un lien direct Si les paramètres de sécurité du navigateur de l'instance Windows Server fournissent les autorisations (par exemple, pour`https://s3.*.amazonaws.com`), vous pouvez utiliser un lien direct vers votre région pour télécharger l' CodeDeploy agent, puis exécuter le programme d'installation manuellement. Le lien est le suivant : ``` https://s3.region.amazonaws.com/aws-codedeploy-region/latest/codedeploy-agent.msi ``` ... où se *region* trouve la AWS région dans laquelle vous déployez votre application. Par exemple : ``` https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latest/codedeploy-agent.msi ``` **Important** Procurez-vous le `.msi` fichier auprès de la même région que votre CodeDeploy demande. Le choix d'une autre région peut entraîner `inconsistent region` des défaillances dans le `codedeploy-agent-log` fichier lorsque vous l'`.msi`exécutez. ## Utiliser une commande de copie Amazon S3 S'il AWS CLI est installé sur l'instance, vous pouvez utiliser la commande Amazon S3 [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) pour télécharger l' CodeDeploy agent, puis exécuter le programme d'installation manuellement. Pour plus d'informations, voir [Installer AWS Command Line Interface le sous Microsoft Windows](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html). La commande Amazon S3 est la suivante : ``` aws s3 cp s3://aws-codedeploy-region/latest/codedeploy-agent.msi codedeploy-agent.msi --region region ``` ... où se *region* trouve la AWS région dans laquelle vous déployez votre application. Par exemple : ``` aws s3 cp s3://aws-codedeploy-af-south-1/latest/codedeploy-agent.msi codedeploy-agent.msi --region af-south-1 ``` # Mettre à jour l' CodeDeploy agent Vous pouvez configurer des mises à jour automatiques et planifiées de l' CodeDeploy agent sur tous les systèmes d'exploitation pris en charge à l'aide de AWS Systems Manager. Vous pouvez également forcer les mises à jour sur tous les systèmes d'exploitation pris en charge en exécutant une commande sur une instance. **Topics** + [Mettre à jour l' CodeDeploy agent sur Amazon Linux ou RHEL](codedeploy-agent-operations-update-linux.md) + [Mettre à jour l' CodeDeploy agent sur le serveur Ubuntu](codedeploy-agent-operations-update-ubuntu.md) + [Mettre à jour l' CodeDeploy agent sur Windows Server](codedeploy-agent-operations-update-windows.md) # Mettre à jour l' CodeDeploy agent sur Amazon Linux ou RHEL Pour configurer les mises à jour automatiques et planifiées de l' CodeDeploy agent à l'aide de AWS Systems Manager, suivez les étapes [décrites dans Installer l' CodeDeploy agent avec AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html). Si vous souhaitez forcer la mise à jour de l' CodeDeploy agent, connectez-vous à l'instance et exécutez la commande suivante : ``` sudo /opt/codedeploy-agent/bin/install auto ``` # Mettre à jour l' CodeDeploy agent sur le serveur Ubuntu Pour configurer les mises à jour automatiques et planifiées de l' CodeDeploy agent à l'aide de AWS Systems Manager, suivez les étapes [décrites dans Installer l' CodeDeploy agent avec AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html). Si vous souhaitez forcer la mise à jour de l' CodeDeploy agent, connectez-vous à l'instance et exécutez la commande suivante : ``` sudo /opt/codedeploy-agent/bin/install auto ``` # Mettre à jour l' CodeDeploy agent sur Windows Server Vous pouvez activer les mises à jour automatiques de l' CodeDeploy agent avec AWS Systems Manager. Avec Systems Manager, vous pouvez configurer un calendrier de mise à jour pour vos instances Amazon EC2 ou sur site en créant une association avec Systems Manager State Manager. Vous pouvez également mettre à jour l' CodeDeploy agent manuellement en désinstallant la version actuelle et en installant une version plus récente. **Topics** + [Configurez la mise à jour automatique des CodeDeploy agents avec AWS Systems Manager](#codedeploy-agent-operations-update-windows-ssm) + [Mettre à jour l' CodeDeploy agent manuellement](#codedeploy-agent-operations-update-windows-manual) + [(Obsolète) Mettez à jour l' CodeDeploy agent avec le Windows Server Updater](#codedeploy-agent-operations-update-windows-updater) ## Configurez la mise à jour automatique des CodeDeploy agents avec AWS Systems Manager Pour configurer Systems Manager et activer les mises à jour automatiques de l' CodeDeploy agent, suivez les instructions de la section [Installer l' CodeDeploy agent à l'aide](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html) de AWS Systems Manager. ## Mettre à jour l' CodeDeploy agent manuellement Pour mettre à jour l' CodeDeploy agent manuellement, vous pouvez installer la dernière version à partir de la CLI ou à l'aide de Systems Manager. Suivez les instructions de [Installer l'agent CodeDeploy.](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install.html) Il est recommandé de désinstaller les anciennes versions de l' CodeDeploy agent en suivant les instructions de la section [Désinstaller l' CodeDeployagent](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-uninstall.html). ## (Obsolète) Mettez à jour l' CodeDeploy agent avec le Windows Server Updater **Note** Le programme de mise à jour de l' CodeDeploy agent pour Windows Server est obsolète et ne sera mis à jour vers aucune version postérieure à la version 1.0.1.1597. Pour activer les mises à jour automatiques de l' CodeDeploy agent, installez le programme de mise à jour de l' CodeDeploy agent pour Windows Server sur des instances nouvelles ou existantes. Le programme de mise à jour vérifie régulièrement l'existence de nouvelles versions. Lorsqu'une nouvelle version est détectée, le programme de mise à jour désinstalle la version actuelle de l'agent, si elle est installée, avant d'installer la version la plus récente. Si un déploiement est déjà en cours lorsque le programme de mise à jour détecte une nouvelle version, le déploiement se poursuit jusqu'à la fin. Si un déploiement tente de démarrer pendant le processus de mise à jour, le déploiement échoue. Si vous souhaitez forcer la mise à jour de l' CodeDeploy agent, suivez les instructions figurant dans[Installation de l' CodeDeploy agent pour Windows Server](codedeploy-agent-operations-install-windows.md). Sur les instances Windows Server, vous pouvez télécharger et installer le programme de mise à jour de l' CodeDeploy agent en exécutant des PowerShell commandes Windows, en utilisant un lien de téléchargement direct ou en exécutant une commande de copie Amazon S3. **Topics** + [Utiliser Windows PowerShell](#codedeploy-agent-operations-update-windows-powershell) + [Utilisation d'un lien direct](#codedeploy-agent-operations-update-windows-direct-link) + [Utiliser une commande de copie Amazon S3](#codedeploy-agent-operations-update-windows-s3-copy) ### Utiliser Windows PowerShell Connectez-vous à l'instance et exécutez les commandes suivantes sous Windows PowerShell, une par une : ``` Set-ExecutionPolicy RemoteSigned ``` Si vous êtes invité à modifier la politique d'exécution, choisissez de faire en **Y** sorte que Windows PowerShell exige que tous les scripts et fichiers de configuration téléchargés depuis Internet soient signés par un éditeur approuvé. ``` 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*est le nom du compartiment Amazon S3 qui contient les fichiers du kit de CodeDeploy ressources pour votre région. Par exemple, pour la région USA Est (Ohio), remplacez *bucket-name* par`aws-codedeploy-us-east-2`. Pour obtenir la liste des noms de compartiments, consultez[Noms des compartiments du kit de ressources par région](resource-kit.md#resource-kit-bucket-names). Si vous devez résoudre une erreur du processus de mise à jour, tapez la commande suivante pour ouvrir le fichier journal du programme de mise à jour de l' CodeDeploy agent : ``` notepad C:\ProgramData\Amazon\CodeDeployUpdater\log\codedeploy-agent.updater.log ``` ### Utilisation d'un lien direct Si les paramètres de sécurité du navigateur de l'instance Windows Server fournissent les autorisations requises (par exemple, pour ` http://s3.*.amazonaws.com `), vous pouvez utiliser un lien direct pour télécharger le programme de mise à jour de l' CodeDeploy agent. Le lien est le suivant : ``` https://s3.region.amazonaws.com/aws-codedeploy-region/latest/codedeploy-agent-updater.msi ``` ... où se *region* trouve la AWS région dans laquelle vous mettez à jour votre application. Par exemple : ``` https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latest/codedeploy-agent-updater.msi ``` ### Utiliser une commande de copie Amazon S3 S'il AWS CLI est installé sur l'instance, vous pouvez utiliser la commande Amazon S3 [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) pour télécharger le programme de mise à jour de l' CodeDeploy agent, puis exécuter le programme d'installation manuellement. Pour plus d'informations, voir [Installer AWS Command Line Interface le sous Microsoft Windows](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html). La commande Amazon S3 est la suivante : ``` aws s3 cp s3://aws-codedeploy-region/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi --region region ``` ... où se *region* trouve la AWS région dans laquelle vous mettez à jour votre application. Par exemple : ``` aws s3 cp s3://aws-codedeploy-af-south-1/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi --region af-south-1 ``` # Désinstallez l' CodeDeploy agent Vous pouvez supprimer l' CodeDeploy agent des instances lorsqu'il n'est plus nécessaire ou lorsque vous souhaitez effectuer une nouvelle installation. ## Désinstallez l' CodeDeploy agent d'Amazon Linux ou de RHEL Pour désinstaller l' CodeDeploy agent, connectez-vous à l'instance et exécutez la commande suivante : ``` sudo yum erase codedeploy-agent ``` ## Désinstallez l' CodeDeploy agent d'Ubuntu Server Pour désinstaller l' CodeDeploy agent, connectez-vous à l'instance et exécutez la commande suivante : ``` sudo dpkg --purge codedeploy-agent ``` ## Désinstallez l' CodeDeploy agent de Windows Server Pour désinstaller l' CodeDeploy agent, connectez-vous à l'instance et exécutez les trois commandes suivantes, une par une : ``` wmic ``` ``` product where name="CodeDeploy Host Agent" call uninstall /nointeractive ``` ``` exit ``` Vous pouvez également vous connecter à l'instance et, dans le **Panneau de configuration**, ouvrir **Programmes et fonctionnalités**, choisir **CodeDeploy Host Agent**, puis choisir **Désinstaller**. # Envoyer les journaux des CodeDeploy agents à CloudWatch Vous pouvez envoyer les données métriques et de journal de l' CodeDeploy agent à CloudWatch l'aide de l'[ CloudWatch agent unifié](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/UseCloudWatchUnifiedAgent.html) ou, plus simplement, de l' CloudWatch agent. Suivez les instructions ci-dessous pour installer l' CloudWatch agent et le configurer pour une utilisation avec CodeDeploy des agents. ## Conditions préalables Avant de commencer, effectuez les tâches suivantes : + Installez l' CodeDeploy agent et assurez-vous qu'il est en cours d'exécution. Pour plus d’informations, consultez [Installation de l' CodeDeploy agent](codedeploy-agent-operations-install.md) et [Vérifiez que l' CodeDeploy agent est en cours d'exécution](codedeploy-agent-operations-verify.md). + Installez l' CloudWatch agent. Pour plus d'informations, consultez la section [Installation de l' CloudWatch agent](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance.html). + Ajoutez les autorisations suivantes au profil d'instance CodeDeploy IAM : + CloudWatchLogsFullAccess + CloudWatchAgentServerPolicy Pour plus d'informations sur le profil d' CodeDeploy instance, consultez [Étape 4 : Création d'un profil d'instance IAM pour vos instances Amazon EC2](getting-started-create-iam-instance-profile.md) la section de[Commencer avec CodeDeploy](getting-started-codedeploy.md). ## Configuration de l' CloudWatch agent pour collecter les CodeDeploy journaux Vous pouvez configurer l' CloudWatch agent en utilisant un assistant ou en créant ou en modifiant manuellement un fichier de configuration. **Pour configurer l' CloudWatch agent à l'aide de l'assistant (Linux)** 1. Exécutez l'assistant, comme décrit dans [Exécuter l'assistant de configuration de l' CloudWatch agent](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard). 1. Dans l'assistant, lorsque vous y êtes invité, `Do you want to monitor any log files?` entrez**1**. 1. Spécifiez le fichier journal de l' CodeDeploy agent, comme suit : 1. Pour `Log file path` saisir le chemin du fichier CodeDeploy journal, par exemple :**/var/log/aws/codedeploy-agent/codedeploy-agent.log**. 1. Pour `Log group name` saisir un nom de groupe de journaux, par exemple :**codedeploy-agent-log**. 1. Pour `Log stream name` saisir un nom de flux de journal, par exemple :**\$1instance\$1id\$1-codedeploy-agent-log**. 1. Lorsque vous y êtes invité`Do you want to specify any additional log files?`, entrez**1**. 1. Spécifiez les journaux de déploiement de l' CodeDeploy agent, comme suit : 1. Pour `Log file path` saisir le chemin du fichier journal de CodeDeploy déploiement, par exemple :**/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log**. 1. Pour `Log group name` saisir un nom de groupe de journaux, par exemple :**codedeploy-agent-deployment-log**. 1. Pour `Log stream name` saisir un nom de flux de journal, par exemple :**\$1instance\$1id\$1-codedeploy-agent-deployment-log**. 1. Lorsque vous y êtes invité`Do you want to specify any additional log files?`, entrez**1**. 1. Spécifiez les journaux du programme de mise à jour de l' CodeDeploy agent, comme suit : 1. Pour `Log file path` saisir le chemin du fichier journal du CodeDeploy programme de mise à jour, par exemple :**/tmp/codedeploy-agent.update.log**. 1. Pour `Log group name` saisir un nom de groupe de journaux, par exemple :**codedeploy-agent-updater-log**. 1. Pour `Log stream name` saisir un nom de flux de journal, par exemple :**\$1instance\$1id\$1-codedeploy-agent-updater-log**. **Pour configurer l' CloudWatch agent à l'aide de l'assistant (Windows)** 1. Exécutez l'assistant, comme décrit dans [Exécuter l'assistant de configuration de l' CloudWatch agent](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard). 1. Dans l'assistant, lorsque vous y êtes invité, `Do you want to monitor any customized log files?` entrez**1**. 1. Spécifiez le fichier CodeDeploy journal, comme suit : 1. Pour `Log file path` saisir le chemin ou le fichier journal de l' CodeDeploy agent, par exemple :**C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1log\$1codedeploy-agent-log.txt**. 1. Pour `Log group name` saisir un nom de groupe de journaux, par exemple :**codedeploy-agent-log**. 1. Pour `Log stream name` saisir un nom de flux de journal, par exemple :**\$1instance\$1id\$1-codedeploy-agent-log**. 1. Lorsque vous y êtes invité`Do you want to specify any additional log files?`, entrez**1**. 1. Spécifiez les journaux de déploiement de l' CodeDeploy agent, comme suit : 1. Pour `Log file path` saisir le chemin du fichier journal de CodeDeploy déploiement, par exemple :**C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1deployment-logs\$1codedeploy-agent-deployments.log**. 1. Pour `Log group name` saisir un nom de groupe de journaux, par exemple :**codedeploy-agent-deployment-log**. 1. Pour `Log stream name` saisir un nom de flux de journal, par exemple :**\$1instance\$1id\$1-codedeploy-agent-deployment-log**. **Pour configurer l' CloudWatch agent en créant ou en modifiant manuellement un fichier de configuration (Linux)** 1. Créez ou modifiez le fichier de configuration de l' CloudWatch agent comme décrit dans [Création ou modification manuelle du fichier de configuration de l' CloudWatch agent](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html). 1. Assurez-vous que le fichier est appelé `/opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.json` et qu'il contient le code suivant : ``` ... "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" } ] } } } ... ``` **Pour configurer l' CloudWatch agent en créant ou en modifiant manuellement un fichier de configuration (Windows)** 1. Créez ou modifiez le fichier de configuration de l' CloudWatch agent comme décrit dans [Création ou modification manuelle du fichier de configuration de l' CloudWatch agent](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html). 1. Assurez-vous que le fichier est appelé `C:\ProgramData\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent.json` et qu'il contient le code suivant : ``` ... "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" } ] }, ... } }, ... ``` ## Redémarrer l' CloudWatch agent Après avoir apporté vos modifications, redémarrez l' CloudWatch agent comme décrit dans [Démarrer l' CloudWatch agent](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance-fleet.html#start-CloudWatch-Agent-EC2-fleet).