Configurer un Dépôt Git

Mettre en place Git nécessite deux étapes : créer un dépôt distant (remote) sur une plateforme, puis configurer un dépôt local sur votre machine.

Étape 1 — Dépôt distant (Remote Repository)

Plateformes Git

Les entreprises hébergent souvent leur propre serveur Git (GitLab CE, Gitea) pour garder le code en interne.

Visibilité du dépôt

Créer un repo sur GitLab / GitHub

1. Se connecter → New Project / New Repository
2. Renseigner : nom du projet, description
3. Choisir : Private ou Public
4. Créer le projet
→ Le repo est vide, prêt à recevoir du code

Étape 2 — Dépôt local (Local Repository)

Installer Git

Pour interagir avec Git en ligne de commande :

# Ubuntu / Debian
sudo apt install git

# macOS (Homebrew)
brew install git

# Vérifier l'installation
git --version

Clients UI alternatifs : GitKraken, SourceTree, VS Code (intégration native)

Configurer votre identité (obligatoire)

Avant tout commit, Git a besoin de savoir qui vous êtes :

git config --global user.name "Alice Dupont"
git config --global user.email "alice@email.com"

# Vérifier la configuration
git config --list

--global = s'applique à tous vos projets sur cette machine. Sans cette configuration, vos commits n'auront pas d'auteur identifié.

Authentification SSH — Obligatoire pour push/pull

Pour connecter votre machine locale aux plateformes distantes (GitHub/GitLab), vous devez vous authentifier via une clé SSH.

1. Générer une paire de clés SSH

ssh-keygen -t ed25519 -C "alice@email.com"
# Appuyer sur Entrée pour accepter l'emplacement par défaut
# Clés créées dans : ~/.ssh/id_ed25519 (privée) et ~/.ssh/id_ed25519.pub (publique)

2. Copier la clé publique

cat ~/.ssh/id_ed25519.pub
# Copier l'output (commence par "ssh-ed25519 ...")

3. Ajouter la clé sur GitLab / GitHub

GitLab : Settings → SSH Keys → Add key → coller la clé publique
GitHub : Settings → SSH and GPG keys → New SSH key → coller la clé publique

Votre machine                    GitLab / GitHub
~/.ssh/id_ed25519 (privée) ──►  SSH Keys (clé publique enregistrée)
~/.ssh/id_ed25519.pub            → Authentification automatique lors des push/pull

Méthode 1 — Cloner un repo existant (git clone)

Si le repo distant existe déjà, clonez-le sur votre machine :

# Cloner via SSH (recommandé)
git clone git@gitlab.com:username/mon-projet.git

# Cloner via HTTPS
git clone https://gitlab.com/username/mon-projet.git

# Le projet est téléchargé dans un dossier "mon-projet/"
cd mon-projet

Remote Repository (GitLab/GitHub)
          │
          │ git clone
          ▼
Local Repository (votre machine)
    → Copie complète de tout l'historique

Premiers pas après le clone

cd mon-projet

# Vérifier l'état du repo
git status

# Voir l'historique des commits
git log --oneline

# Voir les remotes configurés
git remote -v

Méthode 2 — Initialiser un repo local (git init)

Si vous avez un projet existant localement et voulez le versionner :

# 1. Dans le dossier du projet
cd mon-projet

# 2. Initialiser Git
git init
# → Crée un dossier caché .git/ qui contient tout l'historique

# 3. Premier commit
git add .
git commit -m "initial commit"

# 4. Connecter au remote (créé au préalable sur GitLab/GitHub)
git remote add origin git@gitlab.com:username/mon-projet.git

# 5. Pousser vers le remote
git push -u origin main

Projet local existant
├── app.js
├── package.json
└── README.md
    │ git init + git add + git commit
    ▼
Local Git Repository
    │ git push
    ▼
Remote Repository (GitLab/GitHub)

Comparaison des deux méthodes

À retenir

• GitHub / GitLab = plateformes qui hébergent le remote repository
• Privé vs Public = accès restreint ou ouvert à tous
• git config --global = configurer votre nom et email (obligatoire avant tout commit)
• Clé SSH = méthode d'authentification recommandée pour push/pull sans mot de passe
• git clone <url> = télécharger un repo distant sur votre machine
• git init = initialiser Git sur un projet local existant
• git remote add origin <url> = connecter le repo local au remote
• git push -u origin main = premier push, avec tracking de la branche