Git
Cette page est générée depuis docs/guide.fr.md · Modifier cette page sur GitLab
Opérations sur plusieurs dépôts à la fois et exploration des branches.
- Actions —
Créer une branche·Créer un tag·Supprimer des branches·Supprimer des tags. On ne saisit un nom que pour créer ; pour supprimer, on choisit dans la liste des refs existantes — la branche par défaut et les refs protégées n'y figurent même pas. Le choix du dépôt se fait par un champ avec recherche (comme partout où l'on choisit un projet), utile quand la liste est longue — et le choix de la ref aussi : un dépôt actif compte des centaines de branches et de tags. Un choix unique passe par un sélecteur avec recherche ; un choix multiple (cases à cocher, tableau de l'explorateur) reçoit un filtre qui masque des lignes sans décocher quoi que ce soit — on coche, on filtre autre chose, on coche encore, puis on supprime d'un coup. La liste des refs est lue une fois par dépôt :Rafraîchir la listela relit sur la forge — et elle se relit d'elle-même quand une opération git se termine, de sorte que les branches que l'on vient de supprimer la quittent, les dépôts choisis et les cases encore valables restant en place. - Rien ne s'exécute sans aperçu. L'aperçu liste chaque ligne (projet × ref) et son résultat attendu : sera exécutée · existe déjà — ignorée · ref protégée · branche par défaut · introuvable. « Existe déjà » n'est pas une erreur : l'opération est idempotente, on peut relancer. Chaque ligne exploitable affiche aussi la commande correspondante : celle qui est réellement exécutée (le
git fetchde sécurité), l'équivalent git de l'écriture — donné pour comprendre, car l'écriture passe par l'API et non par le CLI — et l'appel API sous-jacent. - Les suppressions sont restaurables. Avant chaque suppression, l'outil rapatrie les objets dans son clone local, puis enregistre le SHA. L'onglet Historique propose alors
Restaurer— et ça fonctionne même après le passage du ramasse-miettes de la forge, puisque c'est le clone local qui sert de filet, pas le serveur. - Les branches de merge requests mergées se ramassent en un lot. Un bouton en tête d'Actions remplit la suppression avec toutes les branches dont la merge request a été mergée — l'aperçu habituel dit ensuite, branche par branche, si elle existe encore et si la supprimer est sans risque. Passé une dizaine, le brief du matin le rappelle.
- Trois sous-onglets qui se souviennent. Merge retient son dépôt et ses deux branches, Actions son opération et ses dépôts — comme Comparer, Navigation et Commandes le faisaient déjà. Ni les noms de branche ni les refs cochées pour une suppression ne sont repris : recocher est justement le geste qui fait relire ce qu'on s'apprête à supprimer.
- Le nom d'une branche se propose : le dernier nom créé avec son numéro incrémenté (
release/1.4→release/1.5), ou la clé de ticket du presse-papiers — lu au clic sur un bouton, jamais en fond. - Depuis l'explorateur, deux gestes :
Vérifier cette brancheetSession de codage dessuspartent avec le dépôt et la branche déjà renseignés. Et Trouver une ref offrePositionner mes projets dessus, qui ouvre Navigation avec la ref posée sur chaque ligne. - Merge — fusionne une branche dans une autre, conflits compris, sans quitter l'outil. On choisit un dépôt, la branche à fusionner et la branche de destination (les deux avec recherche : un dépôt actif porte des centaines de branches), puis
Préparer le merge. À ce stade rien n'est commité ni poussé : le merge est préparé dans un espace de travail à part, jamais dans le clone partagé — une review, une session de codage ou une vérification qui tourne à côté ne doit pas trouver le dépôt à moitié fusionné. Un merge se reprend après un redémarrage de l'outil.- Le merge ouvert passe en tête de l'onglet, au-dessus de la liste des merges en cours (où sa ligne dit « ouvert ci-dessus ») et du formulaire, qui devient « Préparer un autre merge ». Son bandeau porte les trois étapes
Résoudre › Commiter › Pousser, celle en cours en évidence, les faites cochées ; à gauche, les fichiers encore en conflit, puis, cochés, ceux déjà prêts à commiter. Un merge dont le dossier de travail a disparu (préparé sur un autre poste, ménage du disque) le dit en clair et ne propose que de l'abandonner, au lieu d'un panneau vide. - Les conflits se résolvent à l'écran, un par un. Pour chaque conflit : la version de la destination et la version entrante, l'une sous l'autre — chacune avec la date et l'heure du dernier commit de ce fichier sur sa branche, pour ne plus deviner laquelle est la plus récente (deux commits du même jour se ressemblaient) —, avec
Gardersur chacune etGarder les deux : main puis featureen dessous, qui nomme les deux branches et l'ordre dans lequel il les applique ; le côté retenu porte une barre de couleur et la mention « gardée », pour voir où l'on en est sans relire les boutons — la destination l'est d'office — et chaque version se clique en entier, pas seulement sonGarder. Aucun marqueur<<<<<<<n'est jamais montré. Quand aucun des deux ne convient,Écrire moi-mêmedonne le résultat de tes choix dans un champ texte libre et enregistre ce que tu écris. Demander à l'IApropose une résolution pour chaque conflit de chaque fichier, en une fois — tu valides chacune. Un bouton sur l'écran des conflits, pas un par fichier : le merge entier part à l'agent en un seul job d'arrière-plan, qui voit tous les fichiers en conflit ensemble avant de proposer — une correction qui n'a de sens que lue à côté d'un changement dans un autre fichier ne se perd pas en demandant fichier par fichier. Le bouton demande confirmation : le contenu de chaque fichier encore en conflit part vers l'IA. Chaque proposition apparaît comme une troisième version à côté de « la nôtre » et « la leur », avec son propreGarder— rien ne s'applique tout seul, et un conflit que l'agent a passé n'a simplement pas de troisième version, jamais une devinette. Chaque proposition porte sa raison, repliée derrièreVoir la raison. Les propositions restent avec le merge : rouvrir un fichier ne perd pas ce qui a déjà été demandé.Plein écranmontre le fichier entier, trois fois côte à côte — destination, source, et le résultat courant au milieu — au lieu de trois lignes de contexte par conflit ; cliquer un passage d'un côté le garde, et le choix revient dans la vue normale à la fermeture. Une quatrième colonne, la proposition de l'IA et sa raison, n'apparaît que sur un fichier qui en a une ; cliquer la proposition la retient, comme un passage. Chaque colonne se masque et se réaffiche à part — les autres se partagent la largeur libérée, une au moins reste visible — et des flèches conflit précédent / suivant avec un compteur « Conflit N/M » sautent au conflit suivant, actives même sur un fichier à un seul conflit : passer le dernier le recentre, au lieu de ne rien faire.- Puis deux gestes séparés, dans cet ordre.
Commiter— le message est déjà rempli avec celui que git a écrit — puisPousser, chacun derrière sa propre confirmation.Commiterrefuse tant qu'un conflit reste ;Pousserrefuse tant que rien n'est commité.Abandonnerremet tout en état : tant que tu n'as pas poussé, la branche de destination n'a pas bougé. - Quand les deux branches n'ont aucun ancêtre commun, l'outil explique ce que ça signifie et propose de continuer quand même (
--allow-unrelated-histories), au lieu de renvoyer tel quel lefatal: refusing to merge unrelated historiesde git.
- Le merge ouvert passe en tête de l'onglet, au-dessus de la liste des merges en cours (où sa ligne dit « ouvert ci-dessus ») et du formulaire, qui devient « Préparer un autre merge ». Son bandeau porte les trois étapes
- Navigation — positionne plusieurs projets de ta machine (pas les clones de l'outil : tes propres dépôts) sur la branche de ton choix, en un geste. On choisit un répertoire local — un dossier contenant un sous-dossier par projet git, déclaré dans Réglages → Dépôts, où chaque répertoire liste les projets trouvés et se relit sur le disque d'un bouton : un dossier supprimé à la main disparaît, un dépôt cloné depuis apparaît, ici comme dans les sélecteurs —, puis ligne par ligne un projet et sa branche distante, les deux avec recherche à la frappe. La branche courante est affichée à côté du sélecteur : sans elle on choisit à l'aveugle, sans savoir si l'opération change quoi que ce soit. Un
git fetchprécède la liste des branches et le checkout, la branche locale est ensuite alignée en fast-forward seulement (un historique divergent est signalé, jamais écrasé). Rien n'est jeté : si un dépôt a des modifications en cours, le checkout est fait quand même et le bilan liste les fichiers concernés — un compte ne permettrait pas de vérifier ce qu'on emporte d'une branche à l'autre. Un échec (branche absente, checkout refusé) est isolé : il n'interrompt pas les autres projets et sa raison est affichée. - Commandes Git — exécute la même commande git à la racine de plusieurs projets locaux d'un coup. On choisit un répertoire local, on coche les projets (recherche + « tout cocher »), puis on saisit une commande git ou on la prend dans une palette (gérée dans Réglages → Git). Flux en trois temps : Prévisualiser (la commande exacte + la liste des projets visés) → Exécuter → la sortie de chaque projet s'affiche, avec son code de sortie. Git uniquement, sans shell (les métacaractères
; | > &ne sont jamais interprétés) et avec un refus des options git dangereuses : les flags qui permettent d'exécuter une commande arbitraire ou de sortir du dossier (-c,--upload-pack,--receive-pack,--exec,-C,--git-dir, transportext::…) sont bloqués, et la commande doit commencer par une sous-commande. Un projet en échec est isolé ; les autres s'exécutent quand même. - Explorateur de branches — par projet, une ligne par branche avec ses colonnes :
↑avance ↓retardvs la branche par défaut, sa branche d'origine, la branche dans laquelle elle a été mergée et son dernier commit. Trié par date du dernier commit, du plus récent au plus ancien. Le sélecteur de dépôts porteTout cocher/Tout décocheret le compte des cochés, comme celui des Commandes Git. Depuis une branche,Créer la MRouvre une MR entre elle et sa source (l'origine déduite, sinon la branche par défaut) — même popup de titre que dans Dev IA, proposé seulement quand la branche a des commits d'avance. Cocher des branches puisSupprimer la sélectionouvre l'aperçu pré-rempli. Chaque ligne porte aussi ce que la base sait de la branche : la note de la review de sa merge request, la session de codage qui l'a créée, son ticket Jira et son état, le dernier verdict de vérification — et, quand le dépôt a un job Jenkins déclaré, un bouton qui ouvre ce job avec la branche déjà posée. Le bouton n'existait que sur une merge request vérifiée verte : une branche qu'on veut déployer en recette avant d'en faire une merge request n'y avait pas droit. La fiche s'ouvre, jamais un lancement. La ligne accepte enfin une todo (« rebaser avant lundi »), qui saura y revenir. On peut aussi explorer plusieurs dépôts à la fois : chaque résultat va dans son bloc, replié et marqué d'un chevron qui pivote — les dépôts sont analysés l'un après l'autre, et chaque bloc dit où il en est (en attente, puis analyse en cours avec son indicateur, puis son nombre de branches). Un clone peut durer une minute : le bouton tourne pendant ce temps, et un dépôt en échec ouvre son bloc pour montrer la raison au lieu de la laisser enfermée. La liste des tags affiche la date, la (les) branche(s) qui portent le tag, l'auteur du commit pointé — avec un boutonAuteur du tagqui va lire le vrai tagger d'un tag annoté dans le clone local (aucune des deux API de forge ne l'expose). - Comparer — deux dépôts, une branche ou un tag de chaque côté, et la question « qu'est-ce qui existe ici et pas là ? » (comparer deux versions livrées, c'est comparer deux tags ; les deux vivent dans la même liste à recherche, marqués, parce qu'une branche et un tag peuvent porter le même nom). Ce n'est pas un
git diff: les deux dépôts n'ont pas besoin d'une histoire commune (un service extrait dans son propre dépôt, un fork parti vivre sa vie). L'outil lit les deux arborescences et range chaque fichier dans une des trois colonnes : à gauche seulement, des deux côtés mais différents (même chemin, contenu différent), à droite seulement. Les fichiers identiques ne sont pas listés — seulement comptés, pour que l'écran montre ce qui manque plutôt que ce qui va bien. Cliquer un fichier montre ses différences : les deux versions en diff unifié, avec un rappel de quel côté est le rouge et lequel est le vert. Un fichier présent d'un seul côté se lit contre le vide — tout son contenu en retrait (ou en ajout), c'est-à-dire exactement ce qui manque à l'autre. Un binaire s'annonce au lieu de déverser ses octets, et un fichier de plus d'un mégaoctet n'est pas chargé — c'est dit, pas caché. Un filtre cherche un fichier dans les trois colonnes à la fois. Les deux côtés peuvent désigner le même dépôt sur deux branches. Au-delà de 2 000 fichiers par colonne, les listes sont coupées et la troncature est annoncée — jamais silencieuse. - Trouver une ref — on saisit un nom de tag ou de branche (saisie libre) et l'outil dit, à travers tous les dépôts actifs (GitLab et GitHub confondus), lesquels le possèdent : type, commit + lien vers la forge, date, branche(s) portant le tag, auteur — avec le même bouton
Auteur du tag. Un dépôt injoignable est signalé à part, jamais confondu avec « absente ». - Tags par période — « qu'a-t-on livré ces deux semaines ? ». Deux dates (raccourcis 7 et 30 derniers jours ; les 30 derniers sont posés à l'ouverture) et l'outil liste tous les tags créés entre ces deux jours, bornes incluses, dans tous les dépôts actifs : dépôt, tag (lien vers la forge), date et heure (deux tags du même jour se distinguent), première ligne du message. La croix au bout d'une ligne la masque — un tag de test, une rustine qu'on n'annonce pas — et « Tout réafficher » la rend ;
Copier le tableaupose les lignes visibles dans le presse-papiers sous deux formes à la fois — un vrai tableau HTML, que Teams, un mail ou Word rendent en tableau, et du texte tabulé pour un tableur ou un éditeur brut.Vérifier ces tagspose la question d'après : « ce qu'on a livré passe-t-il encore ? » — il ouvre Vérifier une branche avec les dépôts du tableau cochés, chacun en genre Tag sur son tag, les lignes masquées restant dehors ; le vérificateur proposé est celui qui couvre le plus de ces dépôts, ceux qu'il ne couvre pas sont nommés sous le sélecteur, et un dépôt à plusieurs tags visibles reçoit le plus récent (changeable sur sa ligne). La date d'un tag est sa date de création quand la forge la donne (GitLab, tag annoté), sinon celle du commit pointé ; les tags GitHub, que l'API ne date pas, sont lus dans le clone local. Un tag que l'outil n'arrive pas à dater est compté à part, jamais placé au hasard ; un dépôt injoignable est nommé.
⚠️ L'origine d'une branche est une inférence, pas une donnée. Git n'enregistre nulle part de quelle branche une branche a été créée. L'outil la déduit (
merge-base), sauf quand une merge request l'atteste — le seul cas certain. Une origine déduite s'affiche en italique avec sa confiance (probable / ambigu), jamais comme un fait.