Guide complet de Git : de l’installation au dépannage | Gestion efficace de Git sous Ubuntu

1. Qu’est‑ce que Git ? Pourquoi installer Gitsur Ubuntu ?

Notions de base de Git

Git est un système de contrôle de version distribué qui permet à plusieurs développeurs de collaborer efficacement sur des projets logiciels. Il permet de gérer les projets à la fois à distance et localement tout en suivant les modifications.

Utiliser Git sur Ubuntu

Ubuntu est un excellent environnement de développement open source avec une grande compatibilité avec Git, ce qui en fait une plateforme privilégiée pour les développeurs.

2. Préparer l’installation de Git

Mise à jour du système

Mettez à jour votre système vers la dernière version en utilisant les commandes suivantes :

sudo apt update
sudo apt upgrade

Vérification des privilèges sudo

Vous avez besoin des privilèges sudo. Utilisez la commande whoami pour vérifier si votre utilisateur possède des permissions administratives.

3. Installation de Git depuis le dépôt Ubuntu par défaut

Installez Git en utilisant la commande suivante :

sudo apt install git

Il est également recommandé d’installer la dernière version via un PPA. Utilisez les commandes suivantes :

sudo add-apt-repository ppa:git-core/ppa
sudo apt update
sudo apt install git

4. Configuration initiale de Git

Configuration du nom d’utilisateur et de l’e-mail

Avant d’utiliser Git, vous devez configurer votre nom d’utilisateur et votre adresse e-mail, qui seront affichés dans l’historique des commits.

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

5. Comment cloner un dépôt Git

Pour cloner un dépôt distant, utilisez la commande suivante:

git clone https://github.com/example/repo.git

6. Dépannage de l’authentification, des autorisations et des conflits de fusion

Erreurs d’authentification avec git push

Depuis 2021, GitHub et d’autres plateformes ont déprécié l’authentification par mot de passe au profit des Personal Access Tokens (PAT) et de l’authentification SSH. Si vous rencontrez une erreur d’authentification lors de l’utilisation de git push, essayez les étapes suivantes :

1. Générer un PAT: Créez un jeton d’accès personnel dans les paramètres GitHub et utilisez-le comme votre mot de passe pour le prochain git push.
2. Vérifier les clés SSH : Si vous utilisez l’authentification SSH, vérifiez et ajoutez votre clé SSH en utilisant la commande suivante:

ssh-add ~/.ssh/id_rsa

Erreurs d’autorisation avec git push

Si vous rencontrez une erreur « Permission denied » lors de l’exécution de git push, il se peut que vous n’ayez pas les autorisations requises pour le dépôt distant. Pour résoudre ce problème, suivez les étapes suivantes :

1. Vérifiez les paramètres distants:

git remote -v
git remote show origin

1. Vérifier les autorisations de push: Assurez-vous d’avoir l’accès en push au dépôt distant. Sinon, demandez l’autorisation au propriétaire du dépôt.
2. Mettre à jour l’URL distante: Définissez l’URL distante correcte en utilisant la commande suivante:

git remote set-url origin <new-url>

Erreurs de branche distante lors de l’utilisation de git pull

Si vous recevez une erreur indiquant que la remote branch cannot be found lors de l’exécution de git pull, essayez les solutions suivantes :

1. Vérifier les branches distantes disponibles:

git branch -r

1. Configurer le suivi pour une branche:

git branch --set-upstream-to=origin/<branch> <branch>

1. Récupérer les modifications distantes: S’il y a des mises à jour sur le dépôt distant, utilisez git fetch pour récupérer les dernières modifications. Si la branche distante a été supprimée, vous pourriez rencontrer une erreur lors de l’exécution de git pull.

7. Comment créer une pull request sur GitHub

Créer une pull request sur GitHub implique les étapes suivantes :
1. Créer une nouvelle branche
2. Effectuer et valider les modifications
3. Pousser la branche vers le dépôt distant
4. Ouvrir une pull request

8. Résumé et étapes suivantes

Une fois que vous êtes à l’aise avec les opérations de base de Git et le dépannage, vous pouvez explorer des techniques plus avancées telles que git rebase et Git Flow pour une meilleure gestion de projet.