Git et Github

Attention !

• Cette page contient des extraits de code bash. Il faut toujours comprendre ce que le code proposé fait avant de l’exécuter, d’autant plus plus lorsque ce code nécessite les privilèges d’administration (sudo).

• L’article est encore en cours de rédaction, des améliorations seront faites prochainement.

Si tu es ici, c’est que tu sais déjà à quoi sert Git et que tu souhaites commencer à l’utiliser ! Et c’est une très bonne idée !

Première étape : installer Git

La première chose à faire, c’est d’installer Git. La façon de le faire est différente en fonction du système d’exploitation mais il n’y a rien de compliqué, c’est juste un logiciel comme un autre.

Windows

Il existe une version de Git pour Windows qui est disponible depuis la page de téléchargement officielle.

Il suffit de télécharger puis ouvrir l’exécutable qui correspond à votre système (en général le 64-bit).

Laissez les options par défaut, ça sera très bien pour commencer !

Linux

Le gestionnaire de paquets de votre distribution fera l’affaire !

Sur Debian on peut le faire avec apt :

apt install git

Sur les autres distributions il faudra juste utiliser le gestionnaire par défaut (dnf, pacman… ).

Deuxième étape : entrer dans le terminal

Eh oui, git est un logiciel dit “en ligne de commande” ! Ça veut dire que pour l’utiliser il faut écrire des lignes de code dans un terminal.

Mais avant de paniquer, voici quelques infos qui vont vous rassurer :

1. si on a peur d’oublier comment fonctionne le logiciel, on peut écrire les commandes utiles dans un carnet ou sur un ficher de l’ordinateur;
2. en vrai, il y a pas tant de commandes que ça donc c’est très facile de s’en rappeler;
3. quand on cherche de l’aide, c’est super facile de trouver sur internet (ou ChatGPT) des commandes qui fonctionnent ;
4. utiliser le terminal, ça donne l’impression d’être vraiment pro !

Troisième étape : configurer Git

On va ajouter quelques configurations au fichier ~/.gitconfig

• git config --global user.email "arsene.lupin@monemail.com"

• git config --global user.name "gentlemancambrioleur"

• git config --global init.defaultBranch main

• git config --global core.editor "nvim -u NONE"

Quatrième étape : le dépôt distant

Quéssé ça un dépôt distant ?!

Je suis sûr que tu as déjà croisé Github. Il s’agit d’un service de stockage en ligne, un peu comme Google Drive. Mais contrairement au service de Google, GitHub permet essentiellement de stocker (mais pas que !) du code.

L’avantage avec GitHub, c’est que l’on peut communiquer avec directement depuis Git. Et ça c’est vraiment très pratique !

Mais avant que Git (sur ton ordinateur) et GitHub (sur internet) puissent communiquer, il faut quelques étapes.

Créer un compte

Rien de plus simple, c’est juste un service en ligne comme un autre. Alors tu peux aller sur github.com et créer un compte !

Tip

Choisis bien ton nom d’utilisateur, sur GitHub, c’est ce nom qui va se retrouver dans l’url permettant d’accèder à ta page perso. Donc si tu rends ton code publique un jour, ce nom sera celui qui sera affiché.

Une fois que tu as ton compte on va pouvoir le faire communiquer avec Git. Pour cela, la solution la plus pratique est SSH.

Générer des clés SSH

Alors là on s’attaque aux choses sérieuses ! C’est probable que tu ne saches pas ce qu’est SSH alors voici le principe :

Pour communiquer, ton ordinateur (avec Git dessus) et le serveur de GitHub doivent établir une connexion sécurisée. Cette connexion empèche les personnes malveillantes de voir ou modifier au passage ce que tu échanges avec GitHub. SSH est un logiciel permettant de sécuriser ce type de communication. Pour cela, on utilise deux fichiers, que l’on appelle des clés.

Tip

Pour établir une communicatin sécurisée entre un ordinateur et un serveur, SSH utilise une clé dite privée et une clé dite publique. La clé privée doit rester sur l’ordinateur et ne surtout pas être partagée. La clé publique doit quant à elle être donnée au serveur. Une fois la clé privée, bien en sécurité sur l’ordinateur et la clé publique donnée à GitHub, la communication peut se faire de manière sécurisée.

Les fichiers contenant les clés SSH sont généralement placés dans un dossier spécifique sur l’ordinateur, ce qui permet au système de les retrouver facilement.

Chaque utilisateur possède son propre dossier de clés SSH nommé .ssh et placé à la racine du dossier personel de l’utilisateur. S’il n’existe pas encore c’est possible de le créer.

Windows

C:\Users\<nom_utilisateur>\.ssh

Linux

/home/<nom_utilisateur>/.ssh

Pour générer un jeu de clés SSH (une clé privée et une clé publique), il suffit de lancer la commande suivante :

ssh-keygen -t ed25519

On nous demande de spécifier un nom de fichier pour stocker ces clés. Comme les clés seront utilisées pour communiquer avec le compte GitHub d’Arsène, on va mettre github_arsene_lupin.

Une fois le nom du fichier entré, on nous demande un mot de passe. C’est une sécurité permettant de protéger l’accès à la clé privée. Si l’on ne souhaite pas mettre de mot de passe, il suffit d’appuyer sur Entrée.

Une fois toutes les étapes complétées, SSH a créé deux fichiers :

• la clé privée : github_arsene_lupin (à ne surtout pas partager)

• et la clé publique : github_arsene_lupin.pub.

Tu peux ouvrir le fichier contenant la clé publique, à l’intérieur il doit y avoir quelque chose qui ressemble à ça :

github_arsene_lupin.pub

ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAICoyAUJwwKgKMrFgORyqSdEPqjYMYXwnDCDO59GCmYlV

Pas d’inquiètude, ce n’est pas prévu pour être lu par des humains !

Il ne nous reste maintenant qu’une seule étape : donner cette clé publique à GitHub !

Ajouter une clé SSH sur GitHub

On va installer une clé ssh sur le compte GitHub d’Arsène Lupin.

1. Depuis ta page de profil GitHub, clique sur ton image de profile en haut à droite pour ouvrir le menu. Dans ce menu, clique sur Settings.

2. Une fois dans le menu de configuration, clique sur SSH and GPG keys. Puis, clique sur le bouton vert New SSH key.

3. Tu peux alors entrer le titre de la clé dans la case Title (ce que tu mets n’as pas vraiment d’importance, c’est juste pour te souvenir de quel ordinateur est lié à cette clé) et copier la clé publique dans la case Key.

4. Cliques enfin sur Add SSH key et voilà, c’est fini !

Références

Git possède une documentation très complète et, chose rare, en Français !! Il est certain que la réponse à beaucoup de questions s’y trouve.

Sinon, en anglais mais très vulgarisé voici quelques références intéressantes :

• Happy Git With R pour apprendre à configurer Git pour RStudio.
• Software Carpentry est un tutoriel complet et ludique pour prendre en main Git.