Partager via


Définir une build d'archivage contrôlé pour la validation des modifications

Lorsqu'un développeur archive des modifications qui arrêtent la build, cela peut avoir des conséquences néfastes sur le travail des petites équipes. Pour les équipes de plus grande taille, les coûts en matière de perte de productivité et de retard dans le planning peuvent être élevés.

Vous avez donc tout intérêt à créer une définition de build d'archivage contrôlé afin de mettre tout ou partie de votre base de code à l'abri de ces interruptions.

Dans cette rubrique

  • Incidence des builds d'archivage contrôlé sur votre équipe

  • Définir une build d'archivage contrôlé

  • Instructions pour les paramètres de l'onglet Processus

  • Mode d'exécution des builds d'archivage contrôlé

    • Exécuter automatiquement des builds d'archivage contrôlé

    • Exécuter manuellement des builds d'archivage contrôlé et des builds privées

Incidence des builds d'archivage contrôlé sur votre équipe

Lorsqu'une build d'archivage contrôlé est créée, les modifications envoyées par le développeur sont placées dans un jeu de réservations et intégrées automatiquement à votre système de génération. Le processus d'archivage ne sera effectif que si la génération réussit. Pour plus d'informations, consultez Archiver des modifications en attente contrôlées par une build d'archivage contrôlé.

Si certains de vos utilisateurs doivent se soustraire à l'archivage contrôlé, veillez à ce que l'autorisation Remplacer la validation de l'archivage par build ait la valeur Autoriser pour le groupe d'utilisateurs en question. Pour plus d'informations, consultez Autorisations de Team Foundation Server.

Définir une build d'archivage contrôlé

Autorisations requises

Pour que vous puissiez effectuer cette procédure, votre autorisation Modifier la définition de build doit avoir la valeur Autoriser. Pour plus d'informations, consultez Autorisations de Team Foundation Server.

Pour définir une build d'archivage contrôlé

  1. Dans Team Explorer, cliquez sur un projet d'équipe.

  2. Dans le menu Générer, cliquez sur Nouvelle définition de build.

    La fenêtre Nouvelle définition de build s'ouvre sur l'onglet Général.

  3. Tapez un nom dans la zone Nom de définition de build.

  4. Sous l'onglet Déclencheur, cliquez sur Archivage contrôlé : accepter les archivages uniquement si la fusion et la génération des modifications soumises réussissent.

  5. Cliquez sur l'onglet Espace de travail.

    Le tableau Dossiers de travail s'affiche. Ce tableau mappe les dossiers du contrôle de version qui seront contrôlés par cette définition de build aux dossiers locaux sur l'agent de build. Pour plus d'informations, consultez Supprimer une build terminée.

    Conseil

    Veillez à ce que les dossiers de contrôle de version prévus pour cette définition ne soient pas déjà spécifiés sous l'onglet Espace de travail des autres définitions de build d'archivage contrôlé. Sinon, le système demandera aux personnes archivant des fichiers dans ces dossiers de choisir la définition de build qu'elles comptent placer en file d'attente.

  6. Cliquez sur l'onglet Processus, puis définissez les paramètres de processus de génération de telle manière que les archivages répondent aux critères des normes de qualité de code spécifiques de votre équipe.

    En présence d'une base de code volumineuse produite à grande échelle, il est important de trouver le meilleur compromis entre qualité du code et respect des délais pour vos développeurs. Pour plus d'informations, consultez Instructions pour les paramètres de l'onglet Processus plus loin dans cette rubrique.

  7. Cliquez sur les onglets Valeurs par défaut des builds et Stratégie de rétention et appliquez les paramètres appropriés dans chaque onglet.

    Pour plus d'informations, consultez Créer une définition de build de base.

Instructions pour les paramètres de l'onglet Processus

Pour réduire la durée nécessaire au traitement de la build, vous devez suivre ces instructions lorsque vous spécifiez des valeurs pour les paramètres de processus de génération sous l'onglet Processus.

Nœud obligatoire

  • Éléments à générer, Configurations à générer : si vous laissez ce paramètre vide, la plateforme et la configuration par défaut sont utilisées pour chaque solution et projet. Pour optimiser les performances, respectez les instructions suivantes :

    • Si une paire plateforme/configuration est générée plus rapidement que d'autres paires, spécifiez-la dans ce paramètre.

    • Spécifiez le moins de paires plateforme/configuration possible.

Nœud de base

  • Tests automatisés : si votre code doit satisfaire certains tests pour être valide, configurez une série de tests pour exécuter ces tests. Lors de la configuration de la série de tests, assurez-vous d'effectuer un filtrage par catégorie ou par priorité afin d'exécuter uniquement les tests dont vous avez le plus besoin. Pour plus d'informations, consultez Définir une build à l'aide du modèle par défaut.

  • Nettoyer l'espace de travail : spécifiez la valeur Aucun (recommandé) ou Sorties. Vous avez plus de risques, cependant, de négliger certains types d'erreur si l'espace de travail n'est pas nettoyé. Pour plus d'informations, consultez Définir une build à l'aide du modèle par défaut.

  • Effectuer l'analyse du code : choisissez Jamais.

  • Paramètres de serveur source et de symboles, Sources d'index : spécifiez la valeur False.

Nœud avancé

  • Paramètres d'agent

    • Filtre de nom ou Filtre de balises : utilisez un nom d'agent de build ou une balise pour lier cette définition de build à un agent de build conçu spécialement pour l'exécution de cette build. L'agent de build doit être exécuté sur un ordinateur de build offrant une capacité de traitement conforme aux attentes de votre équipe en termes de performances.

      Les développeurs de votre équipe feront certainement preuve de patience si la durée du processus de génération ne dépasse pas 15 minutes. Mais ils ne peuvent pas se permettre d'attendre huit heures pour savoir si l'archivage de leur code ne pose aucun problème.

    • Durée d'exécution maximale : choisissez un délai relativement court pour garantir des builds d'intégration continues. Il est fort probable qu'un délai de huit heures soit trop long pour votre équipe et qu'un délai de 15 minutes soit acceptable.

  • Copier les sorties dans le dossier cible : le système prend cette valeur comme False, même si vous lui affectez la valeur True.

  • Créer un élément de travail en cas d'échec : le système prend cette valeur comme False, même si vous lui affectez la valeur True.

  • Sources d'étiquettes : choisissez la valeur False.

Pour plus d'informations sur le mode de définition des valeurs des paramètres du processus de génération, consultez Définir une build à l'aide du modèle par défaut.

Mode d'exécution des builds d'archivage contrôlé

Chaque définition de build d'archivage contrôlé peut avoir une seule build en cours d'exécution à la fois. Par conséquent, les équipes actives et de grande envergure sont plus susceptibles de développer une grande file d'attente de builds d'archivage contrôlé. Les meilleures pratiques suivantes peuvent aider votre équipe à éviter tout blocage de la progression :

  • Consacrez un ordinateur de build équipé d'un matériel puissant (par exemple, un processeur rapide et un disque dur rapide) à l'agent de build utilisé par votre définition de build d'archivage contrôlé.

  • Définissez la build de sorte que l'agent de build effectue uniquement le travail qui est nécessaire pour valider la qualité du code archivé. Pour plus d'informations, consultez Instructions pour les paramètres de l'onglet Processus plus haut dans cette rubrique.

Les builds d'archivage contrôlé peuvent être exécutées automatiquement ou manuellement.

Exécuter automatiquement des builds d'archivage contrôlé

Une build d'archivage contrôlé est exécutée automatiquement lorsque l'un des événements suivants se produit :

  • Une build a été définie avec la case à cocher Archivage contrôlé activée sous l'onglet Déclencheur de la définition de build.

  • Quelqu'un tente d'archiver une ou plusieurs modifications qui croisent l'un des dossiers mappés sous l'onglet Espace de travail de la définition de build.

Exécuter manuellement des builds d'archivage contrôlé et des builds privées

Les développeurs qui souhaitent contrôler plus étroitement les modifications qu'ils archivent peuvent mettre manuellement en file d'attente une build d'un jeu de réservations. Dans ce cas, ils peuvent choisir l'une des deux options suivantes afin de spécifier l'action effectuée par le système si la génération réussit :

  • Le système archive les modifications (build d'archivage contrôlé manuelle) : cette option peut être pratique pour les développeurs qui souhaitent valider leur code avant de l'archiver, mais qui font partie d'une équipe qui n'utilise pas le déclencheur d'archivage contrôlé.

  • Le système n'archive pas les modifications (build privée) : les développeurs peuvent utiliser cette option lorsqu'ils souhaitent valider des modifications dans un jeu de réservations sans toutefois les archiver.

Pour plus d'informations, consultez Mettre une build en file d'attente.