Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
CodeDeploy fichiers de spécification d'application (AppSpec)
Un fichier de spécification d'application (AppSpec fichier), unique à CodeDeploy, est un fichier au format YAML
Pour plus d'informations sur la création d'un AppSpec fichier correctement formé, consultezCodeDeploy AppSpec référence de fichier.
Rubriques
AppSpec fichiers sur une plateforme de calcul Amazon ECS
Si votre application utilise la plate-forme de calcul Amazon ECS, le AppSpec fichier peut être formaté en YAML ou en JSON. Il peut également être directement entré dans un éditeur via la console. Le AppSpec fichier est utilisé pour spécifier :
-
Le nom du service Amazon ECS ainsi que le nom du conteneur et le port utilisés pour diriger le trafic vers le nouvel ensemble de tâches.
-
Les fonctions à utiliser comme tests de validation.
Vous pouvez exécuter des fonctions Lambda de validation après des événements du cycle de vie du déploiement. Pour plus d’informations, consultez AppSpec section « hooks » pour un ECS déploiement sur Amazon, AppSpec structure de fichiers pour les ECS déploiements Amazon et AppSpec Exemple de fichier pour un ECS déploiement Amazon .
AppSpec fichiers sur une plate-forme AWS Lambda informatique
Si votre application utilise la plate-forme de calcul AWS Lambda, le AppSpec fichier peut être formaté en YAML ou en JSON. Il peut également être directement entré dans un éditeur via la console. Le AppSpec fichier est utilisé pour spécifier :
-
Version de la AWS Lambda fonction à déployer.
-
Les fonctions à utiliser comme tests de validation.
Vous pouvez exécuter des fonctions Lambda de validation après des événements du cycle de vie du déploiement. Pour plus d’informations, consultez AppSpec section « hooks » pour un déploiement AWS Lambda.
AppSpec fichiers sur une plate-forme informatique EC2/sur site
Si votre application utilise la plate-forme de calcul EC2/on-premises, le AppSpec fichier est toujours au format YAML. Le AppSpec fichier permet de :
-
mapper les fichiers sources figurant dans votre révision d'application vers leurs destinations sur l'instance ;
-
spécifier des autorisations personnalisées pour les fichiers déployés ;
-
spécifier les scripts à exécuter sur chaque instance à diverses étapes du processus de déploiement.
Vous pouvez exécuter des scripts sur une instance après de nombreux événements du cycle de vie de déploiement individuels. CodeDeploy exécute uniquement les scripts spécifiés dans le fichier, mais ces scripts peuvent appeler d'autres scripts sur l'instance. Vous pouvez exécuter tout type de script tant qu'il est pris en charge par le système d'exploitation en cours d'exécution sur les instances. Pour plus d’informations, consultez AppSpec section « hooks » pour un déploiement EC2 /On-Premises.
Comment l' CodeDeploy agent utilise le AppSpec fichier
Pendant le déploiement, l' CodeDeploy agent recherche le nom de l'événement en cours dans la section hooks du AppSpec fichier. Si l'événement est introuvable, l' CodeDeploy agent passe à l'étape suivante. Si l'événement est détecté, l' CodeDeploy agent récupère la liste des scripts à exécuter. Les scripts sont exécutés de manière séquentielle, dans l'ordre dans lequel ils apparaissent dans le fichier. L'état de chaque script est enregistré dans le fichier journal de l' CodeDeploy agent sur l'instance.
Si un script s'exécute avec succès, il retourne un code de sortie de 0 (zéro).
Note
L' CodeDeploy agent n'est pas utilisé dans un AWS déploiement Lambda ou Amazon ECS.
Lors de l'événement d'installation, l' CodeDeploy agent utilise les mappages définis dans la section des fichiers du AppSpec fichier pour déterminer les dossiers ou les fichiers à copier de la révision vers l'instance.
Si l' CodeDeploy agent installé sur le système d'exploitation ne correspond pas à ce qui est indiqué dans le AppSpec fichier, le déploiement échoue.
Pour plus d'informations sur les fichiers journaux de l' CodeDeploy agent, consultezTravailler avec l' CodeDeploy agent.