CodeDeploy file delle specifiche dell'applicazione (AppSpec)

Un file di specifiche dell'applicazione (AppSpec file), che è unico per CodeDeploy, è un file in formato YAML o in formato JSON. Il AppSpec file viene utilizzato per gestire ogni distribuzione come una serie di hook di eventi del ciclo di vita, definiti nel file.

Per informazioni su come creare un file ben formato AppSpec , vedere. CodeDeploy AppSpec riferimento al file

AppSpec file su una piattaforma di elaborazione Amazon ECS

Se l'applicazione utilizza la piattaforma di calcolo Amazon ECS, il AppSpec file può essere formattato con YAML o JSON. Può anche essere digitato direttamente in un editor nella console. Il AppSpec file viene utilizzato per specificare:

• Il nome del servizio Amazon ECS e il nome e la porta del container utilizzati per indirizzare il traffico verso il nuovo set di attività.

• Le funzioni da utilizzare come test di convalida.

È possibile eseguire le funzioni di convalida Lambda dopo gli eventi del ciclo di vita della distribuzione. Per ulteriori informazioni, consulta AppSpec sezione 'hook' per una distribuzione Amazon ECS, AppSpec struttura dei file per le distribuzioni di Amazon ECS e AppSpec Esempio di file per una distribuzione Amazon ECS .

AppSpec file su una piattaforma di elaborazione AWS Lambda

Se l'applicazione utilizza la piattaforma di calcolo AWS Lambda, il AppSpec file può essere formattato con YAML o JSON. Può anche essere digitato direttamente in un editor nella console. Il AppSpec file viene utilizzato per specificare:

• La versione AWS Lambda della funzione da implementare.

• Le funzioni da utilizzare come test di convalida.

È possibile eseguire le funzioni di convalida Lambda dopo gli eventi del ciclo di vita della distribuzione. Per ulteriori informazioni, consulta AppSpec sezione 'hooks' per una distribuzione AWS Lambda.

AppSpec file su una piattaforma di elaborazione EC2/on-premise

Se l'applicazione utilizza la piattaforma di calcolo EC2/on-premise, il file è sempre in formato YAML. AppSpec Il file viene utilizzato per: AppSpec

• Mappare i file sorgente nella revisione dell'applicazione nelle loro destinazioni sull'istanza.

• Specificare autorizzazioni personalizzate per i file distribuiti.

• Specificare script da eseguire su ciascuna istanza in diverse fasi del processo di distribuzione.

È possibile eseguire script su un'istanza dopo molti dei singoli eventi del ciclo di vita della distribuzione. CodeDeploy esegue solo gli script specificati nel file, ma tali script possono richiamare altri script sull'istanza. Puoi eseguire qualsiasi tipo di script, purché sia supportato dal sistema operativo in esecuzione sulle istanze. Per ulteriori informazioni, consulta AppSpec sezione 'hooks' per una distribuzione EC2/on-premise.

In che modo l' CodeDeploy agente utilizza il file AppSpec

Durante la distribuzione, l' CodeDeploy agente cerca il nome dell'evento corrente nella sezione hooks del AppSpec file. Se l'evento non viene trovato, l' CodeDeploy agente passa alla fase successiva. Se l'evento viene trovato, l' CodeDeploy agente recupera l'elenco degli script da eseguire. Gli script vengono eseguiti in sequenza, nell'ordine in cui sono mostrati nel file. Lo stato di ogni script viene registrato nel file di registro dell' CodeDeploy agente sull'istanza.

Se uno script viene eseguito con successo, restituisce il codice di uscita 0 (zero).

Nota

L' CodeDeploy agente non viene utilizzato in una distribuzione AWS Lambda o Amazon ECS.

Durante l'evento Install, l' CodeDeploy agente utilizza le mappature definite nella sezione files del AppSpec file per determinare quali cartelle o file copiare dalla revisione all'istanza.

Se l' CodeDeploy agente installato sul sistema operativo non corrisponde a quanto elencato nel AppSpec file, la distribuzione non riesce.

Per informazioni sui file di registro CodeDeploy dell'agente, vedereCollaborazione con l' CodeDeploy agente.