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.

La versión mínima admitida del CodeDeploy agente es la 1.6.0.

nota

El CodeDeploy agente solo es necesario si se implementa en una plataforma informática local 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, 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
• Protocolo de comunicación y puerto para el CodeDeploy agente
• Historial de versiones del agente CodeDeploy
• Administrar el CodeDeploy proceso
• Limpieza de revisiones de aplicación y archivos de registro
• Archivos instalados por el agente CodeDeploy
• Gestión de las operaciones CodeDeploy de los agentes

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 pueda adaptarlo 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:

• Microsoft Windows Server 2022, 2019

• Red Hat Enterprise Linux (RHEL) 9.x, 8.x, 7.x

• Servidor Ubuntu 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 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.6.0.

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.

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	Detalles
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 posibilidad de recurrir a IMDSv1 cuando se produzcan errores en el IMDSv2. El valor predeterminado es (habilita la alternativa). false Para obtener más información, consulte la referencia de configuración CodeDeploy del agente. Se agregó: Support para el sistema operativo Red Hat Enterprise Linux 9 (RHEL 9). Añadido: Support para 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 El agente 1.3.2 soluciona el problema CVE-2018-1000201, lo que afecta a los hosts Windows que ejecutan el agente. 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. Ahora puede especificar un nombre de archivo personalizado para el AppSpec archivo al crear una implementación local. Para obtener más información, consulte Cree una implementación local. El AppSpec archivo ahora puede tener una extensión de .yaml archivo. Ahora puede sobrescribir los archivos desplegados mediante una nueva file_exists_behavior configuración opcional en el AppSpec archivo. Para obtener más información, consulte AppSpec Sección de «archivos» (solo para despliegues de EC2/on-premise). 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 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 for 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 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.
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 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 for 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 (Pekín). 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 for 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 for 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 for 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.

Para obtener información relacionada, consulte lo siguiente:

• Determine la versión del CodeDeploy agente

• Instale el agente CodeDeploy

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

Administrar el CodeDeploy proceso

Todas las distribuciones Linux del CodeDeploy agente (rpm y deb) utilizan systemd 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_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 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_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 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 o el AWS CLI para buscarlos. Para obtener más información, consulte Ver detallesCodeDeploy de 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 utilizar 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 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]_last_successfull_install, 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]_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 de grupo de implementaciones]_last_successfull_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 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.