Initialiser un dépôt git

Rappel

Le dépôt est le répertoire racine contenant l'ensemble des fichiers versionnés.

depuis un de vos répertoires

La première étape consiste à créer un dépôt git[1]. N'importe lequel de vos répertoires peut devenir un dépôt git[1], il suffit de l'initialiser.

En ligne de commandes, dans un terminal, et à partir du répertoire qui deviendra le dépôt, c'est très simple, il suffit de taper la commande :

Syntaxeinit

git init

Cela signifie, que le dossier où l'on se trouve doit être considéré comme un dépôt versionné. Tous les fichiers qui s'y trouvent déjà, ou qui vont ensuite s'y trouver, pourront être versionnés.

Pour que ce soit le cas, il faut ajouter ces fichiers à l'index des fichiers versionnés (les autres seront tout simplement ignorés).

On peut ajouter un fichier spécifique (en le nommant), ou l'ensemble des fichiers présents dans ce dossier, en utilisant * :

Syntaxeadd

git add mon_fichier.txt

ou

git add *

ou pour ajouter tous les fichiers ayant une même extension :

git add *.m

Enfin, pour garder une trace de l'état du dépôt à un temps donné, on effectue un check-in par la commande commit :

Syntaxecommit

git commit

à partir d'un dépôt distant pré-existant

Il peut arriver que vous ne soyez pas à l'origine du dépôt, mais que vous vouliez initialiser un dépôt à partir d'un dépôt existant (dont l'adresse peut être du type git://path_to_depot/depot.git).

Dans ce cas-là, il faut cloner le dépôt existant, dans le répertoire courant, ou dans le répertoire cible de votre choix.

Syntaxeclone

git clone git://path_to_depot/depot.git

ou

git clone git://path_to_depot/depot.git ./chemin_local_vers_mon_depot

Syntaxe

Si vous êtes amené à contribuer à un projet existant, vous devez récupérer l'état actuel du dépôt existant :

git clone /chemin/du/depot /chemin/de/la/copie/locale

Par cette commande, on effectue une copie locale de l'ensemble des fichiers constituants le dépôt.

Remarque

Si le dépôt est physiquement sur un serveur distant, le simple chemin peut être remplacé par une adresse de type ssh://login@machine/chemin/du/depot si le dépôt est accessible par ssh.

Certains projets peuvent être hébergés par des plate-formes spécifiques. C'est le cas de nombreux projets de logiciel libre.

L'adresse d'accès au dépôt est alors du type : git://git.serveur.fr/trunk ou  http://git.serveur.fr/trunk.

Exemple

On peut citer comme exemples de plate-forme d'hébergement git[1] :