View a markdown version of this page

Artefacts d'entrée et de sortie - AWS CodePipeline

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.

Artefacts d'entrée et de sortie

CodePipeline s'intègre aux outils de développement pour vérifier les modifications apportées au code, puis créer et déployer à toutes les étapes du processus de livraison continue. Les artefacts sont les fichiers qui sont traités par des actions du pipeline, tels que des fichiers ou des dossiers contenant du code d'application, des fichiers de page d'index, des scripts, etc. Par exemple, l'artefact d'action source Amazon S3 est un nom de fichier (ou chemin de fichier) dans lequel les fichiers de code source de l'application sont fournis pour l'action source du pipeline. Les fichiers sont fournis sous forme de fichier ZIP, comme l'exemple de nom d'artefact suivant :SampleApp_Windows.zip. L'artefact de sortie de l'action source, les fichiers de code source de l'application, est l'artefact de sortie de cette action et l'artefact d'entrée pour l'action suivante, telle qu'une action de génération. Autre exemple, une action de génération peut exécuter des commandes de génération qui compilent le code source de l'application pour un artefact d'entrée, à savoir les fichiers de code source de l'application. Consultez la page de référence de configuration des actions pour une action spécifique pour plus de détails sur les paramètres de l'artefact, par exemple AWS CodeBuild créer et tester une référence d'action pour l' CodeBuild action.

Les actions utilisent des artefacts d'entrée et de sortie qui sont stockés dans le compartiment d'artefacts Amazon S3 que vous avez choisi lors de la création du pipeline. CodePipeline compresse et transfère les fichiers pour les artefacts d'entrée ou de sortie, en fonction du type d'action de la scène.

Note

Le compartiment d'artefacts n'est pas le même que le compartiment utilisé comme emplacement du fichier source pour un pipeline où l'action source choisie est S3.

Par exemple :

  1. CodePipeline déclenche l'exécution de votre pipeline lorsqu'il y a une validation dans le référentiel source, fournissant l'artefact de sortie (tous les fichiers à créer) depuis le stage Source.

  2. L'artefact de sortie (tout fichier devant être généré) de l'étape précédente est ingéré en tant qu'artefact d'entrée à l'étape Build. Un artefact de sortie (application générée) issu de l'étape Build peut correspondre à une application mise à jour ou à une image Docker mise à jour et intégrée à un conteneur.

  3. L'artefact de sortie de l'étape précédente (l'application créée) est ingéré en tant qu'artefact d'entrée dans la phase de déploiement, comme les environnements de préparation ou de production dans le. AWS Cloud Vous pouvez déployer des applications sur une flotte de déploiement, ou déployer des applications basées sur conteneur sur des tâches exécutés dans des clusters ECS.

Lorsque vous créez ou modifiez une action, vous définissez l'artefact ou les artefacts d'entrée et de sortie pour l'action. Par exemple, pour un pipeline en deux étapes avec une étape source et une étape de déploiement, dans Modifier l'action, vous choisissez le nom de l'artefact de l'action source pour l'artefact en entrée pour l'action de déploiement.

  • Lorsque vous utilisez la console pour créer votre premier pipeline, CodePipeline créez un compartiment Amazon S3 dans celui-ci Compte AWS et Région AWS pour stocker des éléments pour tous les pipelines. Chaque fois que vous utilisez la console pour créer un autre pipeline dans cette région, CodePipeline créez un dossier pour ce pipeline dans le bucket. Ce dossier est utilisé pour stocker les artéfacts pour votre pipeline pendant l'exécution du processus de publication automatisé. Ce compartiment est nommé codepipeline- region -12345EXAMPLE, où region correspond à la AWS région dans laquelle vous avez créé le pipeline. 12345EXAMPLE Il s'agit d'un nombre aléatoire à 12 chiffres qui garantit que le nom du compartiment est unique.

    Note

    Si vous avez déjà un compartiment commençant par codepipeline-region - dans la région où vous créez le pipeline, CodePipeline utilisez-le comme compartiment par défaut. Il suit également l'ordre lexicographique ; par exemple, codepipeline- region-abcexample est choisi avant codepipeline- region-defexample.

    CodePipeline tronque les noms des artefacts, ce qui peut donner à certains noms de compartiments une apparence similaire. Même si le nom de l'artefact semble tronqué, il est CodePipeline mappé au compartiment d'artefacts d'une manière qui n'est pas affectée par les artefacts dont le nom est tronqué. Le pipeline peut fonctionner normalement. Ce n'est pas un problème avec le dossier ou les artefacts. Les noms de pipeline sont limités à 100 caractères. Bien que le nom du dossier de l'artefact puisse apparaître raccourci, il est toujours unique à votre pipeline.

    Lorsque vous créez ou modifiez un pipeline, vous devez disposer d'un compartiment d'artefacts dans le pipeline Compte AWS et Région AWS vous devez disposer d'un compartiment d'artefacts par région dans laquelle vous prévoyez d'exécuter une action. Si vous utilisez la console pour créer un pipeline ou des actions inter-régions, les compartiments d'artefact par défaut sont configurés par CodePipeline dans les régions où vous avez des actions.

    Si vous utilisez le AWS CLI pour créer un pipeline, vous pouvez stocker les artefacts de ce pipeline dans n'importe quel compartiment Amazon S3 tant que ce compartiment se trouve dans le même Compte AWS compartiment Région AWS que le pipeline. Vous pouvez le faire si vous craignez de dépasser les limites des compartiments Amazon S3 autorisés pour votre compte. Si vous utilisez le AWS CLI pour créer ou modifier un pipeline et que vous ajoutez une action interrégionale (une action avec un AWS fournisseur dans une région différente de votre pipeline), vous devez fournir un compartiment d'artefacts pour chaque région supplémentaire dans laquelle vous prévoyez d'exécuter une action.

  • Chaque action dispose d'un type. Selon le type, l'action peut avoir l'un des éléments suivants, ou les deux :

    • Un artéfact d'entrée, artéfact utilisé pendant l'exécution de l'action.

    • Une artéfact de sortie, qui est le résultat de l'action.

    Chaque artéfact de sortie dans le pipeline doit avoir un nom unique. Chaque artéfact d'entrée d'une action doit correspondre à l'artéfact de sortie d'une action précédente dans le pipeline, que cette action précède immédiatement l'action d'une étape ou s'exécute dans plusieurs étapes précédentes.

    Un artéfact peut s'appliquer à plusieurs actions.