Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Trabajando con el CodeDeploy agente El AWS CodeDeploy agente es un paquete de software que, cuando se instala y configura en una instancia, permite que esa instancia se utilice en CodeDeploy las implementaciones. AWS es compatible con la última versión secundaria del CodeDeploy agente. Actualmente, la última versión secundaria es la 1.8.x. **nota** El CodeDeploy agente solo es necesario si se implementa en una plataforma informática local o de EC2. El agente no es necesario para las implementaciones que utilizan la plataforma de informática de Amazon ECS o AWS Lambda. Un archivo de configuración se coloca en la instancia cuando se instala el agente. Este archivo se utiliza para especificar cómo funciona el agente. Este archivo de configuración especifica las rutas de los directorios y otros ajustes AWS CodeDeploy que se utilizarán cuando interactúe con la instancia. Puede cambiar algunas de las opciones de configuración en el archivo. Para obtener información sobre cómo trabajar con el archivo de configuración del CodeDeploy agente, consulte[Referencia de configuración del agente de CodeDeploy](reference-agent-configuration.md). Para obtener más información sobre cómo trabajar con el CodeDeploy agente, como los pasos para instalar, actualizar y verificar las versiones, consulte[Gestión de las operaciones CodeDeploy de los agentes](codedeploy-agent-operations.md). **Topics** + [Sistemas operativos compatibles con el agente CodeDeploy](#codedeploy-agent-supported-operating-systems) + [Protocolo de comunicación y puerto para el CodeDeploy agente](#codedeploy-agent-outbound-port) + [Historial de versiones del agente CodeDeploy](#codedeploy-agent-version-history) + [Administrar el CodeDeploy proceso](#codedeploy-agent-processes) + [Limpieza de revisiones de aplicación y archivos de registro](#codedeploy-agent-revisions-logs-cleanup) + [Archivos instalados por el agente CodeDeploy](#codedeploy-agent-install-files) + [Gestión de las operaciones CodeDeploy de los agentes](codedeploy-agent-operations.md) ## Sistemas operativos compatibles con el agente CodeDeploy ### Sistemas operativos de AMI de Amazon EC2 compatibles El CodeDeploy agente se ha probado en los siguientes sistemas operativos AMI de Amazon EC2: + 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 + Ubuntu Server 22.04 LTS, 20.04 LTS, 18.04 LTS, 16.04 LTS El CodeDeploy agente está disponible como código abierto para que lo adapte a sus necesidades. Se puede utilizar con otros sistemas operativos de AMI de Amazon EC2. Para obtener más información, vaya al repositorio de [CodeDeploy agentes](https://github.com/aws/aws-codedeploy-agent) en GitHub. ### Sistemas operativos en las instalaciones compatibles El CodeDeploy agente se ha probado en los siguientes sistemas operativos locales: + Microsoft Windows Server 2022, 2019 + Red Hat Enterprise Linux (RHEL) 9.x, 8.x, 7.x + Ubuntu Server 22.04 LTS, 20.04 LTS El CodeDeploy agente está disponible como código abierto para que lo adapte a sus necesidades. Se puede utilizar con otros sistemas operativos de instancias on-premises. Para obtener más información, vaya al repositorio de [CodeDeploy agentes](https://github.com/aws/aws-codedeploy-agent) en GitHub. ## Protocolo de comunicación y puerto para el CodeDeploy agente El CodeDeploy agente se comunica de forma saliente mediante HTTPS a través del puerto 443. Cuando el CodeDeploy agente se ejecute en una instancia de EC2, utilizará el extremo de [metadatos de EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html) para recuperar la información relacionada con la instancia. Obtenga más información sobre la [limitación y la concesión de acceso al servicio de metadatos de instancia](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html#instance-metadata-limiting-access). ## Historial de versiones del agente CodeDeploy Sus instancias deben ejecutar una versión compatible del CodeDeploy agente. La versión mínima admitida actualmente es la 1.8.x. **nota** Recomendamos utilizar la última versión del CodeDeploy agente. Si tienes problemas, actualiza a la última versión antes de ponerte en contacto con AWS Support. Para obtener información acerca de cómo actualizar, consulte [Actualice el CodeDeploy agente](codedeploy-agent-operations-update.md). En la siguiente tabla se enumeran todas las versiones del CodeDeploy agente y las funciones y mejoras incluidas en cada versión. | Versión | Fecha de lanzamiento | Details | | --- | --- | --- | | 1.8.1 | 3 de febrero de 2026 | **Corregido**: corrección de un error en el terminal S3. **Se agregó**: el certificado CA de Sectigo a la lista de CA de Windows. | | 1.8.0 | 31 de julio de 2025 | **Modificado**: se actualizó el Ruby incluido a 3.2 en el CodeDeploy agente para Windows. | | 1.7.1 | 14 de noviembre de 2024 | **Modificación**: se han actualizado las dependencias para los parches de seguridad. | | 1.7.0 | 6 de marzo de 2024 | **Se agregó**: un ajuste `:disable_imds_v1:` de configuración al archivo de configuración del CodeDeploy agente. Use esta configuración para deshabilitar la opción alternativa IMDSv1 cuando se producen IMDSv2 errores. El valor predeterminado es `false` (habilita la alternativa). Para obtener más información, consulte la [referencia de configuración del CodeDeploy agente](https://docs.aws.amazon.com/codedeploy/latest/userguide/reference-agent-configuration.html). **Adición**: compatibilidad con el sistema operativo Red Hat Enterprise Linux 9 (RHEL 9). **Adición**: compatibilidad con las versiones 3.1 y 3.2 de Ruby en Ubuntu Server. **Corregido**: el CodeDeploy agente ahora genera un error fácil de usar si el archivo de configuración del CodeDeploy agente no se carga. **Modificado**: se actualizó Ruby a la versión 2.7.8-1 en el CodeDeploy agente para Windows. | | 1.6.0 | 30 de marzo de 2023 | **Se ha añadido**: compatibilidad con Ruby 3.1, 3.2. **Se ha añadido**: compatibilidad con Amazon Linux 2023. **Se ha añadido**: compatibilidad con Windows Server 2022. **Se ha modificado**: la configuración predeterminada de `verbose` es ahora `false` para las instancias de Windows Server. Para seguir imprimiendo los mensajes de depuración en los archivos de registro de Windows, debe configurar `verbose` en `true`. **Se ha eliminado**: compatibilidad con Windows Server 2016 y Windows Server 2012 R2. **Se ha eliminado**: compatibilidad con Amazon Linux 2018.03.x. | | 1.5.0 | 3 de marzo de 2023 | **Se ha añadido**: compatibilidad con Ruby 3. **Se ha añadido**: compatibilidad con Ubuntu 22.04. **Se ha corregido** un error que provocaba que, al reiniciar el CodeDeploy agente poco después del arranque, el agente quedara bloqueado. **Modificado**: el CodeDeploy agente ahora falla en el despliegue de un host al iniciar el agente si el servicio del agente se reinicia inesperadamente mientras se ejecuta un script de enlace. Esta solución permite evitar el tiempo de espera de 70 minutos antes de volver a intentar una implementación. **Aviso de obsolescencia**: el CodeDeploy agente 1.5.0 es la última versión compatible con Windows Server 2016 y Windows Server 2012 R2. **Eliminado:** Support para el CodeDeploy agente en Ubuntu 14.04 LTS, Windows Server 2008 R2 y Windows Server 2008 R2 de 32 bits. | | 1.4.1 | 6 de diciembre de 2022 | **Se ha corregido**: vulnerabilidad de seguridad relacionada con el registro. **Mejora**: se mejoró el registro al sondear el comando host. | | 1.4.0 | 31 de agosto de 2022 | **Se ha añadido**: compatibilidad con Red Hat Enterprise Linux 8. **Añadido**: Support para rutas de archivo largas en el CodeDeploy agente para Windows. Para habilitar las rutas de archivo largas, tendrá que configurar la clave de registro de Windows adecuada y, a continuación, reiniciar el agente. Para obtener más información, consulte [Las rutas de archivo largas provocan el error “No existe tal archivo o directorio”](troubleshooting-deployments.md#troubleshooting-long-file-paths). **Se ha corregido**: un problema con la operación de descompresión cuando el disco estaba lleno. El CodeDeploy agente ahora detecta el [código de salida 50](https://linux.die.net/man/1/unzip) de la descompresión, que indica que el disco está lleno, elimina los archivos extraídos parcialmente y crea una excepción si se produce un error en el CodeDeploy servidor. El mensaje de error aparece como un mensaje de error de un evento del ciclo de vida y la implementación a nivel de host se detendrá sin bloquearse y sin agotar el tiempo de espera. **Se ha corregido**: un problema que provocaba un error en el agente. **Se ha corregido**: un problema que provocaba que se agotara el tiempo de espera de los enlaces durante una carrera al límite. Los enlaces sin scripts ahora continuarán y ya no causarán errores ni se agotarán los tiempos de espera. **Modificado**: el `update` script del `bin` directorio del CodeDeploy agente se ha eliminado porque ya no se utiliza. **Modificado**: el CodeDeploy agente para Windows Server ahora incluye Ruby 2.7. **Modificado**: se agregaron nuevas variables de entorno para que las utilizaran los scripts de enlace en función del origen del paquete de implementación (Amazon S3 o Amazon S3 GitHub). Para obtener más información, consulte [Disponibilidad de las variables de entorno para los enlaces](reference-appspec-file-structure-hooks.md#reference-appspec-file-structure-environment-variable-availability). **Aviso de obsolescencia**: el CodeDeploy agente 1.4.0 es la última versión que incluirá instaladores para Windows Server de 32 bits. **Aviso de obsolescencia**: el CodeDeploy agente 1.4.0 es la última versión compatible con Windows Server 2008 R2. **Eliminado**: Support para el CodeDeploy agente en los siguientes Amazon EC2: AMIs Amazon Linux 2014.09, 2016.03, 2016.09 y 2017.03. | | 1.3.2 | 6 de mayo de 2021 | CodeDeploy [El agente 1.3.2 soluciona el problema CVE-2018-1000201, lo que afecta a los hosts Windows que ejecutan el agente.](https://nvd.nist.gov/vuln/detail/CVE-2018-1000201) El CVE cita ruby-ffi, que es una dependencia del agente. CodeDeploy Si su agente se instaló con Amazon EC2 Systems Manager (SSM) y está configurado para actualizarse automáticamente, no es necesario realizar ninguna acción. De lo contrario, es necesario tomar medidas para actualizar manualmente el agente. Para actualizar el agente, siga las instrucciones de la sección [Actualizar el CodeDeploy agente](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-update-windows.html) en Windows Server. **Solucionado**: se produjo un problema al instalar el CodeDeploy agente en Ubuntu 20.04 y versiones posteriores. **Se ha corregido**: un problema intermitente que se producía al extraer archivos comprimidos porque las rutas relativas no se gestionaban correctamente. **Se ha añadido**: compatibilidad con [AWS PrivateLink y puntos de conexión de VPC](https://docs.aws.amazon.com//vpc/latest/userguide/endpoint-services-overview.html) para instancias de Windows. Se han **añadido** mejoras en los AppSpec archivos, tal y como se describe a continuación. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/codedeploy/latest/userguide/codedeploy-agent.html) **Actualizado**: CodeDeploy ahora usa el AWS SDK para Ruby 3.0. | | 1.3.1 | 22 de diciembre de 2020 | **Se ha corregido**: un problema de la versión 1.3.0 que impedía el inicio de las instancias en las instalaciones. | | 1.3.0 | 10 de noviembre de 2020 | Esta versión es obsoleta. **Se ha corregido**: se ha eliminado un certificado caducado que ya no se utilizaba. **Se corrigió**: se eliminó el mensaje de aviso del script de desinstalación del agente utilizado por el agente AWS Systems Manager, lo que facilitó la degradación de un host o una flota a una versión anterior del agente. | | 1.2.1 | 23 de septiembre de 2020 | **Se ha modificado**: se ha actualizado la dependencia de AWS SDK para Ruby de la versión 2 a la versión 3. **Añadido**: Support for IMDSv2. Incluye una alternativa silenciosa en IMDSv1 caso de que las solicitudes IMDSv2 http fallen. **Se ha modificado**: se han actualizado las dependencias de Rake y Rubyzip para los parches de seguridad. **Se ha corregido**: se ha asegurado que un archivo PID vacío devuelva el estado de `No CodeDeploy Agent Running` y se limpie el archivo PID al iniciar el agente. | | 1.1.2 | 4 de agosto de 2020 | **Se ha añadido**: compatibilidad con Ubuntu Server 19.10 y 20.04. **Nota**: La versión 19.10 llegó a su end-of-life fecha y ya no es compatible con Ubuntu o. CodeDeploy **Se ha añadido**: mejoras en la eficiencia de la memoria para Linux y Ubuntu para liberar la memoria reservada de manera más oportuna. **Se ha añadido**: compatibilidad con la “limpieza silenciosa” de Windows Server, que provocaba que el agente no respondiera en algunos casos. **Se ha añadido**: ignorar los directorios que no están vacíos durante la limpieza para evitar errores durante la implementación. **Se agregó**: Support for AWS Local Zone en Los Ángeles (LA). **Agregado**: extraiga la AZ de los metadatos de la instancia para proporcionar compatibilidad con las Zonas AWS Locales. **Se ha añadido**: los usuarios ahora pueden proporcionar su archivo en subdirectorios y no es necesario que lo almacenen en el directorio raíz. **Se ha añadido**: se ha detectado un problema con Rubyzip que podría provocar pérdidas de memoria. Se actualizó el comando unzip para intentar usar primero una utilidad de descompresión instalada en el sistema antes de usar Rubyzip. **Se ha añadido**: `:enable_auth_policy:` como ajuste de configuración del agente. **Se ha modificado**: las advertencias de descompresión ahora se ignoran para que las implementaciones continúen. | | 1.1.0 | 30 de junio de 2020 | **Modificado**: el control de versiones del CodeDeploy agente ahora sigue la convención de control de versiones estándar de Ruby. **Se ha añadido**: nuevo parámetro del comando de instalación y actualización para permitir la instalación de una versión específica del agente desde la línea de comandos. **Eliminado**: se ha eliminado el CodeDeploy agente Auto Updater para Linux y Ubuntu. Para configurar las actualizaciones automáticas del CodeDeploy agente, consulte [Instalar el CodeDeploy agente mediante AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html). | | 1.0.1.1597 | 15 de noviembre de 2018 | **Mejora**: CodeDeploy es compatible con Ubuntu 18.04. **Mejora**: CodeDeploy es compatible con Ruby 2.5. **Mejora**: CodeDeploy admite puntos finales FIPS. Para obtener más información sobre los puntos de conexión de FIPS, consulte [Información general sobre FIPS 140-2](https://aws.amazon.com/compliance/fips/). Para ver los puntos finales con los que se puede utilizar CodeBuild, consulte [CodeDeployregiones](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) y puntos finales. | | 1.0.1.1518 | 12 de junio de 2018 | **Mejora**: se ha corregido un error que provocaba un error cuando el CodeDeploy agente estaba cerrado mientras aceptaba solicitudes de sondeo. **Mejora**: se ha añadido una función de seguimiento del despliegue que evita que el CodeDeploy agente se cierre cuando hay un despliegue en curso. **Mejora**: se ha mejorado el desempeño al eliminar archivos. | | 1.0.1.1458 | 6 de marzo de 2018 | **Nota**: esta versión ya no se admite. Si utiliza esta versión, las implementaciones podrían producir un error. **Mejora**: se han mejorado las validaciones de certificado para admitir más autoridades de confianza. **Mejora**: se ha corregido un problema que provocaba que la CLI local fallara durante una implementación que incluía un evento BeforeInstall del ciclo de vida. **Mejora**: se ha corregido un problema que podía provocar un error en una implementación activa cuando se actualizaba el CodeDeploy agente. | | 1.0.1.1352 | 16 de noviembre de 2017 | **Nota**: esta versión ya no se admite. Si utiliza esta versión, las implementaciones podrían producir un error. **Característica**: Se introdujo una nueva función para probar y depurar una implementación local de EC2/en una máquina o instancia local en la que esté instalado el CodeDeploy agente. | | 1.0.1.1106 | 16 de mayo de 2017 | **Nota**: esta versión ya no se admite. Si utiliza esta versión, las implementaciones podrían producir un error. **Característica**: se introdujo nueva compatibilidad para el tratamiento de contenido en una ubicación de destino que no formaba parte de la revisión de la aplicación de la implementación correcta más reciente. Las opciones de implementación para el contenido existente incluyen ahora conservar el contenido, sobrescribir el contenido o hacer fracasar la implementación. **Mejora**: se hizo que el CodeDeploy agente fuera compatible con la versión 2.9.2 de la (2.9.2). AWS SDK para Ruby aws-sdk-core | | 1.0.1.1095 | 29 de marzo de 2017 | **Nota**: esta versión ya no se admite. Si utiliza esta versión, las implementaciones podrían producir un error. **Mejora**: Se introdujo el soporte para el CodeDeploy agente en la región de China (Beijing). **Mejora**: se puede ejecutar Puppet en instancias de Windows Server cuando las invoca un enlace de evento de ciclo de vida. **Mejora**: se ha mejorado el tratamiento de las operaciones `untar`. | | 1.0.1.1067 | 6 de enero de 2017 | **Nota**: esta versión ya no se admite. Si utiliza esta versión, las implementaciones podrían producir un error. **Mejora**: se han revisado muchos mensajes de error para incluir más causas específicas para los errores de implementación. **Mejora**: se ha corregido un problema que impedía que el CodeDeploy agente identificara la revisión de la aplicación correcta para implementarla durante algunas implementaciones. **Mejora**: se ha revertido el uso de `pushd` y `popd` antes y después de la operación `untar`. | | 1.0.1.1045 | 21 de noviembre de 2016 | **Nota**: esta versión ya no se admite. Si utiliza esta versión, las implementaciones podrían producir un error. **Mejora**: se hizo que el CodeDeploy agente fuera compatible con la versión 2.6.11 de la AWS SDK para Ruby (aws-sdk-core2.6.11). | | 1.0.1.1037 | 19 de octubre de 2016 | **Nota**: esta versión ya no se admite. Si utiliza esta versión, las implementaciones podrían producir un error. El CodeDeploy agente para las instancias de Amazon Linux, RHEL y Ubuntu Server se ha actualizado con el siguiente cambio. Para las instancias de Windows Server, la última versión sigue siendo la 1.0.1.998. **Mejora**: el agente puede determinar ahora qué versión de Ruby está instalada en una instancia para que pueda invocar el script `codedeploy-agent` usando esa versión. | | 1.0.1.1011.1 | 17 de agosto de 2016 | **Nota**: esta versión ya no se admite. Si utiliza esta versión, las implementaciones podrían producir un error. **Mejora**: se han eliminado los cambios introducidos por la versión 1.0.1.1011 debido a problemas de compatibilidad con el shell. Esta versión del agente es funcionalmente equivalente a la versión 1.0.1.998 publicada el 11 de julio de 2016. | | 1.0.1.1011 | 15 de agosto de 2016 | **Nota**: esta versión ya no se admite. Si utiliza esta versión, las implementaciones podrían producir un error. El CodeDeploy agente para las instancias de Amazon Linux, RHEL y Ubuntu Server se ha actualizado con los siguientes cambios. Para las instancias de Windows Server, la última versión sigue siendo la 1.0.1.998.**Característica**: Se ha añadido compatibilidad para invocar al CodeDeploy agente mediante el shell bash en sistemas operativos en los que se utiliza el sistema de inicio systemd.Mejora: se habilitó la compatibilidad con todas las versiones de Ruby 2.x en el CodeDeploy agente y en el actualizador de agentes. CodeDeploy CodeDeploy Los agentes actualizados ya no dependen únicamente de Ruby 2.0. (Ruby 2.0 sigue siendo necesario para las versiones deb y rpm del instalador del CodeDeploy agente). | | 1.0.1.998 | 11 de julio de 2016 | **Nota**: esta versión ya no se admite. Si utiliza esta versión, las implementaciones podrían producir un error. **Mejora**: se ha corregido el soporte para ejecutar el CodeDeploy agente con perfiles de usuario distintos del *root*. La variable denominada `USER` se ha sustituido por `CODEDEPLOY_USER` para evitar conflictos con variables del entorno. | | 1.0.1.966 | 16 de junio de 2016 | **Nota**: esta versión ya no se admite. Si utiliza esta versión, las implementaciones podrían producir un error. **Funcionalidad**: Se introdujo la compatibilidad para ejecutar el CodeDeploy agente con perfiles de usuario distintos del *root*. **Mejora**: se ha corregido la compatibilidad para especificar el número de revisiones de aplicación que desea que el agente de CodeDeploy archive para un grupo de implementaciones. **Mejora**: se hizo que el CodeDeploy agente fuera compatible con la versión 2.3 de la AWS SDK para Ruby (aws-sdk-core 2.3). **Mejora**: se han solucionado los problemas con la codificación UTF-8 durante las implementaciones. **Mejora**: se ha mejorado la precisión durante la identificación de nombres de proceso. | | 1.0.1.950 | 24 de marzo de 2016 | **Nota**: esta versión ya no se admite. Si utiliza esta versión, las implementaciones podrían producir un error. **Característica**: se ha añadido compatibilidad con el proxy de instalación. **Mejora**: se ha actualizado el script de instalación para que no se descargue el CodeDeploy agente si la última versión ya está instalada. | | 1.0.1.934 | 11 de febrero de 2016 | **Nota**: esta versión ya no se admite. Si utiliza esta versión, las implementaciones podrían producir un error. **Característica**: se ha añadido compatibilidad para especificar el número de revisiones de aplicación que desea que el agente de CodeDeploy archive para un grupo de implementaciones. | | 1.0.1.880 | 11 de enero de 2016 | **Nota**: esta versión ya no se admite y podría producir un error en las implementaciones. **Mejora**: se ha hecho que el CodeDeploy agente sea compatible con la versión 2.2 de la AWS SDK para Ruby (aws-sdk-core 2.2). La versión 2.1.2 sigue siendo compatible. | | 1.0.1.854 | 17 de noviembre de 2015 | **Nota**: esta versión ya no se admite. Si utiliza esta versión, las implementaciones podrían producir un error. **Característica**: se ha introducido compatibilidad con el algoritmo hash SHA-256. **Característica**: se ha introducido compatibilidad con el seguimiento de versiones en los archivos `.version`. **Característica**: el ID del grupo de implementaciones ahora está disponible mediante el uso de una variable de entorno. **Mejora**: se agregó soporte para monitorear los registros de los CodeDeploy agentes mediante [Amazon CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatchLogs.html). | Para obtener información relacionada, consulte lo siguiente: + [Determine la versión del CodeDeploy agente](codedeploy-agent-operations-version.md) + [Instale el agente CodeDeploy](codedeploy-agent-operations-install.md) Para ver un historial de las versiones de los CodeDeploy agentes, consulte el [repositorio de versiones en GitHub](https://github.com/aws/aws-codedeploy-agent/releases). ## Administrar el CodeDeploy proceso Todas las distribuciones Linux del CodeDeploy agente (rpm y deb) utilizan [systemd](https://systemd.io/) de forma predeterminada para administrar el proceso del agente. Sin embargo, las distribuciones rpm y deb incluyen scripts de inicio que residen en `/etc/init.d/codedeploy-agent`. En función de la distribución que utilice, cuando utilice un comando como `sudo service codedeploy-agent restart`, es posible que los scripts en `/etc/init.d` se ejecuten para iniciar el proceso del agente, en lugar de permitir que `systemd` administre el proceso. No es aconsejable ejecutar scripts en `/etc/init.d`. Para evitar este problema, en el caso de los sistemas compatibles con `systemd`, recomendamos utilizar la utilidad `systemctl` para cualquier operación de agente en lugar de utilizar el comando `service`. Por ejemplo, para reiniciar el CodeDeploy agente, utilice `sudo systemctl restart codedeploy-agent` en lugar del comando equivalente de la utilidad. `service` ## Limpieza de revisiones de aplicación y archivos de registro El CodeDeploy agente archiva las revisiones y los archivos de registro de las instancias. El CodeDeploy agente limpia estos artefactos para conservar espacio en disco. **Registros de despliegue de las revisiones de la aplicación: puede utilizar la opción:max\$1revision****:** del archivo de configuración del agente para especificar el número de revisiones de la aplicación que se van a archivar introduciendo cualquier número entero positivo. CodeDeploy también archiva los archivos de registro de esas revisiones. El resto se elimina, a excepción del archivo log de la última implementación correcta. Este archivo de registro se conserva siempre, aunque el número de implementaciones que han producido un error sea superior al número de revisiones conservadas. Si no se especifica ningún valor, CodeDeploy conserva las cinco revisiones más recientes además de la revisión actualmente implementada. **CodeDeploy registros**: en el caso de las instancias de Amazon Linux, Ubuntu Server y RHEL, el CodeDeploy agente rota los archivos de registro de la `/var/log/aws/codedeploy-agent` carpeta. El archivo de registro rota a las 00:00:00 (hora de la instancia) cada día. Los archivos de registro se eliminan al cabo de siete días. El patrón de nomenclatura para los archivos de registro movidos es `codedeploy-agent.YYYYMMDD.log`. ## Archivos instalados por el agente CodeDeploy El CodeDeploy agente almacena las revisiones, el historial de despliegue y los scripts de despliegue en el directorio raíz de una instancia. El nombre predeterminado y la ubicación de este directorio es: `'/opt/codedeploy-agent/deployment-root'` para las instancias de Amazon Linux, Ubuntu Server y RHEL. `'C:\ProgramData\Amazon\CodeDeploy'` para las instancias de Windows Server. Puede usar el parámetro **root\$1dir** del archivo de configuración del CodeDeploy agente para configurar el nombre y la ubicación del directorio. Para obtener más información, consulte [Referencia de configuración del agente de CodeDeploy](reference-agent-configuration.md). A continuación se muestra un ejemplo del archivo y de la estructura de directorios bajo el directorio raíz. La estructura supone que hay un número N de grupos de implementación y cada grupo de implementación contiene un número N de implementaciones. ``` |--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 ``` + Las carpetas **Deployment Group ID (ID de grupo de implementaciones)** representan cada uno de sus grupos de implementaciones. El nombre de un directorio de grupo de implementaciones es su ID (por ejemplo, `acde1916-9099-7caf-fd21-012345abcdef`). Cada directorio de grupo de implementaciones contiene un subdirectorio para cada implementación que se ha intentado en dicho grupo de implementaciones. Puede utilizar el comando [batch-get-deployments](https://docs.aws.amazon.com/cli/latest/reference/deploy/batch-get-deployments.html) para buscar un ID de grupo de implementaciones. + Las carpetas **ID de implementación** representan cada implementación en un grupo de implementación. El nombre de cada directorio de implementación es su ID. Cada carpeta contiene: + **bundle.tar**, un archivo comprimido con el contenido de la revisión de la implementación. Utilice una utilidad de descompresión zip si desea ver la revisión. + **deployment-archive**, un directorio que contiene el contenido de la revisión de la implementación. + **logs**, un directorio que contiene un archivo `scripts.log`. Este archivo muestra el resultado de todos los scripts especificados en el archivo de la implementación. AppSpec Si desea buscar la carpeta de una implementación pero no conoce su ID de implementación o de grupo de implementación, puede usar la [AWS CodeDeploy consola](https://console.aws.amazon.com/codedeploy) o el AWS CLI para buscarlos. Para obtener más información, consulte [Ver detalles CodeDeploy de la implementación](deployments-view-details.md). El número máximo predeterminado de las implementaciones que se pueden archivar en un grupo de implementaciones es de cinco. Cuando se alcanza ese número, se archivan las implementaciones futuras y se elimina el archivo más antiguo. Puede usar el ajuste **max\$1revision del** archivo de configuración del CodeDeploy agente para cambiar el valor predeterminado. Para obtener más información, consulte [Referencia de configuración del agente de CodeDeploy](reference-agent-configuration.md). **nota** Si desea recuperar el espacio en disco duro utilizado por las implementaciones archivadas, actualice el valor **max\$1revisions** a un número bajo, como, por ejemplo, 1 o 2. La siguiente implementación elimina las implementaciones archivadas de modo que el número sea igual al especificado. + **deployment-instructions** contiene cuatro archivos de texto para cada grupo de implementaciones: + **[ID grupo de implementaciones]-cleanup**, un archivo de texto con una versión deshacer de cada comando que se ejecuta durante una implementación. Un nombre de archivo de ejemplo es `acde1916-9099-7caf-fd21-012345abcdef-cleanup`. + **[ID de grupo de implementaciones]-install.json**, un archivo JSON creado durante la implementación más reciente. Contiene los comandos que se ejecutan durante la implementación. Un nombre de archivo de ejemplo es `acde1916-9099-7caf-fd21-012345abcdef-install.json`. + **[ID de grupo de implementaciones]\$1last\$1successfull\$1install**, un archivo de texto que muestra el directorio de archivos de la última implementación correcta. Este archivo se crea cuando el CodeDeploy agente ha copiado todos los archivos de la aplicación de despliegue a la instancia. El CodeDeploy agente lo utilizará durante la siguiente implementación para determinar qué `BeforeInstall` scripts ejecutar `ApplicationStop` y cuáles. Un nombre de archivo de ejemplo es `acde1916-9099-7caf-fd21-012345abcdef_last_successfull_install`. + **[ID de grupo de implementaciones]\$1most\$1recent\$1install**, un archivo de texto que muestra el nombre del directorio de archivos de la implementación más reciente. Este archivo se crea cuando los archivos de la implementación se han descargado correctamente. El archivo [ID de grupo de implementaciones]\$1last\$1successfull\$1install se crea después de este archivo, cuando los archivos descargados se copian en su destino final. Un nombre de archivo de ejemplo es `acde1916-9099-7caf-fd21-012345abcdef_most_recent_install`. + **deployment-logs** contiene los archivos de registro siguientes: + Los archivos **codedeploy-agent.aaaammdd.log** se crean para cada día que hay una implementación. Cada archivo de registro contiene información acerca de las implementaciones del día. Estos archivos de registro podrían ser útiles para depurar problemas como un problema de permisos. El archivo de registro se denomina inicialmente `codedeploy-agent.log`. Al día siguiente, se inserta la fecha de sus implementaciones en el nombre del archivo. Por ejemplo, si hoy es 3 de enero de 2018, puede ver información acerca de todas las implementaciones de hoy en `codedeploy-agent.log`. Mañana, 4 de enero de 2018, se cambia el nombre del archivo de registro a `codedeploy-agent.20180103.log`. + **codedeploy-agent-deployments.log** compila el contenido de los `scripts.log` archivos de cada implementación. Los archivos `scripts.log` se encuentran en la subcarpeta `logs` debajo de cada carpeta `Deployment ID`. Las entradas de este archivo van precedidas de un ID de implementación. Por ejemplo, "`[d-ABCDEF123]LifecycleEvent - BeforeInstall`" podría haberse escrito durante una implementación con un ID de `d-ABCDEF123`. Cuando `codedeploy-agent-deployments.log` alcanza su tamaño máximo, el CodeDeploy agente continúa escribiendo en él mientras elimina el contenido antiguo. # Gestión de las operaciones CodeDeploy de los agentes Las instrucciones de esta sección muestran cómo instalar, desinstalar, reinstalar o actualizar el CodeDeploy agente y cómo comprobar que el CodeDeploy agente se está ejecutando. **Topics** + [Compruebe que el CodeDeploy agente se esté ejecutando](codedeploy-agent-operations-verify.md) + [Determine la versión del CodeDeploy agente](codedeploy-agent-operations-version.md) + [Instale el agente CodeDeploy](codedeploy-agent-operations-install.md) + [Actualice el CodeDeploy agente](codedeploy-agent-operations-update.md) + [Desinstale el CodeDeploy agente](codedeploy-agent-operations-uninstall.md) + [Enviar los registros CodeDeploy de los agentes a CloudWatch](codedeploy-agent-operations-cloudwatch-agent.md) # Compruebe que el CodeDeploy agente se esté ejecutando En esta sección, se describen los comandos que se deben ejecutar si sospecha que el CodeDeploy agente ha dejado de ejecutarse en una instancia. **Topics** + [Compruebe que el CodeDeploy agente de Amazon Linux o RHEL se esté ejecutando](#codedeploy-agent-operations-verify-linux) + [Compruebe que el CodeDeploy agente del servidor Ubuntu esté en ejecución](#codedeploy-agent-operations-verify-ubuntu) + [Compruebe que el CodeDeploy agente de Windows Server se esté ejecutando](#codedeploy-agent-operations-verify-windows) ## Compruebe que el CodeDeploy agente de Amazon Linux o RHEL se esté ejecutando Para comprobar si el CodeDeploy agente está instalado y en ejecución, inicie sesión en la instancia y ejecute el siguiente comando: ``` systemctl status codedeploy-agent ``` Si el comando devuelve un error, significa que el CodeDeploy agente no está instalado. Instálelo como se describe en [Instalar el CodeDeploy agente para Amazon Linux o RHEL](codedeploy-agent-operations-install-linux.md). Si el CodeDeploy agente está instalado y en ejecución, debería aparecer un mensaje como`The AWS CodeDeploy agent is running`. Si ve un mensaje similar a `error: No AWS CodeDeploy agent running`, inicie el servicio y ejecute uno por uno los dos comandos siguientes: ``` systemctl start codedeploy-agent ``` ``` systemctl status codedeploy-agent ``` ## Compruebe que el CodeDeploy agente del servidor Ubuntu esté en ejecución Para comprobar si el CodeDeploy agente está instalado y en ejecución, inicia sesión en la instancia y ejecuta el siguiente comando: ``` systemctl status codedeploy-agent ``` Si el comando devuelve un error, significa que el CodeDeploy agente no está instalado. Instálelo como se describe en [Instale el CodeDeploy agente para Ubuntu Server](codedeploy-agent-operations-install-ubuntu.md). Si el CodeDeploy agente está instalado y en ejecución, debería aparecer un mensaje como`The AWS CodeDeploy agent is running`. Si ve un mensaje similar a `error: No AWS CodeDeploy agent running`, inicie el servicio y ejecute uno por uno los dos comandos siguientes: ``` systemctl start codedeploy-agent ``` ``` systemctl status codedeploy-agent ``` ## Compruebe que el CodeDeploy agente de Windows Server se esté ejecutando Para comprobar si el CodeDeploy agente está instalado y en ejecución, inicia sesión en la instancia y ejecuta el siguiente comando: ``` powershell.exe -Command Get-Service -Name codedeployagent ``` Debería ver una salida similar a esta: ``` Status Name DisplayName ------ ---- ----------- Running codedeployagent CodeDeploy Host Agent Service ``` Si el comando devuelve un error, significa que el CodeDeploy agente no está instalado. Instálelo como se describe en [Instale el CodeDeploy agente para Windows Server](codedeploy-agent-operations-install-windows.md). Si `Status` muestra algo distinto de `Running`, inicie el servicio con el comando siguiente: ``` powershell.exe -Command Start-Service -Name codedeployagent ``` Puede reiniciar el servicio con el comando siguiente: ``` powershell.exe -Command Restart-Service -Name codedeployagent ``` Puede detener el servicio con el comando siguiente: ``` powershell.exe -Command Stop-Service -Name codedeployagent ``` # Determine la versión del CodeDeploy agente Puedes determinar la versión del CodeDeploy agente que se ejecuta en tu instancia de dos maneras. En primer lugar, a partir de la versión 1.0.1.854 del CodeDeploy agente, puede ver el número de versión en un `.version` archivo de la instancia. La tabla siguiente muestra la ubicación y un ejemplo de cadena de versión para los distintos sistemas operativos compatibles. | Sistema operativo | Ubicación del archivo | Ejemplo de cadena agent\$1version | | --- | --- | --- | | Amazon Linux y Red Hat Enterprise Linux (RHEL) | /opt/codedeploy-agent/.version | OFFICIAL\$11.0.1.854\$1rpm | | Servidor Ubuntu | /opt/codedeploy-agent/.version | OFFICIAL\$11.0.1.854\$1deb | | Windows Server | C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1.version | OFFICIAL\$11.0.1.854\$1msi | La segunda consiste en ejecutar un comando en una instancia para determinar la versión del agente de CodeDeploy. **Topics** + [Determinación de la versión en Amazon Linux o RHEL](#codedeploy-agent-operations-version-linux) + [Determinación de la versión en Ubuntu Server](#codedeploy-agent-operations-version-ubuntu) + [Determinación de la versión en Windows Server](#codedeploy-agent-operations-version-windows) ## Determinación de la versión en Amazon Linux o RHEL Inicie sesión en la instancia y ejecute el comando siguiente: ``` sudo yum info codedeploy-agent ``` ## Determinación de la versión en Ubuntu Server Inicie sesión en la instancia y ejecute el comando siguiente: ``` sudo dpkg -s codedeploy-agent ``` ## Determinación de la versión en Windows Server Inicie sesión en la instancia y ejecute el comando siguiente: ``` sc qdescription codedeployagent ``` # Instale el agente CodeDeploy Para usarlo CodeDeploy en instancias EC2 o servidores locales, primero se debe instalar el CodeDeploy agente. Se recomienda instalar y actualizar el CodeDeploy agente con. AWS Systems Manager Para obtener más información acerca de Systems Manager, consulte [¿Qué es AWS Systems Manager?](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html). Puede configurar la instalación y las actualizaciones programadas del CodeDeploy agente con Systems Manager en la consola al crear los grupos de despliegue. También puede instalar el CodeDeploy agente directamente desde un bucket de S3 con la línea de comandos. Para obtener información sobre la versión que se recomienda instalar, consulte [Historial de versiones del agente CodeDeploy](codedeploy-agent.md#codedeploy-agent-version-history). **Topics** + [Instale el CodeDeploy agente mediante AWS Systems Manager](codedeploy-agent-operations-install-ssm.md) + [Instale el CodeDeploy agente mediante la línea de comandos](codedeploy-agent-operations-install-cli.md) # Instale el CodeDeploy agente mediante AWS Systems Manager Puede usar Consola de administración de AWS o AWS CLI para instalar el CodeDeploy agente en sus instancias de Amazon EC2 o locales mediante. AWS Systems Manager Puede elegir entre instalar una versión específica o instalar siempre la última versión del agente. Para obtener más información AWS Systems Manager, consulte [Qué es](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html). AWS Systems Manager Se AWS Systems Manager recomienda utilizar el método para instalar y actualizar el CodeDeploy agente. También puede instalar el CodeDeploy agente desde un bucket de Amazon S3. Para obtener más información acerca del uso del enlace de descarga de Amazon S3, consulte [Instale el CodeDeploy agente mediante la línea de comandos](codedeploy-agent-operations-install-cli.md). **Topics** + [Requisitos previos](#install-codedeploy-agent-prereqs) + [Instale el agente CodeDeploy](#download-codedeploy-agent-on-EC2-Instance) ## Requisitos previos Siga los pasos de [Empezar con CodeDeploy](getting-started-codedeploy.md) para configurar los permisos de IAM y la AWS CLI. Si va a instalar el CodeDeploy agente en un servidor local con Systems Manager, debe registrar el servidor local con Amazon EC2 Systems Manager. Para obtener más información, consulte [Configuración de Systems Manager en entornos híbridos](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-managedinstances.html) en la *Guía del usuario de AWS Systems Manager *. ## Instale el agente CodeDeploy Antes de poder usar Systems Manager para instalar el CodeDeploy agente, debe asegurarse de que la instancia está configurada correctamente para Systems Manager. ### Instalación o actualización del agente de SSM En una instancia Amazon EC2, el CodeDeploy agente requiere que la instancia ejecute la versión 2.3.274.0 o posterior. Antes de instalar el CodeDeploy agente, actualice o instale el agente SSM en la instancia si aún no lo ha hecho. El agente SSM viene preinstalado en algunos Amazon AMIs EC2 proporcionados por. AWS Para obtener más información, consulte [Amazon Machine Images (AMIs) con el agente SSM preinstalado](https://docs.aws.amazon.com/systems-manager/latest/userguide/ami-preinstalled-agent.html). **nota** Asegúrese de que el agente también admita el sistema operativo de la CodeDeploy instancia. Para obtener más información, consulte [Sistemas operativos compatibles con el agente CodeDeploy](codedeploy-agent.md#codedeploy-agent-supported-operating-systems). Para obtener información sobre la instalación o actualización del agente de SSM en una instancia con Linux, consulte [Instalación y configuración del agente de SSM en instancias de Linux](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-ssm-agent.html) en la *Guía del usuario de AWS Systems Manager *. Para obtener información acerca de la instalación o la actualización del agente de SSM en una instancia con Windows Server, consulte [Instalación y configuración del agente de SSM en instancias de Windows](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-ssm-win.html) en la *Guía del usuario de AWS Systems Manager *. ### (Opcional) Verificación de los requisitos previos de Systems Manager Antes de usar Systems Manager Run Command para instalar el CodeDeploy agente, compruebe que las instancias cumplen los requisitos mínimos de Systems Manager. Para obtener más información, consulte [Configuración de AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up.html) en la *Guía del usuario de AWS Systems Manager *. ### Instale el CodeDeploy agente Con SSM, puede instalarlo CodeDeploy una vez o programar la instalación de nuevas versiones. Para instalar el CodeDeploy agente, elija el `AWSCodeDeployAgent` paquete siguiendo los pasos que se indican en [Instalar o actualizar paquetes con el AWS Systems Manager distribuidor](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor-working-with-packages-deploy.html). # Instale el CodeDeploy agente mediante la línea de comandos **nota** Se recomienda instalar el CodeDeploy agente con el AWS Systems Manager fin de poder configurar las actualizaciones programadas del agente. Para obtener más información, consulte [Instale el CodeDeploy agente mediante AWS Systems Manager](codedeploy-agent-operations-install-ssm.md). Utilice los siguientes temas para instalar y ejecutar el CodeDeploy agente mediante la línea de comandos. **Topics** + [Instalar el CodeDeploy agente para Amazon Linux o RHEL](codedeploy-agent-operations-install-linux.md) + [Instale el CodeDeploy agente para Ubuntu Server](codedeploy-agent-operations-install-ubuntu.md) + [Instale el CodeDeploy agente para Windows Server](codedeploy-agent-operations-install-windows.md) # Instalar el CodeDeploy agente para Amazon Linux o RHEL Inicie sesión en la instancia y ejecute uno a uno los comandos siguientes. Ejecutar primero el comando `sudo yum update` se considera una práctica recomendada cuando se usa `yum` para instalar paquetes, pero puede omitirlo si no desea actualizar todos sus paquetes. ``` sudo yum update ``` ``` sudo yum install ruby ``` ``` sudo yum install wget ``` (Opcional) Para limpiar la AMI de cualquier información de almacenamiento en caché del agente anterior, ejecute el siguiente script: ``` #!/bin/bash CODEDEPLOY_BIN="/opt/codedeploy-agent/bin/codedeploy-agent" $CODEDEPLOY_BIN stop yum erase codedeploy-agent -y ``` Vaya al directorio de inicio: ``` cd /home/ec2-user ``` **nota** En el comando anterior, `/home/ec2-user` representa el nombre de usuario predeterminado de una instancia de Amazon EC2 de Amazon Linux o RHEL. Si la instancia se creó con una AMI personalizada, el propietario de la AMI puede haber especificado otro nombre de usuario predeterminado. Descargue el instalador del CodeDeploy agente: ``` wget https://bucket-name.s3.region-identifier.amazonaws.com/latest/install ``` *bucket-name*es el nombre del depósito de Amazon S3 que contiene los archivos del kit de CodeDeploy recursos de su región y *region-identifier* es el identificador de su región. Por ejemplo: `https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latest/install` Para obtener una lista de los nombres de buckets e identificadores de región, consulte [Nombres de bucket del kit de recursos por región](resource-kit.md#resource-kit-bucket-names). Defina los permisos de ejecución en el archivo `install`: ``` chmod +x ./install ``` Para instalar la versión más reciente del CodeDeploy agente: + ``` sudo ./install auto ``` Para instalar una versión específica del CodeDeploy agente: + Obtenga una lista de versiones disponibles en su región: ``` aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.rpm$' ``` + Instale una de las versiones: ``` sudo ./install auto -v releases/codedeploy-agent-version.noarch.rpm ``` **nota** AWS admite la última versión secundaria del CodeDeploy agente. Actualmente, la última versión secundaria es la 1.7.x. Para comprobar que el servicio se está ejecutando, ejecute el siguiente comando: ``` systemctl status codedeploy-agent ``` Si el CodeDeploy agente está instalado y en ejecución, debería aparecer un mensaje como`The AWS CodeDeploy agent is running`. Si ve un mensaje similar a `error: No AWS CodeDeploy agent running`, inicie el servicio y ejecute uno por uno los dos comandos siguientes: ``` systemctl start codedeploy-agent ``` ``` systemctl status codedeploy-agent ``` # Instale el CodeDeploy agente para Ubuntu Server **nota** Se recomienda instalar el CodeDeploy agente con AWS Systems Manager para poder configurar las actualizaciones programadas del agente. Para obtener más información, consulte [Instale el CodeDeploy agente mediante AWS Systems Manager](codedeploy-agent-operations-install-ssm.md). **Para instalar el CodeDeploy agente en el servidor Ubuntu** 1. Inicie sesión en la instancia. 1. Introduzca los comandos siguientes, uno tras otro: ``` sudo apt update ``` ``` sudo apt install ruby-full ``` ``` sudo apt install wget ``` 1. Introduzca el siguiente comando: ``` cd /home/ubuntu ``` */home/ubuntu*representa el nombre de usuario predeterminado de una instancia del servidor Ubuntu. Si la instancia se creó con una AMI personalizada, el propietario de la AMI puede haber especificado otro nombre de usuario predeterminado. 1. Introduzca el siguiente comando: ``` wget https://bucket-name.s3.region-identifier.amazonaws.com/latest/install ``` *bucket-name*es el nombre del depósito de Amazon S3 que contiene los archivos del kit de CodeDeploy recursos de su región y *region-identifier* es el identificador de su región. Por ejemplo: `https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latest/install` Para obtener una lista de los nombres de buckets e identificadores de región, consulte [Nombres de bucket del kit de recursos por región](resource-kit.md#resource-kit-bucket-names). 1. Introduzca el siguiente comando: ``` chmod +x ./install ``` 1. Realice una de las siguientes acciones: + Para instalar la última versión del CodeDeploy agente en cualquier versión compatible de Ubuntu Server, *excepto* la 20.04: ``` sudo ./install auto ``` + Para instalar la última versión del CodeDeploy agente en Ubuntu Server 20.04: **nota** Escribir el resultado en un archivo de registro temporal es una solución alternativa que debería utilizarse mientras solucionamos un error conocido en el script `install` de Ubuntu Server 20.04. ``` sudo ./install auto > /tmp/logfile ``` + Para instalar una versión específica del CodeDeploy agente en cualquier versión compatible de Ubuntu Server, *excepto la 20.04*: + Obtenga una lista de versiones disponibles en su región: ``` aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.deb$' ``` + Instale una de las versiones: ``` sudo ./install auto -v releases/codedeploy-agent-###.deb ``` **nota** AWS es compatible con la última versión secundaria del CodeDeploy agente. Actualmente, la última versión secundaria es la 1.7.x. + Para instalar una versión específica del CodeDeploy agente en Ubuntu Server 20.04: + Obtenga una lista de versiones disponibles en su región: ``` aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.deb$' ``` + Instale una de las versiones: ``` sudo ./install auto -v releases/codedeploy-agent-###.deb > /tmp/logfile ``` **nota** Escribir el resultado en un archivo de registro temporal es una solución alternativa que debería utilizarse mientras solucionamos un error conocido en el script `install` de Ubuntu Server 20.04. **nota** AWS admite la última versión secundaria del CodeDeploy agente. Actualmente, la última versión secundaria es la 1.7.x. **Para comprobar que el servicio está en ejecución** 1. Introduzca el siguiente comando: ``` systemctl status codedeploy-agent ``` Si el CodeDeploy agente está instalado y en ejecución, debería aparecer un mensaje como`The AWS CodeDeploy agent is running`. 1. Si ve un mensaje similar a `error: No AWS CodeDeploy agent running`, inicie el servicio y ejecute uno por uno los dos comandos siguientes: ``` systemctl start codedeploy-agent ``` ``` systemctl status codedeploy-agent ``` # Instale el CodeDeploy agente para Windows Server En las instancias de Windows Server, puede usar uno de estos métodos para descargar e instalar el CodeDeploy agente: + Uso AWS Systems Manager (recomendado) + Ejecute una serie de PowerShell comandos de Windows. + Elegir un enlace de descarga directa. + Ejecutar un comando copy de Amazon S3. **nota** La carpeta en la que está instalado el CodeDeploy agente es`C:\Program Data\Amazon\CodeDeploy`. Asegúrese de que no haya nudos de directorio ni enlaces simbólicos en esta ruta. **Topics** + [Uso de Systems Manager](#codedeploy-agent-operations-install-system-manager) + [Utilice Windows PowerShell](#codedeploy-agent-operations-install-windows-powershell) + [Uso de un enlace directo](#codedeploy-agent-operations-install-windows-direct-link) + [Uso de un comando copy de Amazon S3](#codedeploy-agent-operations-install-windows-s3-copy) ## Uso de Systems Manager Siga las instrucciones [Instale el CodeDeploy agente mediante AWS Systems Manager](codedeploy-agent-operations-install-ssm.md) para instalar el CodeDeploy agente. ## Utilice Windows PowerShell Inicia sesión en la instancia y ejecuta los siguientes comandos en Windows PowerShell: 1. Es necesario que todos los scripts y archivos de configuración que se hayan descargado de Internet estén firmados por un editor de confianza. Si se le pide que cambie la política de ejecución, escriba "**Y**". ``` Set-ExecutionPolicy RemoteSigned ``` 1. Carga el AWS Tools for Windows PowerShell. ``` Import-Module AWSPowerShell ``` 1. Cree un directorio en el que se descargue el archivo de instalación del CodeDeploy agente. ``` New-Item -Path "c:\temp" -ItemType "directory" -Force ``` 1. Configure AWS las credenciales mediante los `Initialize-AWSDefaultConfiguration` comandos `Set-AWSCredential` y. Para obtener más información, consulte [Uso de AWS credenciales](https://docs.aws.amazon.com/powershell/latest/userguide/specifying-your-aws-credentials.html) en la *Guía del PowerShell usuario de AWS las herramientas*. 1. Descargue el archivo CodeDeploy de instalación del agente. **nota** AWS es compatible con la última versión secundaria del CodeDeploy agente. Actualmente, la última versión secundaria es la 1.7.x. Para instalar la versión más reciente del CodeDeploy agente: + ``` powershell.exe -Command Read-S3Object -BucketName bucket-name -Key latest/codedeploy-agent.msi -File c:\temp\codedeploy-agent.msi ``` Para instalar una versión específica del CodeDeploy agente: + ``` powershell.exe -Command Read-S3Object -BucketName bucket-name -Key releases/codedeploy-agent-###.msi -File c:\temp\codedeploy-agent.msi ``` *bucket-name*es el nombre del depósito de Amazon S3 que contiene los archivos del kit de CodeDeploy recursos de su región. Por ejemplo, para la región EE.UU. Este (Ohio), *bucket-name* sustitúyala por`aws-codedeploy-us-east-2`. Para obtener una lista de los nombres de los buckets, consulte [Nombres de bucket del kit de recursos por región](resource-kit.md#resource-kit-bucket-names). 1. Ejecute el archivo de instalación del CodeDeploy agente. ``` c:\temp\codedeploy-agent.msi /quiet /l c:\temp\host-agent-install-log.txt ``` Para comprobar que el servicio se está ejecutando, ejecute el siguiente comando: ``` powershell.exe -Command Get-Service -Name codedeployagent ``` Si el CodeDeploy agente se acaba de instalar y no se ha iniciado, después de ejecutar el **Get-Service** comando, en **Estado**, debería ver**Start...**: ``` Status Name DisplayName ------ ---- ----------- Start... codedeployagent CodeDeploy Host Agent Service ``` Si el CodeDeploy agente ya se está ejecutando, después de ejecutar el **Get-Service** comando, en **Estado**, debería ver**Running**: ``` Status Name DisplayName ------ ---- ----------- Running codedeployagent CodeDeploy Host Agent Service ``` ## Uso de un enlace directo Si la configuración de seguridad del navegador de la instancia de Windows Server proporciona los permisos (por ejemplo, para`https://s3.*.amazonaws.com`), puede utilizar un enlace directo a su región para descargar el CodeDeploy agente y, a continuación, ejecutar el instalador manualmente. El enlace es: ``` https://s3.region.amazonaws.com/aws-codedeploy-region/latest/codedeploy-agent.msi ``` ... dónde *region* está la AWS región en la que va a implementar la aplicación. Por ejemplo: ``` https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latest/codedeploy-agent.msi ``` **importante** Obtenga el `.msi` archivo de la misma región que su CodeDeploy aplicación. La elección de una región diferente puede provocar errores de `inconsistent region` en el archivo `codedeploy-agent-log` al ejecutar el archivo `.msi`. ## Uso de un comando copy de Amazon S3 Si AWS CLI está instalado en la instancia, puede usar el comando [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) de Amazon S3 para descargar el CodeDeploy agente y, a continuación, ejecutar el instalador manualmente. Para obtener más información, consulte [Instalar AWS Command Line Interface en Microsoft Windows](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html). El comando de Amazon S3 es: ``` aws s3 cp s3://aws-codedeploy-region/latest/codedeploy-agent.msi codedeploy-agent.msi --region region ``` ... dónde *region* está la AWS región en la que va a implementar la aplicación. Por ejemplo: ``` aws s3 cp s3://aws-codedeploy-af-south-1/latest/codedeploy-agent.msi codedeploy-agent.msi --region af-south-1 ``` # Actualice el CodeDeploy agente Puede configurar las actualizaciones automáticas y programadas del CodeDeploy agente en todos los sistemas operativos compatibles mediante AWS Systems Manager. También puede forzar las actualizaciones en todos los sistemas operativos compatibles ejecutando un comando en una instancia. **Topics** + [Actualizar el CodeDeploy agente en Amazon Linux o RHEL](codedeploy-agent-operations-update-linux.md) + [Actualiza el CodeDeploy agente en el servidor Ubuntu](codedeploy-agent-operations-update-ubuntu.md) + [Actualice el CodeDeploy agente en Windows Server](codedeploy-agent-operations-update-windows.md) # Actualizar el CodeDeploy agente en Amazon Linux o RHEL Para configurar las actualizaciones automáticas y programadas del CodeDeploy agente mediante AWS Systems Manager, siga los pasos que se indican en [Instalar el CodeDeploy agente con AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html). Si quieres forzar una actualización del CodeDeploy agente, inicia sesión en la instancia y ejecuta el siguiente comando: ``` sudo /opt/codedeploy-agent/bin/install auto ``` # Actualiza el CodeDeploy agente en el servidor Ubuntu Para configurar las actualizaciones automáticas y programadas del CodeDeploy agente mediante AWS Systems Manager, siga los pasos que se indican en [Instalar el CodeDeploy agente con AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html). Si quieres forzar una actualización del CodeDeploy agente, inicia sesión en la instancia y ejecuta el siguiente comando: ``` sudo /opt/codedeploy-agent/bin/install auto ``` # Actualice el CodeDeploy agente en Windows Server Puede activar las actualizaciones automáticas del CodeDeploy agente con AWS Systems Manager. Utilice State Manager para configurar una programación de actualización de las instancias de Amazon EC2 o en las instalaciones mediante la creación de una asociación con el Administrador de estados de Systems Manager. También puede actualizar el CodeDeploy agente manualmente desinstalando la versión actual e instalando una más reciente. **Topics** + [Configure la actualización automática CodeDeploy del agente con AWS Systems Manager](#codedeploy-agent-operations-update-windows-ssm) + [Actualice el CodeDeploy agente manualmente](#codedeploy-agent-operations-update-windows-manual) + [(Obsoleto) Actualice el CodeDeploy agente con Windows Server Updater](#codedeploy-agent-operations-update-windows-updater) ## Configure la actualización automática CodeDeploy del agente con AWS Systems Manager Para configurar Systems Manager y activar las actualizaciones automáticas del CodeDeploy agente, siga las instrucciones de [Instalar el CodeDeploy agente mediante AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html). ## Actualice el CodeDeploy agente manualmente Para actualizar el CodeDeploy agente manualmente, puede instalar la última versión desde la CLI o mediante Systems Manager. Siga las instrucciones descritas en [Instalación del agente de CodeDeploy](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install.html). Se recomienda desinstalar las versiones anteriores del CodeDeploy agente siguiendo las instrucciones de [Desinstalar el CodeDeploy agente](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-uninstall.html). ## (Obsoleto) Actualice el CodeDeploy agente con Windows Server Updater **nota** El actualizador de CodeDeploy agentes para Windows Server está obsoleto y no se actualizará a ninguna versión posterior a la 1.0.1.1597. Para habilitar las actualizaciones automáticas del CodeDeploy agente, instale el actualizador de CodeDeploy agentes para Windows Server en instancias nuevas o existentes. El actualizador comprueba periódicamente si existen versiones nuevas. Cuando detecta una versión nueva del agente, el actualizador desinstala la versión actual, si la hay, antes de instalar la última versión. Si una implementación ya está en curso cuando el actualizador detecta una nueva versión, continuará hasta su finalización. Si se intenta iniciar una implementación durante el proceso de actualización, la implementación falla. Si quiere forzar una actualización del CodeDeploy agente, siga las instrucciones que se indican en[Instale el CodeDeploy agente para Windows Server](codedeploy-agent-operations-install-windows.md). En las instancias de Windows Server, puede descargar e instalar el actualizador de CodeDeploy agentes ejecutando PowerShell comandos de Windows, utilizando un enlace de descarga directa o ejecutando un comando de copia de Amazon S3. **Topics** + [Utilice Windows PowerShell](#codedeploy-agent-operations-update-windows-powershell) + [Uso de un enlace directo](#codedeploy-agent-operations-update-windows-direct-link) + [Uso de un comando copy de Amazon S3](#codedeploy-agent-operations-update-windows-s3-copy) ### Utilice Windows PowerShell Inicia sesión en la instancia y ejecuta los siguientes comandos en Windows PowerShell, de uno en uno: ``` Set-ExecutionPolicy RemoteSigned ``` Si se te pide que cambies la política de ejecución, elige **Y** que Windows PowerShell requiera que todos los scripts y archivos de configuración descargados de Internet estén firmados por un editor de confianza. ``` 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*es el nombre del depósito de Amazon S3 que contiene los archivos del kit de CodeDeploy recursos de su región. Por ejemplo, para la región EE.UU. Este (Ohio), *bucket-name* sustitúyala por`aws-codedeploy-us-east-2`. Para obtener una lista de los nombres de los buckets, consulte [Nombres de bucket del kit de recursos por región](resource-kit.md#resource-kit-bucket-names). Si necesita solucionar un error en el proceso de actualización, escriba el siguiente comando para abrir el archivo de registro del actualizador del CodeDeploy agente: ``` notepad C:\ProgramData\Amazon\CodeDeployUpdater\log\codedeploy-agent.updater.log ``` ### Uso de un enlace directo Si la configuración de seguridad del navegador de la instancia de Windows Server proporciona los permisos necesarios (por ejemplo, para ` http://s3.*.amazonaws.com `), puede utilizar un enlace directo para descargar el CodeDeploy actualizador del agente. El enlace es: ``` https://s3.region.amazonaws.com/aws-codedeploy-region/latest/codedeploy-agent-updater.msi ``` ... dónde *region* está la AWS región en la que vas a actualizar la aplicación. Por ejemplo: ``` https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latest/codedeploy-agent-updater.msi ``` ### Uso de un comando copy de Amazon S3 Si AWS CLI está instalado en la instancia, puede usar el comando [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) de Amazon S3 para descargar el actualizador del CodeDeploy agente y, a continuación, ejecutar el instalador manualmente. Para obtener más información, consulte [Instalar AWS Command Line Interface en Microsoft Windows](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html). El comando de Amazon S3 es: ``` aws s3 cp s3://aws-codedeploy-region/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi --region region ``` ... dónde *region* está la AWS región en la que está actualizando la aplicación. Por ejemplo: ``` aws s3 cp s3://aws-codedeploy-af-south-1/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi --region af-south-1 ``` # Desinstale el CodeDeploy agente Puede eliminar el CodeDeploy agente de las instancias cuando ya no lo necesite o cuando desee realizar una instalación nueva. ## Desinstalar el CodeDeploy agente de Amazon Linux o RHEL Para desinstalar el CodeDeploy agente, inicie sesión en la instancia y ejecute el siguiente comando: ``` sudo yum erase codedeploy-agent ``` ## Desinstala el CodeDeploy agente del servidor Ubuntu Para desinstalar el CodeDeploy agente, inicia sesión en la instancia y ejecuta el siguiente comando: ``` sudo dpkg --purge codedeploy-agent ``` ## Desinstale el CodeDeploy agente de Windows Server Para desinstalar el CodeDeploy agente, inicia sesión en la instancia y ejecuta los tres comandos siguientes, de uno en uno: ``` wmic ``` ``` product where name="CodeDeploy Host Agent" call uninstall /nointeractive ``` ``` exit ``` También puedes iniciar sesión en la instancia y, en el **Panel de control**, abrir **Programas y características**, elegir **CodeDeploy Host Agent** y, a continuación, elegir **Desinstalar**. # Enviar los registros CodeDeploy de los agentes a CloudWatch Puede enviar las métricas y los datos de registro del CodeDeploy agente CloudWatch mediante el [ CloudWatch agente unificado](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/UseCloudWatchUnifiedAgent.html) o, más simplemente, el CloudWatch agente. Siga las instrucciones siguientes para instalar el CloudWatch agente y configurarlo para su uso con CodeDeploy los agentes. ## Requisitos previos Antes de empezar, complete las siguientes tareas: + Instale el CodeDeploy agente y asegúrese de que se esté ejecutando. Para obtener más información, consulte [Instale el agente CodeDeploy](codedeploy-agent-operations-install.md) y [Compruebe que el CodeDeploy agente se esté ejecutando](codedeploy-agent-operations-verify.md). + Instale el CloudWatch agente. Para obtener más información, consulte [Instalación del CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance.html). + Añada los siguientes permisos al perfil de instancia de CodeDeploy IAM: + CloudWatchLogsFullAccess + CloudWatchAgentServerPolicy Para obtener más información sobre el perfil de la CodeDeploy instancia, consulte[Paso 4: Crear un perfil de instancia de IAM para las instancias de Amazon EC2](getting-started-create-iam-instance-profile.md). [Empezar con CodeDeploy](getting-started-codedeploy.md) ## Configure el CloudWatch agente para recopilar CodeDeploy registros Puede configurar el CloudWatch agente siguiendo un asistente o creando o editando manualmente un archivo de configuración. **Para configurar el CloudWatch agente mediante el asistente (Linux)** 1. Ejecute el asistente, tal y como se describe en [Ejecutar el asistente de configuración del CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard). 1. En el asistente, cuando se le pida `Do you want to monitor any log files?`, introduzca **1**. 1. Especifique el archivo de registro del CodeDeploy agente de la siguiente manera: 1. Para `Log file path` introducir la ruta del archivo de CodeDeploy registro, por ejemplo:**/var/log/aws/codedeploy-agent/codedeploy-agent.log**. 1. Para `Log group name`, introduzca un nombre de grupo de registro, por ejemplo: **codedeploy-agent-log**. 1. Para `Log stream name`, introduzca un nombre de flujo de registro, por ejemplo: **\$1instance\$1id\$1-codedeploy-agent-log**. 1. Cuando se le pida `Do you want to specify any additional log files?`, introduzca **1**. 1. Especifique los registros de despliegue del CodeDeploy agente, de la siguiente manera: 1. Para `Log file path` introducir la ruta del archivo de registro de CodeDeploy despliegue, por ejemplo:**/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log**. 1. Para `Log group name`, introduzca un nombre de grupo de registro, por ejemplo: **codedeploy-agent-deployment-log**. 1. Para `Log stream name`, introduzca un nombre de flujo de registro, por ejemplo: **\$1instance\$1id\$1-codedeploy-agent-deployment-log**. 1. Cuando se le pida `Do you want to specify any additional log files?`, introduzca **1**. 1. Especifique los registros del actualizador del CodeDeploy agente, de la siguiente manera: 1. Para `Log file path` introducir la ruta del archivo de registro del CodeDeploy actualizador, por ejemplo:. **/tmp/codedeploy-agent.update.log** 1. Para `Log group name`, introduzca un nombre de grupo de registro, por ejemplo: **codedeploy-agent-updater-log**. 1. Para `Log stream name`, introduzca un nombre de flujo de registro, por ejemplo: **\$1instance\$1id\$1-codedeploy-agent-updater-log**. **Para configurar el CloudWatch agente mediante el asistente (Windows)** 1. Ejecute el asistente, tal y como se describe en [Ejecutar el asistente de configuración del CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard). 1. En el asistente, cuando se le pida `Do you want to monitor any customized log files?`, introduzca **1**. 1. Especifique el archivo de CodeDeploy registro de la siguiente manera: 1. Para `Log file path` introducir la ruta o el archivo de registro del CodeDeploy agente, por ejemplo:**C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1log\$1codedeploy-agent-log.txt**. 1. Para `Log group name`, introduzca un nombre de grupo de registro, por ejemplo: **codedeploy-agent-log**. 1. Para `Log stream name`, introduzca un nombre de flujo de registro, por ejemplo: **\$1instance\$1id\$1-codedeploy-agent-log**. 1. Cuando se le pida `Do you want to specify any additional log files?`, introduzca **1**. 1. Especifique los registros de despliegue del CodeDeploy agente, de la siguiente manera: 1. Para `Log file path` introducir la ruta del archivo CodeDeploy de registro de despliegue, por ejemplo:**C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1deployment-logs\$1codedeploy-agent-deployments.log**. 1. Para `Log group name`, introduzca un nombre de grupo de registro, por ejemplo: **codedeploy-agent-deployment-log**. 1. Para `Log stream name`, introduzca un nombre de flujo de registro, por ejemplo: **\$1instance\$1id\$1-codedeploy-agent-deployment-log**. **Para configurar el CloudWatch agente mediante la creación o edición manual de un archivo de configuración (Linux)** 1. Cree o edite el archivo de configuración del CloudWatch agente como se describe en [Crear o editar manualmente el archivo de configuración del CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html). 1. Asegúrese de que el archivo se llame `/opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.json` y de que contenga el siguiente código: ``` ... "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" } ] } } } ... ``` **Para configurar el CloudWatch agente mediante la creación o edición manual de un archivo de configuración (Windows)** 1. Cree o edite el archivo de configuración del CloudWatch agente como se describe en [Crear o editar manualmente el archivo de configuración del CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html). 1. Asegúrese de que el archivo se llame `C:\ProgramData\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent.json` y de que contenga el siguiente código: ``` ... "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" } ] }, ... } }, ... ``` ## Reinicie el CloudWatch agente Tras realizar los cambios, reinicie el CloudWatch agente tal y como se describe en [Iniciar el CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance-fleet.html#start-CloudWatch-Agent-EC2-fleet).