Comment utiliser GitHub sur Ubuntu : guide complet du débutant à l’expert avec Git, SSH et VS Code

1. Introduction

Pourquoi connecter Ubuntu à GitHub ?

Ces dernières années, l’utilisation de Git et GitHub est devenue une pratique standard dans le développement logiciel et les opérations système. Pour les ingénieurs et programmeurs travaillant dans des environnements Linux comme Ubuntu, l’intégration à GitHub fait partie du flux de travail quotidien.

Git est un outil de gestion de l’historique des versions du code source et il est essentiel pour une collaboration efficace entre plusieurs développeurs. GitHub, quant à lui, est un service d’hébergement qui permet de partager et de publier en ligne des dépôts gérés par Git, servant de hub mondial où les développeurs échangent du code.

Pourquoi utiliser GitHub sur Ubuntu ?

Ubuntu est une distribution Linux très populaire parmi les développeurs et est reconnue pour sa excellente compatibilité avec le développement open‑source. Elle fournit un environnement où Git et d’autres outils de développement peuvent être installés facilement, rendant l’intégration de GitHub fluide et efficace.

Les cas d’usage typiques de la combinaison Ubuntu + GitHub incluent :

• Gestion et partage de code Python, C++, et autres sur GitHub
• Contribution à des projets open‑source
• Publication de votre travail sous forme de portfolio

Ce que vous apprendrez dans cet article

Ce guide explique tout, des bases aux fonctionnalités avancées de GitHub sur Ubuntu, à travers les étapes suivantes :

• Comment installer Git sur Ubuntu
• Configuration initiale de Git et mise en place de SSH
• Création et gestion de dépôts GitHub
• Développement efficace avec Visual Studio Code
• Astuces de dépannage courantes et FAQ

Même les utilisateurs novices de GitHub peuvent suivre sans risque, grâce à des exemples de commandes réelles et des notes importantes incluses. Si vous souhaitez tirer le meilleur parti de GitHub sur Ubuntu, lisez jusqu’à la fin.

2. Installation de Git sur Ubuntu

Qu’est‑ce que Git ? Un rappel rapide

Git est un système de contrôle de version (VCS) utilisé en développement logiciel pour gérer l’historique des modifications du code source. Il permet aux développeurs de restaurer des états antérieurs et de collaborer simultanément.

Un des grands avantages des environnements Linux comme Ubuntu est la facilité avec laquelle Git peut être installé. En suivant la méthode ci‑dessous, l’installation peut être terminée en quelques minutes via le terminal.

Installation de Git via APT

La façon la plus courante d’installer Git sur Ubuntu est d’utiliser APT (Advanced Package Tool). Suivez ces étapes :

1. Mettre à jour la liste des paquets

sudo apt update

Cette commande récupère les dernières informations sur les paquets. Exécutez‑la toujours avant d’installer un nouveau logiciel.

2. Installer Git

sudo apt install git

Lorsque l’invite « Y/n » apparaît, tapez y puis appuyez sur Entrée pour lancer l’installation.

Vérifier l’installation de Git

Après l’installation, confirmez que Git est correctement installé :

git --version

Si vous obtenez une sortie similaire à celle‑ci‑dessous, Git est installé avec succès :

git version 2.34.1

Le numéro de version peut varier selon votre version d’Ubuntu, mais toute version affichée confirme le succès.

Installation via Snap (optionnel)

Bien que Git puisse également être installé avec la commande snap, APT est généralement plus stable et largement utilisé. Sauf raison particulière, il est recommandé d’utiliser APT.

3. Configuration initiale de Git

Configuration essentielle avant d’utiliser Git

Une fois Git installé, l’étape suivante consiste à configurer les informations utilisateur et l’authentification. Une configuration correcte assure une interaction fluide avec les dépôts distants et les flux de travail d’équipe.

Définir le nom d’utilisateur et l’adresse e‑mail de Git

Git enregistre qui a effectué chaque commit. Vous devez donc configurer un nom d’utilisateur et une adresse e‑mail.

Commandes de configuration

git config --global user.name "Your Name"
git config --global user.email "you@example.com"

Ces valeurs n’ont pas besoin de correspondre exactement à votre compte GitHub, mais utiliser la même adresse e‑mail que celle de GitHub aide à associer correctement les commits.

Vérifier la configuration

git config --list

Cette commande affiche votre configuration Git actuelle.

Génération et enregistrement des clés SSH

Bien que le HTTPS soit pris en charge, l’authentification SSH élimine les invites de mot de passe répétées et offre un flux de travail plus sécurisé et efficace.

1. Générer une clé SSH

ssh-keygen -t ed25519 -C "you@example.com"

Appuyez sur Entrée plusieurs fois pour générer une clé privée (~/.ssh/id_ed25519) et une clé publique (~/.ssh/id_ed25519.pub).

2. Démarrer l’agent SSH et ajouter la clé

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

La clé SSH est maintenant prête à être utilisée.

3. Ajouter la clé publique à GitHub

Copiez la clé publique :

cat ~/.ssh/id_ed25519.pub

Puis enregistrez‑la sur GitHub :

1. Connectez‑vous à GitHub
2. Cliquez sur votre image de profil → Paramètres
3. Sélectionnez « SSH and GPG keys »
4. Cliquez sur « New SSH key », collez la clé, puis enregistrez

4. Tester la connexion SSH

ssh -T git@github.com

Tapez yes lorsqu’on vous demande de faire confiance à l’hôte.

Si la connexion réussit, vous verrez :

Hi your-username! You've successfully authenticated, but GitHub does not provide shell access.

Étapes suivantes recommandées

Avec cette configuration terminée, vous pouvez maintenant cloner, pousser et récupérer des dépôts GitHub. La section suivante explique comment créer et gérer des dépôts GitHub en pratique.

4. Travailler avec des dépôts GitHub

Créer un nouveau dépôt sur GitHub

Après vous être connecté à GitHub, commencez par créer un nouveau dépôt.

Étapes (via le navigateur web)

1. Cliquez sur le bouton « + » en haut à droite de la page d’accueil de GitHub et sélectionnez « New repository ».
2. Saisissez les informations suivantes :

• Nom du dépôt : Exemple : my-first-repo
• Description (facultative) : Une brève explication
• Public / Privé : Choisissez la visibilité du dépôt

1. Cliquez sur « Create repository ».

Après la création, l’URL du dépôt sera affichée. Vous utiliserez cette URL pour cloner et gérer le dépôt.

Cloner un dépôt GitHub existant

Pour copier un dépôt dans votre environnement Ubuntu local, utilisez la commande git clone.

git clone git@github.com:your-username/my-first-repo.git

Cet exemple utilise SSH. Si vous utilisez HTTPS, l’URL sera différente.

Après l’exécution, un répertoire nommé my-first-repo sera créé contenant les fichiers du dépôt.

Modifications de fichiers, mise en scène et flux de travail de commit

1. Ajouter ou modifier des fichiers

Par exemple, créez un nouveau fichier :

echo "# My First GitHub Project" > README.md

2. Mettre les modifications en scène

git add README.md

La mise en scène sélectionne les modifications qui seront incluses dans le prochain commit.

3. Commiter les modifications

git commit -m "Initial commit: add README.md"

Vos modifications sont maintenant enregistrées dans l’historique du dépôt local.

Pousser les modifications vers GitHub

Pour refléter les modifications locales sur le dépôt distant GitHub, utilisez git push.

git push origin main

Si votre branche par défaut n’est pas main (par exemple master), ajustez le nom de la branche en conséquence.

Récupérer les modifications distantes localement

Si un autre développeur a apporté des modifications, utilisez la commande suivante pour mettre à jour votre dépôt local :

git pull origin main

Cela fusionne les modifications distantes dans votre branche locale.

Opérations supplémentaires courantes

• Vérifier les dépôts distants :

  git remote -v
  

• Ajouter un autre dépôt GitHub plus tard :

  git remote add origin git@github.com:your-username/another-repo.git
  

• Modifier README.md ou .gitignore suit le même flux de travail.

5. Intégration avec Visual Studio Code

Pourquoi VS Code est idéal pour les opérations Git

Lorsque vous utilisez GitHub sur Ubuntu, le combiner avec Visual Studio Code (VS Code) améliore considérablement la productivité. VS Code est un éditeur open source développé par Microsoft et est reconnu pour son excellente intégration Git. Il permet les commits, les pushes et les revues de diff via une interface graphique, ce qui le rend convivial pour les débutants.

Installation de VS Code sur Ubuntu

Vous pouvez installer facilement VS Code sur Ubuntu en suivant les étapes suivantes.

1. Ajouter le dépôt Microsoft

sudo apt update
sudo apt install wget gpg
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -o root -g root -m 644 packages.microsoft.gpg /usr/share/keyrings/

2. Enregistrer le dépôt

sudo sh -c 'echo "deb [arch=amd64 signed-by=/usr/share/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/vscode stable main" > /etc/apt/sources.list.d/vscode.list'

3. Installer VS Code

sudo apt update
sudo apt install code

Après l’installation, vous pouvez lancer VS Code en tapant code dans le terminal.

Support Git intégré

VS Code inclut l’intégration Git par défaut, donc aucun plugin supplémentaire n’est requis pour les opérations Git de base. Pour une utilisation avancée, les extensions suivantes sont recommandées :

• GitHub Pull Requests and Issues Permet la gestion des pull requests et des issues via l’interface graphique.
• GitLens Visualise l’historique ligne par ligne, montrant qui a changé quoi et quand.

Opérations Git de base dans VS Code

Ouvrir un dépôt

Naviguez vers votre dépôt cloné et exécutez :

code .

Examiner les modifications et valider

• Cliquez sur l’icône Contrôle de source dans la barre latérale gauche
• Visualisez la liste des fichiers modifiés
• Sélectionnez un fichier pour voir les différences
• Saisissez un message de validation et cliquez sur l’icône ✓

Opérations Push et Pull

• Sélectionnez « Push » ou « Pull » dans le menu « … »
• Ou utilisez la barre d’état en bas à droite

Utiliser le terminal intégré

Le terminal intégré (Ctrl + `) permet de basculer sans effort entre les flux de travail GUI et CLI. Par exemple, vous pouvez valider via l’interface graphique et gérer les branches via le terminal.

Conseils de dépannage

• Si des erreurs SSH surviennent, vérifiez que VS Code fait référence à la bonne clé SSH
• Vous devrez peut-être reconfigurer l’authentification ou utiliser un jeton d’accès personnel GitHub (PAT)

6. Dépannage courant

Erreur SSH : « Permission denied (publickey). »

Causes possibles

• Les clés SSH n’ont pas été générées correctement
• La clé publique n’est pas enregistrée sur GitHub
• L’agent SSH ne charge pas la clé

Solutions

1. Vérifiez la présence d’une clé SSH existante :

   ls ~/.ssh/id_ed25519.pub
   

Si elle n’existe pas, générez‑en une :

ssh-keygen -t ed25519 -C "your_email@example.com"

2. Démarrez l’agent SSH et ajoutez la clé :

   eval "$(ssh-agent -s)"
   ssh-add ~/.ssh/id_ed25519
   

3. Ajoutez la clé publique à GitHub :

   cat ~/.ssh/id_ed25519.pub
   

Ajoutez‑la sous « SSH and GPG keys » sur GitHub.

4. Testez la connexion :

   ssh -T git@github.com
   

Erreur d’authentification avec HTTPS

Cause

• L’authentification par mot de passe est obsolète ; l’authentification basée sur un jeton est requise

Solution

1. Créez un jeton d’accès personnel sur GitHub https://github.com/settings/tokens Cochez le scope repo lors de la création du jeton
2. Utilisez votre nom d’utilisateur GitHub et la chaîne du jeton comme mot de passe
3. Activez la mise en cache des informations d’identification si souhaité :

   git config --global credential.helper cache
   

Erreur : « fatal: not a git repository »

Cause

• Le répertoire actuel n’est pas un dépôt Git

Solution

• Déplacez‑vous dans un répertoire de dépôt existant :

  cd ~/your-project-directory
  

• Ou initialisez un nouveau dépôt :

  git init
  

Gestion des conflits de fusion

Cause

• Les conflits surviennent lorsque plusieurs utilisateurs modifient simultanément la même section d’un fichier

Solution

1. Ouvrez le fichier en conflit après une erreur git pull
2. Recherchez les marqueurs de conflit :

   <<<<<<< HEAD
   Your changes
   =======
   Other changes
   >>>>>>> origin/main
   

3. Modifiez le contenu, supprimez les marqueurs et enregistrez
4. Puis exécutez :

   git add .
   git commit
   

Erreur : « remote: Repository not found. »

Cause

• URL du dépôt incorrecte
• Aucun droit d’accès au dépôt

Solution

• Vérifiez l’URL distante :

  git remote -v
  

• Réinitialisez l’URL si nécessaire:

  git remote set-url origin git@github.com:your-username/your-repo.git
  

Ces problèmes surviennent couramment chez les débutants. Cependant, avec des causes et des solutions claires, ils peuvent être résolus calmement. Traitez les erreurs comme des opportunités d’apprentissage et construisez progressivement votre confiance.

7. FAQ

Q1. Quelle est la différence entre Git et GitHub ?

A :
Git est un outil de contrôle de version qui gère l’historique des changements localement. GitHub est un service cloud qui héberge des dépôts Git et permet le partage et la collaboration.

• Git : Gestion d’historique local et hors ligne
• GitHub : Hébergement de dépôts en ligne et collaboration

Q2. Dois-je utiliser SSH ou HTTPS ?

A :
SSH est recommandé parce que :

• Pas de saisie répétée de mot de passe
• Plus sécurisé et pratique à long terme

Cependant, HTTPS peut être requis dans certains environnements d’entreprise ou réseau.

Q3. Comment puis-je utiliser plusieurs comptes GitHub sur Ubuntu ?

A :
Générez des clés SSH séparées pour chaque compte et configurez-les explicitement.

1. Créez des clés SSH séparées Exemples : ~/.ssh/id_ed25519_work , ~/.ssh/id_ed25519_personal
2. Éditez ~/.ssh/config :

   Host github.com-work
       HostName github.com
       User git
       IdentityFile ~/.ssh/id_ed25519_work
   
   Host github.com-personal
       HostName github.com
       User git
       IdentityFile ~/.ssh/id_ed25519_personal
   

3. Mettez à jour l’URL distante :

   git remote set-url origin git@github.com-work:your-work-user/your-repo.git
   

Q4. Puis-je utiliser Git avec une interface graphique ?

A :
Oui. Visual Studio Code fournit des opérations Git basées sur une interface graphique, y compris les commits, les pushes, les diffs et la gestion des branches. Il est hautement recommandé pour les débutants.

Q5. Que se passe-t-il si je supprime le dépôt distant ?

A :
Supprimer un dépôt distant n’affecte pas le dépôt local. Cependant, git push échouera.

Vous pouvez vous reconnecter à un nouveau distant comme suit :

git remote set-url origin git@github.com:new-user/new-repo.git

Q6. Est-il possible d’éviter complètement le terminal ?

A :
Oui. Les clients Git avec interface graphique permettent des workflows sans terminal :

• GitKraken
• Sourcetree (non officiellement supporté sur Linux)
• Visual Studio Code (support Git intégré)

Pour les utilisateurs Ubuntu, la combinaison VS Code + GitLens est la plus pratique et conviviale.

Q7. Jusqu’où peut remonter l’historique Git ?

A :
Git préserve tout l’historique depuis le tout premier commit. Vous pouvez le visualiser en utilisant :

git log

Pour visualiser l’historique d’un fichier spécifique :

git log path/to/file