Au chapitre précédent, le projet existait déjà sur le serveur. Ici, on part d’un dossier vide : on initialise Git, puis on envoie le projet sur GitHub.

1. Initialiser Git : git init

Crée un dossier avec un premier fichier, puis initialise Git dedans :

mkdir git-demo
cd git-demo
echo "test" > test.txt
git init
# Initialized empty Git repository in …/git-demo/.git/

Git crée un dossier caché .git. C’est là qu’il stocke tout l’historique et la configuration du projet. Ne le supprime pas : sans lui, le dossier n’est plus un dépôt Git.

2. Créer le dépôt sur GitHub

Sur GitHub, clique sur New repository :

  • Nom : git-demo ;
  • Visibilité : public ou privé ;
  • README, .gitignore, licence : laisse vide, puisque ton projet existe déjà en local.

C’est quoi le .gitignore ?

Certains fichiers ne doivent jamais partir sur GitHub : fichiers de configuration locale, mots de passe, dépendances téléchargées… Il suffit de les lister dans un fichier .gitignore à la racine du projet, et Git les ignorera :

.env.local
/vendor/
/node_modules/

Tu peux modifier ces fichiers librement sur ta machine : ils ne seront jamais envoyés.

3. Relier le projet à GitHub : git remote

Une fois le dépôt créé, GitHub affiche les commandes à lancer. On ajoute le remote, c’est-à-dire l’adresse du dépôt distant :

git remote add origin https://github.com/<utilisateur>/git-demo.git

Vérifie :

git remote -v
# origin  https://github.com/<utilisateur>/git-demo.git (fetch)
# origin  https://github.com/<utilisateur>/git-demo.git (push)
  • fetch : l’adresse utilisée pour récupérer les données ;
  • push : l’adresse utilisée pour les envoyer.

4. Premier commit

Avec les commandes du chapitre précédent :

git status
git add .
git commit -m "Premier commit"

5. La branche par défaut

Après git init, Git crée une branche par défaut, master ici. Pour travailler sur une autre branche, tu sais déjà faire : git checkout -b <nom>. Dans cet exemple, on pousse directement sur master.

GitHub utilise main comme nom par défaut. Pour que tes nouveaux projets démarrent sur main : git config --global init.defaultBranch main.

6. Premier push

git push
# fatal: The current branch master has no upstream branch.

Normal : sur GitHub, on n’a créé que le dépôt, sans aucune branche. Git t’indique la commande exacte :

git push --set-upstream origin master

Rafraîchis la page GitHub : ton fichier est là, sur la branche master. Prends l’habitude de lire les messages de Git : très souvent, ils te disent exactement quoi faire.

Récap

CommandeRôle
git initTransformer un dossier en dépôt Git
.gitignoreLister les fichiers que Git doit ignorer
git remote add origin <url>Relier le projet à un dépôt distant
git remote -vVoir les dépôts distants
git push --set-upstream origin <branche>Premier push d’une branche

Exercice · Ignore les bons fichiers

Ton projet contient un dossier node_modules/, un fichier .env avec des mots de passe et des fichiers *.log. Écris le .gitignore.

Voir la solution
node_modules/
.env
*.log

Un nom qui finit par / désigne un dossier, et * remplace n’importe quelle suite de caractères. Vérifie ensuite avec git status : ces fichiers ne doivent plus apparaître.

La suite

Au prochain chapitre, on découvre une commande qui sauve la vie quand on doit changer de tâche en urgence : git stash.


Ceci est le chapitre 4 du cours Git en pratique. Suis la série pour apprendre à utiliser Git au quotidien et en équipe.