Tuto des principales commandes git¶

Ce tuto présente les principales commandes git, lorsqu’on souhaite l’utiliser en mode Terminal (à l’aide de commandes manuelles).

Remarque : Vous devez savoir ouvrir un Terminal (parfois appelé Invite de commande) sur votre machine, quelque soit le système d’exploitation (Windows, Linux, ou Mac OS X). Sous Windows 10 (et antérieur), vous pourrez utiliser le programme Windows Powershell qui est très similaires au Terminal de Linux et de Mac OS X.

Vous devez aussi savoir a minima naviguer dans vos dossiers à l’aide de la commande cd. Typiquement :

cd c:\Users\stephane\TP_Hadoop # Windows
cd ~\stephane\TP_Hadoop        # Mac, linux

Si vous souhaitez remonter d’un niveau dans la hiérarchie des dossiers: cd ... Des tutos vidéo existent pour découvrir les commandes de bases (identiques à celles que l’on retrouve sur les systèmes Linux).

Configuration de git (à faire une fois pour toute)

>> cat ~/.gitconfig
>> git config --global color.ui true
>> git config --global user.name "votre_pseudo"
>> git config --global user.email moi@email.com
>> git config --global core.editor geany                                       # for Linux if installed
>> git config --global core.editor "/App.../Sublime\ Text.app/.../bin/subl -w" # for Mac if installed
>> git config --global core.autocrlf true                                      # for Windows
>> git config --list
>> cat ~/.gitconfig

git clone / status / log

>> git clone https://gitlab.com/SDerrode/Test.git
>> cd Test
>> git status
>> git log

Il s’agit ici du clonage, sur votre machine, d’un projet existant stocké sur gitlab (ou github).

Modification d’un fichier existant

>> subl readme.md                               # modification du fichier
>> git status
>> git commit -a -m "modification de readme.md"
>> git status
>> git log

Création d’un fichier et ajout à git

>> touch prog.py                          # création d''un nouveau fichier vide
>> subl prog.py                           # écriture d''un programme dans le fichier
>> python prog.py                         # Windows: >> python.exe prog.py
>> git status
>> git add prog.py                        # suivi du fichier par git
>> git add -A                             # suivi de tous les nouveaux fichiers 
>> git commit -a -m "ajout d'un fichier"
>> git status
>> git log

On peut utiliser ce procédé pour ajouter un fichier gitignore sur la racine du projet.

Différence entre 2 commits

>> git diff HEAD^ HEAD README.md  # entre l'avant dernier et le dernier commit

On peut remplacer HEAD^ et HEAD par deux numéros de commit.

Revenir en arrière

>> git reset --hard 82f5     # attention suppression des commit les plus récents!
>> git checkout 1ce87820b4b1 # bref saut dans un commit précédent
>> git log
>> ls
>> git checkout master (on revient dans l''état initial)
>> git log
>> ls

Publication vers gitlab/github et mise à jour depuis gitlab/github

>> git status
>> git push    # publication vers gitlab/github de tous les nouveaux commits
>> git pull    # récupération des changements publiés par d'autres

Si un collègue du projet à mis à jour le dépôt gitlab/github, alors il faut fusionner ces modifications avec vos propres travaux, localement sur votre machine. Avant de lancer la commande, pensez à commiter vos propres changements. Si la fusion pose problèmes (vous avez travaillé sur le même bout de code et vos corrections ne sont pas fusionable de manière automatique), alors git vos informe de la procédure manuelle à suivre.

Création d’une branche Les branches sont essentiellement utilisées pour tester une idée sans perturber le projet. Vous pouvez générer des commits sur la branche, indépendamment de la branche principale. Si vous validez cette idée, alors il devient possible de fusionner la branche avec la branche principale:

>> git branch essai                                # on créé une nouvelle branche essai
>> git branch
>> git checkout essai                              # on bascule vers cette branche
>> touch ALIRE.tx
>> subl ALIRE.tx
>> git add ALIRE.tx
>> git commit -a -m "add file ALIRE.tx"
>> ls
>> git log
>> git checkout master
>> ls
>> git merge essai -m "merge de la branche essai"  # vous pouvez préciser un message qui explique le merge
>> ls
>> git branch -d essai                             # destruction de la branche après merge

On peut très bien merger une branche et continuer son développement pour faire un second merge plus tard. On peut aussi publier la branche sur gitlab/github (pour l’instant elle ne reste que locale).

Tagger une version

>> git tag -a v0.1 HEAD -m "my version 0.1"
>> git tag                                  # liste les tags
>> git push --tags                          # envoi des tag sur le dépôt gitlab/github

Archiver une version La commande suivante permet de générer un fichier compressé comprenant l’état actuel de votre projet (il ne contient pas les fichiers spécifiques au suivi par git, tels le répertoire .git ou le fichier .gitignore).

>> git archive --format=tgz --prefix=git-0.1/ HEAD >git-0.1.tgz
>> ls