Comment travailler avec des artefacts dans TeamCity

Tous les fichiers que votre build produit sont des artefacts potentiels, ce qui est comparable à une application compressée dans un fichier .jar ou .zip. Une fois l'exécution du build terminée sur l'agent de build, TeamCity prend ces fichiers et les charge dans l'interface utilisateur du serveur TeamCity, où vous pouvez y accéder et les vérifier.

En savoir plus sur les artefacts de build dans notre documentation.

Pour obtenir les données produites par votre build, allez dans la section Edit Configuration.

L'onglet General Settings comporte le champ de saisie Artifact Paths.

Qu'est-ce qu'un chemin d'artefact ?

Dans TeamCity, le chemin d'artefact désigne l'emplacement où des artefacts de build sont stockés à l'issue d'un processus de build réussi. Les artefacts sont les fichiers de sortie, les données binaires ou autres résultats importants générés au cours du processus de build. Le chemin d'artefact spécifie la structure de répertoires ou de dossiers du serveur TeamCity où ces artefacts sont publiés et accessibles.

Dans cet exemple, nous savons que notre build crée un sous-répertoire d'artefacts, et nous souhaitons nous assurer que tous les fichiers de ce sous-répertoire sont disponibles. Spécifiez le chemin d'accès des artefacts dans le champ, puis cliquez sur Save.

Où sont stockés les artefacts ?

TeamCity dispose d'un stockage d'artefacts intégré. Vous pouvez également connecter un stockage d'artefacts externe à TeamCity. Actuellement, TeamCity prend en charge Amazon S3, Azure Artifact Storage et Google Cloud Artifact Storage.

Désormais, des modifications sont visibles après l'exécution du build. Précédemment, l'icône d'artefact était grisée, ce qui signifie qu'aucun artefact identifié par l'utilisateur n'était présent dans ce build.

L'icône bleu clair indique que TeamCity a bien découvert et stocké des artefacts pour ce build. Lorsque nous cliquons sur l'icône bleue, nous pouvons constater que deux fichiers sont stockés en tant qu'artefacts, un journal d'application et un enregistrement Selenium.

Vous pouvez également cliquer sur chaque fichier séparément et l'examiner.

Les données des agents de build sont transférées au serveur TeamCity ou, plus spécifiquement, à un stockage spécifique. Le stockage peut se faire dans le cloud, localement ou à l'endroit de votre choix.

Non seulement ces données sont disponibles sur le serveur TeamCity, mais elles sont également disponibles et prêtes à être transférées au moyen d'une chaîne de build ou plusieurs configurations de build. Par exemple, si une tâche de déploiement nécessite un fichier .jar provenant d'une tâche de build précédente, ce fichier peut être transféré au moyen d'artefacts.

Comment puis-je copier les artefacts ?

Dans TeamCity, vous pouvez copier des artefacts d'un build à l'autre avec la fonctionnalité « Artifact Dependency ». Pour ce faire, vous devez configurer les chemins d'artefacts dans le build source, configurer la dépendance d'artefact dans le build cible, exécuter les builds et vérifier la copie de l'artefact. En configurant les dépendances d'artefact, vous créez un lien entre les builds dans TeamCity, ce qui permet de transférer les artefacts d'un build à l'autre très simplement.

Vous êtes prêt à configurer des artefacts ? Consultez notre documentation et n'hésitez pas à nous contacter si vous avez des questions.