Trabajando con el CodeDeploy agente - AWS CodeDeploy
Sistemas operativos compatibles con el agente CodeDeploy Protocolo de comunicación y puerto para el CodeDeploy agenteHistorial de versiones del CodeDeploy agenteAdministrar 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

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

nota

El CodeDeploy agente solo es necesario si se implementa en una plataforma informática EC2 /On-Premises. El agente no es necesario para las implementaciones que utilizan la plataforma de cómputo 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 EC2 AMI operativos Amazon compatibles

El CodeDeploy agente se ha probado en los siguientes sistemas EC2 AMI operativos de Amazon:

  • Amazon Linux 2023 (ARMx86)

  • Amazon Linux 2 (ARMx86)

  • Microsoft Windows Server 2022, 2019

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

  • Servidor Ubuntu 22.04LTS, 20.04, 18.04, LTS 16.04 LTS LTS

El CodeDeploy agente está disponible como código abierto para que lo adapte a sus necesidades. Se puede utilizar con otros sistemas EC2 AMI operativos de Amazon. 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, 20.04 LTS 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 a HTTPS través del puerto 443.

Cuando el CodeDeploy agente se ejecute en una EC2 instancia, utilizará el punto final de EC2metadatos 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 CodeDeploy agente

Sus instancias deben ejecutar una versión compatible del CodeDeploy agente. La versión mínima admitida actualmente es la 1.7.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.

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 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 CodeDeploy del agente.

Se agregó: Support para el sistema operativo Red Hat Enterprise Linux RHEL 9 (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.04LTS, 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 los siguientes Amazon EC2AMIs: 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 está dirigido a -2018-1000201, lo que afecta a los hosts Windows que ejecutan CVE el agente. CVECita 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 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 agregó: Support AWS PrivateLink y VPC puntos finales 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 Creación de 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 «archivos» (EC2/Solo implementaciones locales).

Actualizado: CodeDeploy ahora usa la versión 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.

Corregido: Se ha eliminado el mensaje de aviso del script de desinstalación del agente que utilizaba AWS Systems Manager, lo que facilitaba 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 for Ruby de la versión 2 a la versión 3.

Añadido: Support forIMDSv2. 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.

Corregido: asegúrese de que un PID archivo vacío devuelva el estado del PID archivo No CodeDeploy Agent Running y lo limpie 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 FIPS puntos finales. Para obtener más información sobre los FIPS puntos finales, consulte la descripción general del FIPS140-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 el local CLI 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 de EC2 /On-Premises 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 de la AWS SDK for Ruby (2.9.2). 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 y Ubuntu Server se ha actualizado con el siguiente cambio. RHEL 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 y Ubuntu Server se ha actualizado con los siguientes cambios. RHEL 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 los 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 la aplicación que se desea que el CodeDeploy agente archive para un grupo de despliegue.

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 corrigieron los problemas relacionados con la codificación UTF -8 durante los despliegues.

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.

Funcionalidad: Se ha introducido el soporte para especificar el número de revisiones de la aplicación que se desea que el CodeDeploy agente archive para un grupo de despliegue.

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 hizo que el CodeDeploy agente fuera 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 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

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 Amazon Linux, Ubuntu Server e RHEL instancias, 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 Amazon Linux, Ubuntu Server e RHEL instancias.

'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 usar el batch-get-deploymentscomando 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 AppSpec archivo de la implementación.

    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 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 implementación] -install.json, un JSON archivo 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 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_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.