[Git] Créer un nouveau dépôt à partir d’un dossier d’un autre dépôt

Il y a quelques semaines, j’ai créé un dépôt sur GitHub où je place de nombreux petits bouts de codes, triés par dossiers, qui ne me servent qu’à effectuer des tests divers et variés. Cependant, un de ces essais s’est finalement transformé en véritable projet et occupe à lui seul la plupart des commits effectués sur ce dépôt. Voici donc un problème : il faudrait que je crée un nouveau dépôt qui ne contiendra que ce projet ! Surtout si je souhaite le rendre open-source.

Alors évidemment, j’aurais très bien pu créer mon dépôt, un nouveau dossier local et faire un simple copier/coller des fichiers.. Mais quid de l’historique des commits ? C’est tout de même important, surtout à mes yeux ! Et pour bien faire, je souhaite également changer d’hébergeur : passer de GitHub à BitBucket. Ah, dernière chose à ne pas oublier : les premiers commits ont mélangé divers fichiers des multiples projets… Et je ne veux pas en garder une seule trace !

Résumons donc mes exigeances :
- Créer un dépôt sur BitBucket
- Déplacer mon projet du dépôt “fourre-tout” jusqu’à ce nouveau dépôt
- Ne subir aucune perte de fichier
- Ne pas perdre l’historique des commits
- Avoir des commits filtrés (qui ne concernent que mon projet)

Sachant que Git est un outil vraiment puissant, simple à prendre en main et très fiable, je me suis dit qu’il y avait une chance de parvenir à atteindre au moins la moitié des objectifs… Au final, j’ai réussi à tous les accomplir ! Et vous ne devinerez jamais comment j'y suis arrivé !

• Pré-requis
• Explications
• Déplacer le dossier vers un nouveau dépôt
• Actualiser le dépôt
• Résultat sur BitBucket
• Bonus : Perte du origin/HEAD

Pré-requis

Il faut posséder git sous forme de terminal. Sur mon ordi, j’ai choppé Git Shell en installant GitHub for Windows à cette adresse : https://windows.github.com

Un minimum de connaissance de git sera nécessaire. Je n’explique pas la création d’un dépôt, le clonage, le pull, le commit, … Ce sont des notions primaires, très facile à aborder. C’est pourquoi je n’en parlerai pas.

Il faudra également posséder des doigts agiles et une certaine concentration : nous sommes en lignes de commande, une faute de frappe peut tout changer !

Pour finir, il faudra créer un dépôt en ligne à l’avance, sur http://www.sourcetreeapp.com/ ou https://bitbucket.org/. D’autres sites utilisant Git fonctionneront aussi, il faudra juste adapter la ligne adéquate (ce sera indiqué à l’étape nécessaire).

… Et c’est tout. Je conseillerais aussi SourceTree d’Atlassian (ceux qui ont fait BitBucket !) qui est un logiciel permettant de gérer des dépôts Git ou Mercurial, de façon gratuite. Il est vraiment agréable à utiliser et permet à un néophyte d’utiliser le versioning sans trop se prendre la tête (parfait pour moi, ahah). Vous pouvez le télécharger ici : http://www.sourcetreeapp.com/

Explications

Il ne faudra pas beaucoup d’étapes pour accomplir ce que l’on recherche ici. En premier, on va d’abord cloner le premier dépôt dans un nouveau dossier, dossier qui sera la cible du nouveau dépôt.

Ensuite, on filtrera le contenu du nouveau dépôt pour ne garder que le dossier qui nous intéresse. Le contenu de ce dernier sera mis à la racine du dossier du dépôt. Il ne restera plus qu’à filtrer aussi les commits, passer un petit coup de balayette et balancer le tout sur notre nouveau dépôt.

Facile, donc.

Déplacer le dossier vers un nouveau dépôt

… Tout en gardant l’historique des commits !

Pour bien se situer et illustrer facilement, je considère qu’on se trouve un niveau au-dessus des dossiers de tous les dépôts :

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

<dossier Git>
|
| -- <dépôt starwars>
|    -- ...
|
| -- <dépôt fourre_tout>
|    -- <banane>
|    -- <pac_man>
|    -- <coffee>
|

Je souhaiterais déplacer le sous-dossier banane vers un nouveau dossier au même niveau que le dossier fourre_tout afin de le cibler comme nouveau dépôt.

1) On clone le dépôt !

D’abord, on clone l’entièreté du dépôt actuel dans un nouveau dossier qui servira de cible au nouveau dépôt :

1

> git clone --no-hardlinks fourre-tout projet_banane

On se retrouve donc avec ceci :

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

<dossier Git>
|
| -- ...
|
| -- <dépôt fourre_tout>
|    -- <banane>
|    -- <pac_man>
|    -- <coffee>
|
| -- <dépôt projet_banane>
|    -- <banane>
|    -- <pac_man>
|    -- <coffee>

2) On trie !

Ensuite on se déplace à l’intérieur du nouveau dossier projet_banane, on supprime tout ce qui n’est pas lié à ce projet et on met le contenu du dossier banane à la racine du dossier projet_banane. Tout ça en seulement trois lignes !

1
2
3

> cd projet_banane
> git filter-branch --subdirectory-filter banane HEAD -- --all
> git reset --hard

Au niveau des fichiers… :

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

<dossier Git>
|
| -- ...
|
| -- <dépôt fourre_tout>
|    -- <banane>
|    -- <pac_man>
|    -- <coffee>
|
| -- <dépôt projet_banane>
|    -- ... (fichiers de ./banane)

3) Et on nettoie !

Maintenant, nous avons les bons fichiers au bons endroits. Mais la base de données de git contient encore toutes les références à tous les autres dossiers/fichiers/commits des autres projets que nous venons d’effacer. Nettoyons tout ça :

1
2

> git gc --aggressive
> git prune

Et voilà ! Nous avons fini de déplacer proprement les fichiers et les commits, il ne nous reste plus qu’à…

Actualiser le dépôt

Ici, c’est la partie la plus simple. Le changement du dépôt d’origine se fait en deux étapes, et il est nécessaire de le faire afin que notre dossier soit bien lié au nouveau dépôt et non plus à l'ancien.

1) En premier, on supprime le lien vers le dépôt actuel (qui est donc celui du premier projet, ce qui ferait des conflits évidemment)

1

> git remote rm origin

2) Ensuite, on indique la nouvelle adresse de référence. Dans mon cas, c’est un dépôt chez BitBucket, mais je vous mets également la version pour GitHub. Pour les autres sites, vous verrez vite ce qu’il faut modifier

1
2
3
4
5
6

(GitHub)
> git remote add origin https://github.com/<nom_d'utilisateur>/<nom_du_dépôt>.git

(BitBucket)
> git remote add origin https://<compte>@bitbucket.org/<utilisateur>/<nom_du_dépôt>.git
(pour moi, c'était Lyyn@bitbucket.org/Lyyn)

3) Pour finir, il ne nous reste plus qu’à pousser tout notre dossier, ses commits, … vers notre nouveau dépôt

1

> git push origin master

Notre mot de passe sera demandé interactivement, pas d’inquiétude

Résultat sur BitBucket

Une image vaut mieux que mille mots, on voit ci-dessous que la création du dépôt date d’il y a 18 heures mais que le premier commit date de bien plus longtemps. Preuve donc que ça a bien fonctionné

Et pas de commentaire sur mon engrish, pitié. Ni de question sur la censure

Bonus : Perte du origin/HEAD

En effectuant ces manipulations, il se trouve que j’ai perdu le “origin/HEAD” qui sert à déterminer le dernier commit effectué. En soit, ce n’est pas bien grave, mais SourceTree se base dessus pour savoir combien de commit(s) doivent être push afin de garder à jour le dépôt distant.

Si jamais vous êtes dans le même cas que moi, retournez sur Git Shell, dans le dossier de votre nouveau dépôt et entrez la ligne de commande suivante :

1

> git symbolic-ref refs/remotes/origin/HEAD refs/remotes/origin/master

Ceci replacera notre origin/HEAD à la position de notre origin/master. Et SourceTree affichera à nouveau fièrement le nombre de commit(s) à push :

Voir : Une explication bien fournie par un utilisateur de Stack Overflow

Voilà donc la fin de ce petit guide qui me sera très certainement encore utile à l’avenir, et s’il peut servir à d’autres personnes, c’est tant mieux. Attention, je ne suis pas à l’abri d’une quelconque erreur ou coquille, si vous en voyez une ou que vous voulez apporter une précision, n’hésitez pas le signaler dans les commentaires.

Ce guide s’inspire très fortement d’un excellent billet de AirBlade Software, retrouvez-le à cette adresse : http://airbladesoftware.com/notes/moving-a-subdirectory-into-a-separate-git-repository/.

Je remercie également Vayel et rz0 pour leur intervention sur ce site dans mon sujet de demande d’aide : http://zestedesavoir.com/forums/sujet/2139/creer-un-nouveau-depot-a-partir-dun-dossier-en-conservant-lhistorique/.

Et vive Git

Liens

[FR] Mon sujet de demande d’aide sur ZdS

[EN] Site de BitBucket
[EN] Site de GitHub
[EN] GitHub for Windows (+ Git Shell)
[EN] Atlassian SourceTree (GUI pour Git/Mercurial)
[EN] Billet de AirBlade Software