CodeDeploy AppSpec referencia de archivo - AWS CodeDeploy
AppSpec archivos en una plataforma ECS informática de Amazon AppSpec archivos en una plataforma de AWS Lambda cómputoAppSpec archivos en una plataforma EC2 informática /localAppSpec Espaciado de archivos

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 AppSpec referencia de archivo

Esta sección se incluye solo como referencia. Para obtener una visión general conceptual del AppSpec archivo, consulteApplication Specification Files.

El archivo de especificaciones de la aplicación (AppSpec archivo) es un archivo YAMLcon formato o con JSON formato que se utiliza CodeDeploy para gestionar una implementación.

nota

El AppSpec archivo de una implementación de EC2 /On-Premises debe tener un nombreappspec.yml, a menos que vaya a realizar una implementación local. Para obtener más información, consulte Creación de una implementación local.

Temas

AppSpec archivos en una plataforma ECS informática de Amazon

En el caso de las aplicaciones de la plataforma ECS informática de Amazon, el AppSpec archivo se utiliza CodeDeploy para determinar:

  • Tu archivo de definición de ECS tareas de Amazon. Esto se especifica ARN en las TaskDefinition instrucciones del AppSpec archivo.

  • El contenedor y el puerto en el conjunto de tareas de sustitución donde el Equilibrador de carga de aplicación o el Equilibrador de carga de red redirige tráfico durante una implementación. Esto se especifica con la LoadBalancerInfo instrucción del AppSpec archivo.

  • Información opcional sobre tu ECS servicio de Amazon, como la versión de plataforma en la que se ejecuta, sus subredes y sus grupos de seguridad.

  • Funciones Lambda opcionales que se ejecutan durante los enlaces que se corresponden con los eventos del ciclo de vida durante una implementación de AmazonECS. Para obtener más información, consulte AppSpec sección «ganchos» para una ECS implementación de Amazon.

AppSpec archivos en una plataforma de AWS Lambda cómputo

En el AWS caso de las aplicaciones de la plataforma de procesamiento Lambda, el AppSpec archivo se utiliza CodeDeploy para determinar:

  • Qué versión de función de Lambda se debe implementar.

  • Qué funciones de Lambda se van a usar como pruebas de validación.

Un AppSpec archivo puede estar formateado o YAML formateado. JSON También puede introducir el contenido de un AppSpec archivo directamente en la CodeDeploy consola al crear una implementación.

AppSpec archivos en una plataforma EC2 informática /local

Si la aplicación utiliza la plataforma informática EC2 YAML /On-Premises, el AppSpec archivo debe tener un nombre de archivo con formato appspec.yml y debe colocarse en la raíz de la estructura de directorios del código fuente de la aplicación. De lo contrario, las implementaciones producirán un error. Lo utiliza para determinar: CodeDeploy

  • Qué debe instalar en sus instancias desde la revisión de su aplicación en Amazon S3 o GitHub.

  • Los enlaces de eventos del ciclo de vida que se deben ejecutar en respuesta a los eventos del ciclo de vida de la implementación.

Una vez completado el AppSpec archivo, lo agrupa, junto con el contenido que se va a implementar, en un archivo de almacenamiento (zip, tar o tar comprimido). Para obtener más información, consulte Trabajar con revisiones de aplicaciones para CodeDeploy.

nota

Los formatos de archivo tar y tar comprimido (.tar y .tar.gz) no son compatibles con las instancias de Windows Server.

Cuando tengas un archivo empaquetado (conocido CodeDeploy como revisión), lo subes a un bucket de Amazon S3 o a un repositorio de Git. A continuación, se utiliza CodeDeploy para implementar la revisión. Para obtener instrucciones, consulte Cree una implementación con CodeDeploy.

El archivo appspec.yml de una implementación de EC2 una plataforma informática local se guarda en el directorio raíz de la revisión. Para obtener más información, consulte Agregue un AppSpec archivo para una implementación local de EC2/ y Planifique una revisión para CodeDeploy.

AppSpec Espaciado de archivos

El siguiente es el formato correcto para el espaciado de AppSpec archivos. Los números entre corchetes indican el número de espacios que debe aparecer entre los elementos. Por ejemplo, [4] significa insertar cuatro espacios entre los elementos. CodeDeploy genera un error que puede ser difícil de depurar si las ubicaciones y el número de espacios de un AppSpec archivo no son correctos.

version:[1]version-number
os:[1]operating-system-name
files:
[2]-[1]source:[1]source-files-location
[4]destination:[1]destination-files-location
permissions:
[2]-[1]object:[1]object-specification
[4]pattern:[1]pattern-specification
[4]except:[1]exception-specification
[4]owner:[1]owner-account-name
[4]group:[1]group-name
[4]mode:[1]mode-specification
[4]acls: 
[6]-[1]acls-specification 
[4]context:
[6]user:[1]user-specification
[6]type:[1]type-specification
[6]range:[1]range-specification
[4]type:
[6]-[1]object-type
hooks:
[2]deployment-lifecycle-event-name:
[4]-[1]location:[1]script-location
[6]timeout:[1]timeout-in-seconds
[6]runas:[1]user-name

A continuación, se muestra un ejemplo de un archivo correctamente espaciado AppSpec :

version: 0.0
os: linux
files:
  - source: /
    destination: /var/www/html/WordPress
hooks:
  BeforeInstall:
    - location: scripts/install_dependencies.sh
      timeout: 300
      runas: root
  AfterInstall:
    - location: scripts/change_permissions.sh
      timeout: 300
      runas: root
  ApplicationStart:
    - location: scripts/start_server.sh
    - location: scripts/create_test_db.sh
      timeout: 300
      runas: root
  ApplicationStop:
    - location: scripts/stop_server.sh
      timeout: 300
      runas: root

Para obtener más información sobre el espaciado, consulte la YAMLespecificación.