Aller au contenu principal

TP1 — Installation & Premier Dépôt

Travaux Pratiques 45 min Module 00

Objectifs​

À la fin de ce TP, vous aurez :

  • Git installé et vérifié sur votre machine
  • Votre identité configurée (nom + email)
  • Une clé SSH générée et ajoutée à GitHub
  • Votre premier dépôt créé
  • Votre premier commit effectué
  • Un fichier .gitignore configuré
  • Le résultat poussé sur GitHub

Partie 1 : Vérifier l'installation​

Ouvrez votre terminal et exécutez :

# Vérifier la version de Git (doit être 2.x.x)
git --version

# Vérifier GitHub CLI
gh --version

# Vérifier que l'agent SSH est en cours d'exécution
ssh-agent -s
Résultats attendus

Vous devriez voir des numéros de version pour chaque commande. Si l'une d'elles échoue, revenez à la leçon d'installation.

Partie 2 : Configurer Git​

# Configurer votre identité (remplacez par vos vraies informations)
git config --global user.name "Votre Nom Complet"
git config --global user.email "votre.email@exemple.com"

# Configurer VS Code comme éditeur
git config --global core.editor "code --wait"

# Définir 'main' comme branche par défaut
git config --global init.defaultBranch main

# Configurer les fins de ligne
# Windows :
git config --global core.autocrlf true
# macOS/Linux :
git config --global core.autocrlf input

# Ajouter des alias utiles
git config --global alias.lg "log --oneline --graph --decorate --all"
git config --global alias.st status

# Vérifier votre configuration
git config --list

Sortie attendue de git config --list :

user.name=Votre Nom Complet
user.email=votre.email@exemple.com
core.editor=code --wait
init.defaultbranch=main
core.autocrlf=true (ou input)
alias.lg=log --oneline --graph --decorate --all
alias.st=status

Partie 3 : Configuration de la clé SSH​

# Générer une clé SSH (remplacez par votre email)
ssh-keygen -t ed25519 -C "votre.email@exemple.com"
# → Appuyez sur Entrée pour toutes les invites (ou ajoutez une phrase de passe pour plus de sécurité)

# Démarrer l'agent SSH
eval "$(ssh-agent -s)"

# Ajouter la clé à l'agent
ssh-add ~/.ssh/id_ed25519

# Afficher votre clé publique pour la copier
cat ~/.ssh/id_ed25519.pub

Sur GitHub :

  1. Rendez-vous sur github.com/settings/keys
  2. Cliquez sur New SSH key
  3. Titre : Mon Laptop 2026
  4. Collez le contenu de la clé
  5. Cliquez sur Add SSH key

Tester la connexion :

ssh -T git@github.com
# Attendu : Hi votre-username! You've successfully authenticated...

Partie 4 : Créer votre premier projet​

# Créer le dossier du projet
mkdir git-tp1-premier-projet
cd git-tp1-premier-projet

# Initialiser Git
git init

# Vérifier que le dossier .git a été créé
ls -la

Créer les fichiers du projet​

Créez un fichier README.md avec ce contenu :

# Mon Premier Projet Git

Un projet créé pendant le cours Git & GitHub sur InSkillBoost.

## Auteur

Votre Nom — votre.email@exemple.com

## Description

Ce projet démontre les concepts de base de Git :
- Initialisation d'un dépôt
- Staging et commit
- Gestion de l'historique

Créez un fichier hello.py :

def saluer(nom):
    """Saluer une personne par son nom."""
    return f"Bonjour, {nom} ! Bienvenue dans Git."

if __name__ == "__main__":
    print(saluer("Monde"))
    print(saluer("Git"))

Créez un fichier .gitignore :

# Python
__pycache__/
*.pyc
*.pyo
venv/
.env

# OS
.DS_Store
Thumbs.db

# Éditeur
.vscode/
.idea/
*.swp

Partie 5 : Vos premiers commits​

# Vérifier l'état initial
git status

Vous devriez voir 3 fichiers non suivis.

# Ajouter README.md en premier
git add README.md
git status
# README.md devrait apparaître sous "Changes to be committed"
# Faire le premier commit
git commit -m "docs: ajout du README avec description du projet"
# Ajouter les fichiers restants
git add hello.py .gitignore
git status
# Faire le deuxième commit
git commit -m "feat: ajout de hello.py et .gitignore"
# Voir l'historique
git log
git lg   # avec l'alias que nous avons créé

Partie 6 : Pousser sur GitHub​

Créer le dépôt sur GitHub​

# Utiliser GitHub CLI pour créer le dépôt
gh repo create git-tp1-premier-projet --public --description "TP1 - Premier Dépôt Git"

Ou manuellement :

  1. Rendez-vous sur github.com/new
  2. Nom du dépôt : git-tp1-premier-projet
  3. Ne pas initialiser avec un README (nous en avons déjà un en local)
  4. Cliquez sur Create repository

Lier et pousser​

# Ajouter le remote (remplacez par votre nom d'utilisateur GitHub)
git remote add origin git@github.com:VOTRE_USERNAME/git-tp1-premier-projet.git

# Pousser vos commits
git push -u origin main
# Vérifier sur GitHub
gh repo view --web
# Ou ouvrez votre navigateur sur votre dépôt GitHub

Checklist de validation​

Vérifiez chaque point avant de marquer le TP comme terminé :

  • git --version affiche la version 2.x.x
  • git config user.name affiche votre nom
  • git config user.email affiche votre email
  • ssh -T git@github.com réussit
  • git log affiche 2 commits avec des messages significatifs
  • Le fichier .gitignore est commité
  • Le dépôt est visible sur GitHub avec les deux commits

Défis bonus​

  1. Modifier README.md → Ajouter une section « Technologies utilisées » → Faire un troisième commit
  2. Créer un dossier src/ avec un fichier utils.py → Ajouter et commiter
  3. Tester .gitignore : Créer un dossier venv/ → Vérifier que git status ne le montre pas
  4. Explorer git show : git show HEAD — que s'affiche-t-il ?

Erreurs courantes à éviter​

Commité un fichier .env par accident ?
# Supprimer du suivi (mais garder le fichier localement)
git rm --cached .env

# Ajouter .env à .gitignore
echo ".env" >> .gitignore

# Commiter la correction
git add .gitignore
git commit -m "fix: supprimer .env du suivi"

Si vous avez déjà poussé sur GitHub, vous devez informer votre équipe et faire tourner toutes les credentials !

Mauvais message de commit ?
# Corriger le DERNIER commit (avant de pousser)
git commit --amend -m "Nouveau message correct"

# Attention : ne jamais amender un commit déjà poussé sur une branche partagée
Oublié d'ajouter un fichier au dernier commit ?
# Ajouter le fichier oublié
git add fichier-oublie.txt

# L'ajouter au dernier commit
git commit --amend --no-edit
# --no-edit conserve le message de commit original

Résumé​

Vous avez réussi à :

  1. Installer et configurer Git
  2. Mettre en place l'authentification par clé SSH
  3. Créer un dépôt Git local
  4. Effectuer plusieurs commits significatifs
  5. Pousser votre travail sur GitHub

Vous êtes prêt pour le Module 01 — Fondamentaux Git !