GERBELOTBARILLON.COM

GitHub permet de disposer d'un stockage délocalisé de vos projets. C'est ce que l'on appelle un repository. Celui-ci peut être de deux types :

• local : ensemble de dossiers stockés localement sur votre machine de développement avec gestion des différentes versions. Accessible uniquement par vous.
• distant : même principe qu'en local à part le fait d'avoir un stockage pouvant être partagé avec des personnes définies (stockage privé) ou ouvert au grand public (stockage public).

Lorsque vous collaborez à un projet soumis à un gestionnaire de versions, vous effectuez d'abord une copie locale (un clone) sur lequel les modifications seront apportées. Par la suite le dépôt distant sera mis à jour en respectant l'ordre des modifications, qui a fait quoi, et pour quelles raisons. C'est donc un excellent moyen de collaborer sur un projet sans passer du temps à se réunir pour mettre manuellement les modifications dans le projet d'origine.

GitHub est la plateforme retenue pour cette discussion et est plébiscitée par un grand nombre de développeurs et dispose d'un mode d'accès par abonnement (gratuit et payant). Pas d'inquiétude avec l'abonnement gratuit on peut faire déjà beaucoup de choses.

Il existe d'autres plateformes pour gérer le versionning :

• GitLab : alternative à GitHub, disposant d'une version gratuite que vous pouvez héberger par vous-mêmes. GitLab est apparue suite au rachat de GitHub par Microsoft (il y a toujours des anti quelquechose...).
• Bitbucket : solution supportée par Atlassian qui correspondra aux usagers des solutions de gestion de projets de la même marque (Trello et Jira notamment). Une version gratuite existe également si besoin).

Installer Git pour Windows uniquement

Avant d’utiliser les outils git il est intéressant d’installer l’application Git Bash qui permettra de gérer correctement les mises à jour depuis et vers le repository Git.

Téléchargez l’application depuis https://gitforwindows.org

Vous obtenez un shell Bash, une GUI et une intégration avec l’explorateur Windows (clic-droit > ouvrir un shell git ici)

Installer Git pour Windows, Mac et Linux

Une autre source d’installation est la suivante : https://git-scm.com. Cela permet de récupérer les installations Git pour Windows, MAC et Linux.

Créer un repository sur GitHub

• Se rendre sur l’URL https://github.com
• S’enregistrer si ce n’est pas déjà fait (avec le bouton Sign Up en haut à droite de la page principale)
• Créer un nouveau repository (avec le symbole plus en haut à droite)
• Donner un nom au repository
• Donner une description simple
• Choisir un repository privé
• Ajouter un README à la page du repository
• Ajouter un fichier .gitignore en choisissant Visual Studio
• Vous pouvez également choisir une licence de distribution mais comme c’est pour un usage privé pas besoin.

Cloner un repository en local

Depuis le bouton Code, récupérez le lien vers le repository.

Créez un dossier qui contiendra votre repository en local (pour votre développement) et faites un clic droit > Git Bash Here. Depuis ce shell Bash, faîtes :

• git clone "copiez le chemin de votre repository obtenu précédemment"
• git status
• git pull (permet de mettre à jour la source de git)

Initialiser Git

• Lancez Git Bash (sous Windows) ou démarrez votre shell préféré.
• Créez un dossier et rendez-vous dans ce dossier (par exemple nommez-le testgit).
• Configurez votre nom : git config --global user.name "votre nom ici"
• Configurez votre email : git config --global user.email "votre email ici"
• Configurez ensuite les couleurs du gestionnaire de versions en mode automatique
  • git config --global color.diff auto
  • git config --global color.status auto
  • git config --global color.branch auto
• Configurez maintenant les outils de l'éditeur
  • git config --global core.editor vim
  • git config --global merge.tool vimdiff

Pour vérifier les différents paramètres, vous pouvez utiliser la commande git config --list qui affichera les différents paramètres globaux. Si, pour des prochains projets, vous êtes amenés à modifier des éléments, vous pourrez le faire en ne précisant pas --global dans les options.

Commandes Git

Les commandes utiles de Git au quotidien

• git init : création de l'arborescence locale sous la forme d'un dossier caché .git
• git status : affiche la liste des dossiers synchronisés et les éléments modifiés mais non pris en compte
• git add . : pour ajouter le dossier courant au prochain commit. ATTENTION: il y a bien un '.' à la fin de la commande pour indiquer que l'on traite le dossier courant.
• git add fichier : pour ajouter le fichier nommé au prochain commit.
• git commit -m "message" : permet d’identifier les modifications en inscrivant un message dans le repository à côté des fichiers modifiés.
• git remote add origin https://github.com/your_name/git_repository.git
• git push : permet d’envoyer le commit sur le serveur
• git branch [nom_de_la_branche] : manipule la liste des branches disonibles sur votre repository. Sans nom spécifié, affiche la liste. Si le nom de la branche est précisé, alors signale à git de basculer vers la nouvelle branche.
• git checkout nom_de_la_branche : bascule le flux de git sur la branche nommée.

Mettre à jour le repository distant

• Depuis votre GitHub, récupérez le lien vers ce dépôt (lien au format .git)
• Depuis votre dossier repository local, faites git remote add origin <votre lien.git>
• git branch -M main pour relier le dossier local au distant
• git push -u origin main pour pousser les données sur votre repository distant nommé main. Si vous avez ajouté une branche, en faisant git push -u origin nouvelle_branche vous créez la nouvelle branche.

Fusionner deux branches

Placez-vous sur la branche qui va recevoir la fusion avec git checkout main et vérifiez que c'est bien le cas en faisant git branch.

Tapez ensuite la commande git merge branche_à_fusionner