Créer et gérer un dépôt

Les deux façons de créer un dépôt Git

Il existe deux méthodes principales pour obtenir un dépôt Git :

1. Initialiser un nouveau dépôt : Démarrer un projet Git à partir de zéro sur votre machine
2. Cloner un dépôt existant : Récupérer une copie d'un projet Git depuis GitHub

Quand utiliser quoi ?

• Init : Vous démarrez un nouveau projet de zéro
• Clone : Vous rejoignez un projet existant ou récupérez un de vos projets depuis GitHub

Initialiser un nouveau dépôt

Étape 1 : Créer le dossier du projet

mkdir mon-projet
cd mon-projet

Étape 2 : Initialiser Git

git init

Résultat :

Initialized empty Git repository in /Users/alice/mon-projet/.git/

Cette commande crée un dossier caché .git/ qui contient toute la configuration et l'historique de votre projet.

Le dossier .git/ est sacré ! Ne le modifiez jamais manuellement. ::

Étape 3 : Vérifier le statut

git status

Vous êtes maintenant sur la branche main avec un dépôt Git vide.

Le workflow Git

Avant de faire votre premier commit, il est important de comprendre le cycle de travail Git. Vous allez répéter ce workflow en permanence, quel que soit le projet.

┌─────────────────────────────────────────┐
│  1. Modifier des fichiers               │
│     (éditeur de code)                  │
└────────────────┬────────────────────────┘
                 ↓
┌─────────────────────────────────────────┐
│  2. Vérifier l'état                     │
│     git status                          │
│     git diff                            │
└────────────────┬────────────────────────┘
                 ↓
┌─────────────────────────────────────────┐
│  3. Ajouter à la staging area           │
│     git add <fichier>                  │
└────────────────┬────────────────────────┘
                 ↓
┌─────────────────────────────────────────┐
│  4. Créer un commit                     │
│     git commit -m "message"             │
└────────────────┬────────────────────────┘
                 ↓
┌─────────────────────────────────────────┐
│  5. Envoyer vers GitHub                 │
│     git push                            │
└─────────────────────────────────────────┘

👉 Idée clé : Git ne sauvegarde jamais automatiquement vos fichiers. Tant que vous n'avez pas fait de git commit, rien n'est enregistré dans l'historique. ::

Premier commit

Nous allons maintenant appliquer ce workflow étape par étape.

1. Créer un fichier

echo "# Mon Projet" > README.md

2. Vérifier l'état du dépôt

git status

Le fichier README.md est untracked : Git le voit, mais ne le versionne pas encore.

3. Ajouter à la staging area

git add README.md

La staging area est une zone intermédiaire : vous choisissez précisément ce qui fera partie du prochain commit.

Vérifiez :

git status

4. Créer le commit

git commit -m "chore: initial commit"

Félicitations ! Vous venez de créer votre premier commit. ::

5. Voir l'historique

git log

Cloner un dépôt existant

Si un projet Git existe déjà sur GitHub, vous pouvez le cloner pour en obtenir une copie locale complète.

git clone https://github.com/username/projet.git
cd projet

Le dépôt cloné contient :

• Tous les fichiers
• Tout l'historique des commits
• Toutes les branches
• Le remote origin configuré automatiquement

Lier votre dépôt à GitHub

1. Créer un dépôt sur GitHub

Créez un dépôt vide sur GitHub (sans README).

2. Ajouter le remote

git remote add origin https://github.com/votre-username/mon-projet.git
git remote -v

3. Pousser sur GitHub

git push -u origin main

Grâce au flag -u, vous pourrez ensuite simplement faire git push.

.gitignore

Certains fichiers ne doivent jamais être versionnés.

Créer le fichier

cat > .gitignore << EOF
node_modules/
dist/
.env
.DS_Store
.vscode/
EOF

Commiter le .gitignore

git add .gitignore
git commit -m "chore: add gitignore"

Le .gitignore doit toujours être commité. ::

Commandes essentielles récapitulatives

Vous maîtrisez maintenant le workflow Git de base. ::