Une branche est une copie distincte des tests d'un projet de test, sur laquelle vous modifiez des cas de test, des groupes de tests et des plans de test sans toucher aux tests qu'utilise votre équipe. Chaque projet de test commence avec une branche, main, qui contient les tests de tout le monde. Vous créez une branche à partir de main, vous y modifiez et exécutez vos tests, puis vous examinez les modifications et les fusionnez dans main en une seule fois.
Ce que contient une branche
Une branche conserve sa propre version :
des cas de test, avec leurs étapes et leurs paramètres d'exécution
des groupes de tests et des plans de test, avec les cas de test qu'ils contiennent
des Plannings. Un Planning appartient à la branche sur laquelle vous l'avez créé.
Tout le reste est partagé par toutes les branches du projet de test : Environnements, Secrets, Variables, Personas, Apps, éléments de test et étiquettes. Une modification d'un Environnement faite sur une branche s'applique aussi à main.
Tant que vous ne modifiez pas un élément sur votre branche, la branche affiche sa version de main, y compris les modifications que vos collègues font sur main après la création de la branche. Seuls les éléments que vous modifiez sur la branche restent séparés.
Savoir sur quelle branche vous êtes
Le sélecteur de branche se trouve dans l'en-tête de chaque page d'un projet de test. Il affiche le nom de la branche courante. Le nom de main s'affiche dans la couleur de texte normale et le nom de toute autre branche est mis en évidence : vous voyez tout de suite que vous n'êtes pas sur main.
Sélectionnez le sélecteur de branche pour rechercher les branches du projet de test et passer sur une autre. main est toujours en tête de liste.
Ce que vous voyez et faites suit la branche courante : les listes de cas de test et de groupes de tests, les pages de détail, vos modifications, les exécutions que vous lancez et vos discussions Thunders AI.
Créer une branche
Ouvrez le projet de test.
Sélectionnez le sélecteur de branche dans l'en-tête.
Sélectionnez Créer une branche.
Dans Nom de la branche, saisissez un nom, par exemple
feature/mon-changement. Un nom peut contenir des lettres, des chiffres, des tirets, des underscores et des barres obliques.Sélectionnez Créer une branche.
La nouvelle branche part de main, et Thunders vous y place immédiatement.
Travailler et exécuter des tests sur une branche
Ajoutez, modifiez et supprimez des cas de test, des groupes de tests et des plans de test comme d'habitude. Les modifications restent sur la branche. Un élément créé sur une branche n'existe que sur cette branche jusqu'à la fusion. Si vous ouvrez un tel groupe de tests ou plan de test après être revenu sur main, la page vous indique qu'il n'est pas sur cette branche.
Quand vous exécutez un cas de test ou un groupe de tests depuis une branche, l'exécution utilise la version de la branche pour les étapes et les paramètres. La liste des exécutions affiche la branche de chaque exécution, et vous pouvez filtrer la liste sur une branche, y compris une branche déjà fusionnée. Sur la page Analytics, le filtre Branche est réglé par défaut sur Toutes les branches.
Vous ne pouvez pas changer de branche :
pendant qu'une discussion Thunders AI est ouverte sur la branche courante. Fermez le panneau Thunders AI ou commencez d'abord une nouvelle discussion.
pendant l'exécution du cas de test. Arrêtez d'abord l'exécution.
pendant l'enregistrement du cas de test. Arrêtez d'abord l'enregistrement.
Examiner et fusionner une branche dans main
Depuis votre branche, sélectionnez le sélecteur de branche. À côté de la branche courante, Examiner affiche le nombre de modifications.
Sélectionnez Examiner. La fenêtre Examiner et fusionner s'ouvre.
La liste de gauche affiche chaque cas de test et groupe de tests modifié, avec l'étiquette Ajouté, Modifié ou Supprimé. Sélectionnez un élément pour comparer sa version de main avec celle de votre branche, champ par champ et étape par étape. Utilisez Précédent et Suivant pour passer d'un élément à l'autre.
Quand le bandeau indique « Aucun conflit détecté. Vos modifications peuvent être fusionnées dans main. », sélectionnez Fusionner dans main.
Toutes les modifications arrivent dans main ensemble. Thunders confirme « Branche fusionnée. », ferme la branche et vous ramène sur main.
Un cas de test qui échoue sur la branche affiche l'étiquette En échec, et sa comparaison indique « Ce test échoue sur cette branche ». Un test en échec ne bloque pas la fusion : revoyez ses étapes en échec avant de fusionner.
Résoudre les conflits
Un conflit survient quand main contient une modification plus récente d'un élément que vous avez aussi modifié sur votre branche. Le bandeau l'indique alors, par exemple « Main contient des modifications plus récentes sur 1 élément que vous avez aussi modifié. La fusion est bloquée jusqu’à ce que ces modifications soient réconciliées. », et Résoudre les conflits remplace le bouton de fusion.
Sélectionnez Résoudre les conflits. Pour chaque élément en conflit, la version de main s'affiche à côté de celle de votre branche.
Pour chaque élément, sélectionnez Garder main ou Garder suivi du nom de votre branche. Pour faire le même choix sur tous les éléments, ouvrez Tout résoudre et sélectionnez Choisir main ou Choisir la branche.
Quand chaque conflit a un choix, sélectionnez Appliquer les modifications.
Dans l'examen, sélectionnez Fusionner dans main.
Votre choix s'applique à l'élément entier. Si main a supprimé l'élément, vous ne pouvez garder que main.
Abandonner ou supprimer une branche
Seule la personne qui a créé une branche peut la supprimer, et main ne peut jamais être supprimée. Utilisez l'une de ces actions :
Dans le sélecteur de branche, sélectionnez l'icône de corbeille à côté de la branche.
Dans la fenêtre Examiner et fusionner, sélectionnez Abandonner la branche.
Toutes les modifications de la branche sont perdues, et cette action est irréversible.
Questions fréquentes
Comment exécuter un pipeline de CI sur une branche ?
Ajoutez branchId, avec l'identifiant de la branche, au corps de la requête d'exécution CI. L'exécution utilise alors la version de la branche. Sans branchId, l'exécution utilise main, donc vos pipelines existants ne changent pas. Pour obtenir les identifiants, appelez GET /api/branches?projectId=<identifiant de votre projet> avec votre clé d'API. Consultez CI/CD.
Comment récupérer sur ma branche les dernières modifications de main ?
Vous n'avez rien à faire. Un élément que vous n'avez pas modifié sur la branche affiche toujours sa version de main. Pour un élément modifié à la fois sur main et sur votre branche, vous choisissez la version à garder au moment de la fusion.
Dans quelle branche une branche est-elle fusionnée ?
Dans main. Chaque branche part de main et est fusionnée dans main. Après la fusion, la branche est fermée et n'apparaît plus dans le sélecteur de branche, mais ses exécutions restent dans la liste des exécutions.
Comment utiliser Thunders AI sur une branche ?
Passez sur la branche avant de commencer la discussion. La discussion reste sur la branche où elle a commencé : pour travailler sur une autre branche, commencez une nouvelle discussion. Sur la page Thunders AI, vous choisissez la branche dans la zone de message. Consultez Présentation de Thunders AI.
Comment retrouver les exécutions d'une branche après la fusion ?
Filtrez la liste des exécutions sur la branche. Le filtre conserve les branches déjà fusionnées, donc les exécutions d'une branche fermée restent faciles à retrouver.