Archivos de especificación de aplicación CodeDeploy (AppSpec) - AWS 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.

Archivos de especificación de aplicación CodeDeploy (AppSpec)

Un archivo de especificación de la aplicación (archivo AppSpec), que es exclusivo de CodeDeploy, es unYAML-formateado oJSON-archivo formateado. El archivo AppSpec se utiliza para administrar cada implementación como una serie de enlaces de eventos de ciclo de vida, que se definen en el archivo.

Para obtener información acerca de cómo crear un archivo AppSpec con el formato correcto, consulteCodeDeploy AppSpec referencia de archivo.

Archivos AppSpec en una plataforma de computación Amazon ECS

Si una aplicación utiliza la plataforma de computación Amazon ECS, el archivo AppSpec puede tener formato YAML o JSON. También se puede escribir directamente en un editor en la consola. El archivo AppSpec se utiliza para especificar lo siguiente:

  • El nombre del servicio Amazon ECS y el nombre del contenedor y el puerto utilizado para dirigir el tráfico hacia el nuevo conjunto de tareas.

  • Las funciones que se van a usar como pruebas de validación.

Puede ejecutar funciones de Lambda de validación después de los eventos del ciclo de vida de implementación. Para obtener más información, consulte AppSpec sección «ganchos» para una implementación de Amazon ECS, AppSpec estructura de archivos para las implementaciones de Amazon ECS y AppSpec Ejemplo de archivo para una implementación de Amazon ECS .

Archivos AppSpec en unAWS Lambdaplataforma de computación

Si una aplicación utiliza la aplicaciónAWSPlataforma de computación Lambda, el archivo AppSpec puede tener formato YAML o JSON. También se puede escribir directamente en un editor en la consola. El archivo AppSpec se utiliza para especificar lo siguiente:

  • La versión de la función de AWS Lambda que se debe implementar.

  • Las funciones que se van a usar como pruebas de validación.

Puede ejecutar funciones de Lambda de validación después de los eventos del ciclo de vida de implementación. Para obtener más información, consulte AppSpec sección de «ganchos» para una implementación de AWS Lambda.

Archivos AppSpec en una plataforma de computación EC2/On-Premises

Si una aplicación utiliza la plataforma de computación EC2/On-Premises, el archivo AppSpec siempre tiene el formato YAML. El archivo AppSpec se utiliza para lo siguiente:

  • Asignar los archivos de origen de la revisión de la aplicación a sus destinos en la instancia.

  • Especificar permisos personalizados para los archivos implementados.

  • Especificar los scripts que se van a ejecutar en cada instancia en las distintas fases del proceso de implementación.

Puede ejecutar scripts en una instancia después de muchos de los eventos individuales del ciclo de vida de implementación. CodeDeploy solo ejecuta los scripts especificados en el archivo, pero esos scripts pueden llamar a otros scripts en la instancia. Puede ejecutar cualquier tipo de script, siempre y cuando sea compatible con el sistema operativo que se ejecuta en las instancias. Para obtener más información, consulte AppSpec Sección de «enganches» para una implementación local de EC2/.

Cómo utiliza el agente de CodeDeploy el archivo AppSpec

Durante la implementación, el agente de CodeDeploy busca el nombre del evento actual en lahookssección del archivo AppSpec. Si el evento no se encuentra, el agente de CodeDeploy va al siguiente paso. Si el evento se encuentra, el agente de CodeDeploy recupera la lista de scripts que hay que ejecutar. Los scripts se ejecutan de forma secuencial, en el orden en que aparecen en el archivo. El estado de cada script se registra en el archivo de registro del agente de CodeDeploy de la instancia.

Si un script se ejecuta correctamente, devuelve un código de salida de 0 (cero).

nota

El agente CodeDeploy no se utiliza en unAWSLambda o una implementación de Amazon ECS.

Durante laInstalar, el agente de CodeDeploy utiliza las asignaciones definidas en elfilesdel archivo AppSpec para determinar las carpetas o los archivos que hay que copiar de la revisión a la instancia.

Si el agente de CodeDeploy instalado en el sistema operativo no coincide con lo que se indica en el archivo AppSpec, la implementación falla.

Para obtener información sobre los archivos de registro del agente de CodeDeploy, consulteTrabajando con el CodeDeploy agente.