Artefacts d'entrée et de sortie

CodePipeline s'intègre aux outils de développement pour vérifier les modifications du code, puis créer et déployer à toutes les étapes du processus de livraison continue. Les artefacts sont les fichiers sur lesquels les actions du pipeline travaillent, 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, et les fichiers sont généralement fournis sous forme de ZIP fichier, comme dans 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, sont l'artefact de sortie de l'action source et sont également 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 d'une application pour un artefact d'entrée, à savoir les fichiers de code source de l'application issus de l'action source. Consultez la page de référence de configuration d'action pour une action spécifique pour plus de détails sur les paramètres de l'artefact, tels que AWS CodeBuild créer et tester une référence d'action 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 contenant 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, tel que les environnements de préparation ou de production dans le. AWS Cloud Vous pouvez déployer des applications dans un parc de déploiement ou déployer des applications basées sur des conteneurs pour des tâches exécutées dans ECS des clusters.

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 phase Source et une étape Déploiement, dans Modifier l'action, vous choisissez le nom de l'artefact de l'action source pour l'artefact d'entrée pour l'action de déploiement.

• Lorsque vous utilisez la console pour créer votre premier pipeline, vous 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, un dossier est CodePipeline créé pour ce pipeline dans le compartiment. Ce dossier est utilisé pour stocker les artéfacts pour votre pipeline pendant l'exécution du processus de publication automatisé. Ce bucket s'appelle codepipeline-region-12345EXAMPLEOù : region est la AWS région dans laquelle vous avez créé le pipeline, et 12345EXAMPLE est un nombre aléatoire à 12 chiffres qui garantit que le nom du bucket est unique.

  Note

  Si vous avez déjà un bucket commençant par codepipeline- region, dans la région où vous créez le pipeline, CodePipeline utilisez-le comme bucket 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 entraîner la similitude des noms de compartiments. Même si le nom de l'artefact semble tronqué, il est CodePipeline mappé vers le 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 avoir un compartiment d'artefacts dans le pipeline Compte AWS et Région AWS vous devez avoir 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 interrégionales, les compartiments d'artefacts par défaut sont configurés dans les régions CodePipeline dans lesquelles 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 compartiment Compte AWS et Région AWS dans 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.