Votre Premier Dépôt Git

SlidesPDF PPTX

Niveau : Beginner

Durée : 1h15

Prérequis

Avoir installé Git (Atelier 02)
Savoir ouvrir un terminal et naviguer (cd, ls, pwd)
Avoir configuré user.name et user.email

Objectifs d'apprentissage

Créer un dépôt Git avec git init et git clone
Comprendre l'anatomie du dossier .git (HEAD, config, objects, refs)
Maîtriser git status, .gitignore et les fichiers fondateurs README/LICENSE
Éviter les pièges : dépôts imbriqués, .git supprimé, init au mauvais endroit

Progression dans cet atelier0%

Pourquoi initialiser un dépôt ?

Sans git init, votre dossier n’est qu’un dossier. Avec, il devient une base de données versionnée.

Avant git init

mon-projet/
├── index.html
└── style.css

git status
# fatal: not a git repository

Après git init

mon-projet/
├── .git/          ← base de données versionnée
├── index.html
└── style.css

git status
# On branch main
# No commits yet

Créer un dépôt : `git init` vs `git clone`

Option A — Partir de zéro (`git init`)

Pour un projet local qui n’existe pas encore sur GitHub :

mkdir mon-projet
cd mon-projet
git init
# ou explicite :
git init --initial-branch=main

--initial-branch=main évite l’ancienne branche master.

Option B — Récupérer l’existant (`git clone`)

Pour un projet déjà sur GitHub :

git clone https://github.com/joinhashcode/workshops.git
# ou SSH :
git clone git@github.com:joinhashcode/workshops.git
cd workshops

clone fait 4 choses : init + remote add origin + fetch + checkout.

<pre dir="ltr" class="mermaid">flowchart LR A[git init vide] -->|ajout fichiers| B[git add + commit] C[git clone distant] -->|direct| D[dépôt complet + historique]</pre>

Commandes à exécuter

bash

# Cliquez sur les commandes à gauche pour les exécuter dans le simulateur

hashcode-academy:~$_

Où lancer `git init` ?

pwd
# /workspace/mon-projet  ✅ bon
git init

cd mon-projet/sous-dossier
git init
# ⚠️ dépôt dans un dépôt ! Évitez.

Vérifiez toujours avec pwd et ls -la.

Anatomie du dossier `.git`

Ne supprimez jamais .git manuellement — c’est tout votre historique.

Structure
Explorer

.git/
├── HEAD              → ref: refs/heads/main  (branche actuelle)
├── config            → user.name, remote origin, branch.main
├── objects/          → commits, trees, blobs (compressés)
├── refs/
│   └── heads/
│       └── main      → hash du dernier commit
├── index             → Staging Area (index binaire)
└── hooks/            → scripts (pre-commit, etc.)

ls -la .git
cat .git/HEAD
cat .git/config
# [core]
#   repositoryformatversion = 0
# [user]
#   name = Aïda Diallo

ls .git/refs/heads/
# main

ls .git/objects/
# ab  cd  ef  ... (hashes)

<pre dir="ltr" class="mermaid">flowchart TD A[.git/] --> B[HEAD branche courante] A --> C[config user, remote, branch] A --> D[objects/ commits compressés] A --> E[refs/heads/main pointeur commit] A --> F[index Staging Area] E -.-> G[commit a1b2c3 parent: b0c9d8] D -.-> G</pre>

Le dossier .git est la base de données

Supprimer .git = perdre définitivement tout l’historique (commits, branches). Pour “dé-git-ifier” un projet, supprimez .git volontairement puis git init à nouveau — mais vous repartez de zéro.

Commandes à exécuter

bash

# Cliquez sur les commandes à gauche pour les exécuter dans le simulateur

hashcode-academy:~$_

Les fichiers fondateurs : `.gitignore`, `README.md`, `LICENSE`

`.gitignore` — dire à Git quoi ignorer

Sans .gitignore, vous commitez node_modules/, .env, dist/ par erreur.

# Dépendances
node_modules/
vendor/

# Secrets
.env
.env.local
*.pem

# Build
dist/
build/
.next/
coverage/

# OS / IDE
.DS_Store
Thumbs.db
.vscode/
.idea/

# Logs
*.log
npm-debug.log*

Règles :

*.log → tous les .log
!important.log → exception (ne pas ignorer)
dist/ → dossier
Utilisez les templates GitHub : https://github.com/github/gitignore

`README.md` — la porte d’entrée

# Mon Projet

Description en une phrase.

## Installation

npm install

## Usage

npm run dev

`LICENSE` — cadre légal

# GitHub → Add a license → MIT (permissif) / Apache 2.0 / GPL
gh repo create mon-projet --public --license mit

Licence	Usage
MIT	Faire ce que vous voulez, garder la licence
Apache 2.0	MIT + brevet
GPL v3	Modifications doivent rester GPL

Commandes à exécuter

bash

# Cliquez sur les commandes à gauche pour les exécuter dans le simulateur

hashcode-academy:~$_

Vérifier l’état : `git status` en détail

git status est la boussole. Apprenez à la lire :

Indicateur	Signification
`?? fichier`	Untracked — jamais ajouté
`A fichier`	Added — dans l’index, prêt à committer
`M fichier`	Modified — changé hors index
`M fichier`	Modified + staged — `git add` fait
`D fichier`	Deleted
`nothing to commit`	Propre

git status
git status --short
git status -u   # -u = untracked files mode
git status --ignored  # voir les ignorés

Autres vérifications :

pwd          # où suis-je ?
ls -la       # .git visible ?
git log --oneline  # historique (vide au début)
git remote -v      # distant configuré ?

Pièges courants