View a markdown version of this page

Trabajando con el CodeDeploy agente - AWS CodeDeploy
Sistemas operativos compatibles con el agente CodeDeployProtocolo de comunicación y puerto para el CodeDeploy agenteHistorial de versiones del agente CodeDeployAdministrar el CodeDeploy procesoLimpieza de revisiones de aplicación y archivos de registroArchivos instalados por el agente CodeDeploy

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

importante

La versión 2.0.0 del CodeDeploy agente se está implementando en todas las regiones Regiones de AWS y es posible que aún no esté disponible en todas las regiones. Se trata de una actualización opcional que, por el momento, solo se puede instalar mediante la línea de comandos. Para actualizar a la versión 2.0.0, consulte. Instale el CodeDeploy agente mediante la línea de comandos

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 admite activamente la última versión secundaria del CodeDeploy agente. Para ver la última versión publicada, consulteHistorial de versiones del agente CodeDeploy.

nota

El CodeDeploy agente solo es necesario si se implementa en una plataforma EC2/On-Premises informática. 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, consulteCodeDeploy referencia de configuración del agente.

Para obtener más información sobre cómo trabajar con el CodeDeploy agente, como los pasos para instalar, actualizar y verificar las versiones, consulteGestión de las operaciones CodeDeploy de los agentes.

Temas

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 (x86_64, aarch64)

  • Amazon Linux 2 (x86_64, aarch64)

  • Red Hat Enterprise Linux (RHEL) 8, 9, 10 (x86_64, aarch64)

  • Oracle Linux 8, 9, 10 (x86_64, aarch64)

  • Rocky Linux 9, 10 (x86_64, aarch64)

  • CentOS Stream 9, 10 (x86_64, aarch64)

  • SLES 15 (x86_64, aarch64)

  • Debian 11, 12, 13 (x86_64, aarch64)

  • Servidor Ubuntu 16.04 LTS, 18.04 LTS, 20.04 LTS, 22.04 LTS, 24.04 LTS, 25.04, 26.04 LTS (x86_64, aarch64)

  • Windows Server 2016, 2019, 2022, 2025 (x86_64)

nota

Las siguientes plataformas se han probado únicamente en la versión 2.0.0 del CodeDeploy agente: Windows Server 2025, RHEL 10, Oracle Linux 8, 9, 10, Rocky Linux 9, 10, CentOS Stream 9, 10, SLES 15, Debian 11, 12, 13 y Ubuntu Server 24.04, 25.04, 26.04.

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 en GitHub.

Sistemas operativos en las instalaciones compatibles

El CodeDeploy agente se ha probado en los siguientes sistemas operativos locales:

  • Windows Server 2016, 2019, 2022, 2025 (x86_64)

  • Red Hat Enterprise Linux (RHEL) 8, 9, 10 (x86_64, aarch64)

  • Oracle Linux 8, 9, 10 (x86_64, aarch64)

  • Rocky Linux 9, 10 (x86_64, aarch64)

  • CentOS Stream 9, 10 (x86_64, aarch64)

  • SLES 15 (x86_64, aarch64)

  • Debian 11, 12, 13 (x86_64, aarch64)

  • Servidor Ubuntu 16.04 LTS, 18.04 LTS, 20.04 LTS, 22.04 LTS, 24.04 LTS, 25.04, 26.04 LTS (x86_64, aarch64)

nota

Las siguientes plataformas se han probado únicamente en la versión 2.0.0 del CodeDeploy agente: Windows Server 2025, RHEL 10, Oracle Linux 8, 9, 10, Rocky Linux 9, 10, CentOS Stream 9, 10, SLES 15, Debian 11, 12, 13 y Ubuntu Server 24.04, 25.04, 26.04.

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

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.

importante

La versión 2.0.0 del CodeDeploy agente se está implementando en todas las regiones Regiones de AWS y es posible que aún no esté disponible en todas las regiones. Se trata de una actualización opcional que, por el momento, solo se puede instalar mediante la línea de comandos. Para actualizar a la versión 2.0.0, consulte. Instale el CodeDeploy agente mediante la línea de comandos

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

2.0.0

15 de julio de 2026

Modificado: el CodeDeploy agente ahora es Rust-based y se envía como un único binario nativo autónomo. Se ha eliminado la dependencia del tiempo de ejecución de Ruby. Ya no se necesita Ruby para instalar o ejecutar el agente. De forma predeterminada, el comportamiento del agente es compatible con la versión 1.8.x; los archivos de configuración existentes, el AppSpec manejo, la semántica de los enlaces del ciclo de vida, el diseño en disco y los resultados de la implementación no cambian, a menos que se indique lo siguiente.

Se ha añadido una mayor compatibilidad con los sistemas operativos, que incluye Windows Server 2025, RHEL 10 y Ubuntu Server 26.04, además de distribuciones de Linux y variantes de ARM (aarch64) adicionales. Para ver la lista completa de plataformas probadas con esta versión, consulte. Sistemas operativos compatibles con el agente CodeDeploy

Se agregó: un codedeploy-agent update comando para la actualización automática del agente bajo demanda.

Se agregó: un puerto de comandos local. Se trata de una interfaz de administración TCP opcional que solo escucha la dirección de bucle invertido (127.0.0.1) para consultar el estado del agente e inyectar comandos localmente. Está deshabilitada de forma predeterminada y habilitada con. enable_command_port

Modificado: el comando de despliegue local ahora escodedeploy-agent deploy-local. El codedeploy-local comando sigue disponible por motivos de compatibilidad con versiones anteriores. Se conservan todas las opciones de comando y se siguen admitiendo las rutas locales, Amazon S3 (s3://) y las fuentes de GitHub paquetes.

Modificado: en Linux, el agente es administrado por una unidad systemd nativa (codedeploy-agent.service); el script SysV init.d ya no está instalado. Se usa para administrar el systemctl agente.

Modificado (seguridad): la verificación del certificado TLS siempre está habilitada y los volcados principales están deshabilitados de forma predeterminada.

Se agregó: configuración de refuerzo opcional que puede habilitar para cumplir con sus propios requisitos de seguridad. Cada configuración está desactivada de forma predeterminada y usted habilita las que desee de forma individual. Puede rechazar los paquetes que contengan enlaces simbólicos, cambios de ruta o permisos no seguros; restringir el entorno de los enlaces de eventos del ciclo de vida y restringir los permisos de los directorios de agentes y los archivos de registro. Puede consultar la lista completa e CodeDeploy referencia de configuración del agente.

Modificado: el script de instalación por línea de comandos ahora está escrito en Bash (anteriormente Ruby). Requiere una de las dos opciones. curl wget

Modificado: el script de instalación de la versión 2.0.x se publica con el latestv2/ prefijo en los buckets regionales. aws-codedeploy-region-identifier El latest/ prefijo sigue siendo el script de instalación de la versión 1.8.x.

Eliminados: el ajuste de ssl_verify_peer configuración y las claves de configuración de Ruby ProcessManager .

Importante: Actualmente no existe una ruta de actualización automática de la versión 1.8.x a la 2.0.0. Para actualizar a la 2.0.0, ejecute el script regional manualmente. latestv2/install Para obtener instrucciones, consulte Instale el CodeDeploy agente mediante la línea de comandos.

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 alternativa a IMDSv1 cuando se produzcan errores en IMDSv2. El valor predeterminado es false (habilita la alternativa). Para obtener más información, consulte la referencia de configuración del CodeDeploy agente.

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

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

importante

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 las siguientes AMI de Amazon EC2: Amazon Linux 2014.09, 2016.03, 2016.09 y 2017.03.

1.3.2

6 de mayo de 2021
importante

CodeDeploy direcciones del agente 1.3.2 que afectan a los hosts Windows que ejecutan el agente. 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 Actualizar el CodeDeploy agente 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 para instancias de Windows.

Se han añadido mejoras en los AppSpec archivos, tal y como se describe a continuación.

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
importante

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.

Se ha añadido: compatibilidad con IMDSv2. Incluye una alternativa silenciosa a IMDSv1 si las solicitudes HTTP de IMDSv2 fallan.

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 ha llegado a su fecha de fin de vida útil y Ubuntu o ya no la admiten. 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.

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. Para ver los puntos finales con los que se puede utilizar CodeBuild, consulte CodeDeployRegiones 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 EC2/On-Premises implementación 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 ha hecho que el CodeDeploy agente sea compatible con la versión 2.9.2 AWS SDK para Ruby (aws-sdk-core 2.9.2).

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 AWS SDK para Ruby (aws-sdk-core 2.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 ha hecho que el CodeDeploy agente sea compatible con la versión 2.3 AWS SDK para Ruby (aws-sdk-core 2.3).

Mejora: se corrigieron los problemas de codificación durante las implementaciones UTF-8 .

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 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 introdujo el soporte para 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.

Para obtener información relacionada, consulte lo siguiente:

Para ver un historial de las versiones de los CodeDeploy agentes, consulte el repositorio de versiones en GitHub.

Administrar el CodeDeploy proceso

El CodeDeploy agente usa systemd para administrar el proceso del agente en todas las distribuciones de Linux compatibles.

Para la versión 2.0.x y posteriores, el agente solo incluye una unidad nativa de systemd (). codedeploy-agent.service No hay ningún script. /etc/init.d/codedeploy-agent systemctlUtilícelo para administrar el agente o invoque el binario directamente constart, stoprestart, o status subcomandos.

Para la versión 1.8.x y anteriores, las distribuciones rpm y deb vienen con los scripts de inicio en. /etc/init.d/codedeploy-agent En los sistemas compatibles con systemd, si se utiliza el service comando, es posible que se ejecuten los scripts init.d de forma inadvertida en lugar de permitir que systemd gestione el proceso. Utilícelo para las operaciones del agente a fin systemctl de evitar este problema.

Para administrar el CodeDeploy agente, utilice la systemctl utilidad:

sudo systemctl start codedeploy-agent
sudo systemctl stop codedeploy-agent
sudo systemctl restart codedeploy-agent
sudo systemctl status codedeploy-agent

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_revision: 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 se rota a las 00:00:00 (hora de la instancia) todos los días o cuando el archivo alcanza los 64 MB, lo que ocurra primero. Si se produce una segunda rotación el mismo día, el agente añade un sufijo numérico (por ejemplo,). codedeploy-agent.20260715.1.log El agente elimina los archivos de registro después 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_dir 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 CodeDeploy referencia de configuración del agente.

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 para buscar un ID de grupo de implementación.

  • 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 o el AWS CLI para buscarlos. Para obtener más información, consulte Ver detalles CodeDeploy de la implementación.

    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_revision del archivo de configuración del CodeDeploy agente para cambiar el valor predeterminado. Para obtener más información, consulte CodeDeploy referencia de configuración del agente.

    nota

    Si desea recuperar el espacio en disco duro utilizado por las implementaciones archivadas, actualice el valor max_revisions a un número bajo, como, por ejemplo, 1 o 2. La siguiente implementación eliminará las implementaciones archivadas para que el número sea igual al número que especificó.

  • deployment-instructions contiene cuatro archivos de texto para cada grupo de implementaciones:

    • [ID de grupo de implementación] -cleanup, un archivo de texto con una versión para 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 del grupo de despliegue] _last_successful_install, un archivo de texto que muestra el directorio de archivos de la última implementación exitosa. Este archivo se crea cuando el CodeDeploy agente ha copiado todos los archivos de la aplicación de despliegue en 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_successful_install.

    • [ID de grupo de implementaciones]_most_recent_install, 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 del grupo de despliegue] _last_successful_install 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 archivos scripts.log para 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.