CodeDeploy archivos de especificación de la aplicación (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.

CodeDeploy archivos de especificación de la aplicación (AppSpec)

Un archivo de especificaciones de la aplicación (AppSpec archivo), que es exclusivo de CodeDeploy, es un archivo con formato YAML o con formato JSON. El AppSpec archivo se usa para administrar cada implementación como una serie de enlaces de eventos del ciclo de vida, que se definen en el archivo.

Para obtener información sobre cómo crear un AppSpec archivo bien formado, consulteCodeDeploy AppSpec referencia de archivo.

AppSpec archivos en una plataforma informática Amazon ECS

Si su aplicación utiliza la plataforma informática Amazon ECS, el AppSpec archivo se puede formatear con YAML o JSON. También se puede escribir directamente en un editor en la consola. El AppSpec archivo se utiliza para especificar:

  • El nombre del servicio de 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 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 .

AppSpec archivos en una plataforma AWS Lambda informática

Si la aplicación utiliza la plataforma de procesamiento AWS Lambda, el AppSpec archivo se puede formatear con YAML o JSON. También se puede escribir directamente en un editor en la consola. El AppSpec archivo se utiliza para especificar:

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

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

Puede ejecutar funciones 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.

AppSpec archivos en una plataforma informática local EC2/

Si su aplicación utiliza la plataforma informática local EC2, el archivo siempre tiene formato YAML. AppSpec El archivo se utiliza para: AppSpec

  • 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 la implementación. CodeDeploy ejecuta solo los scripts especificados en el archivo, pero esos scripts pueden llamar a otros scripts de 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 usa el CodeDeploy agente el AppSpec archivo

Durante el despliegue, el CodeDeploy agente busca el nombre del evento actual en la sección de enlaces del AppSpec archivo. Si no se encuentra el evento, el CodeDeploy agente pasa al siguiente paso. Si se encuentra el evento, el CodeDeploy agente recupera la lista de scripts que se van a 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 CodeDeploy agente de la instancia.

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

nota

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

Durante el evento de instalación, el CodeDeploy agente usa las asignaciones definidas en la sección de archivos del AppSpec archivo para determinar qué carpetas o archivos copiar de la revisión a la instancia.

Si el CodeDeploy agente instalado en el sistema operativo no coincide con lo que aparece en el AppSpec archivo, se produce un error en la implementación.

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