Place à la pratique ! On récupère un projet existant, on crée une branche, on fait des modifications, puis on les envoie sur le serveur.
1. Cloner le projet
Sur la page du dépôt (GitHub, Bitbucket…), copie l’URL du projet, puis :
git clone https://github.com/<utilisateur>/<projet>.git
cd <projet>
Le projet est maintenant sur ta machine. Ouvre-le dans ton éditeur.
2. Créer une branche
Vérifie d’abord sur quelle branche tu es :
git branch
# * master
On ne travaille pas directement sur master. On crée une branche pour nos modifications :
git checkout -b develop
# Switched to a new branch 'develop'
-b crée la branche et bascule dessus. Avec les versions récentes de Git, git switch -c develop fait la même chose.
3. Faire des modifications
Pour l’exemple, on fait trois types de changements :
- on modifie un fichier (on supprime une ligne) ;
- on supprime un fichier ;
- on ajoute un nouveau fichier,
label.txt.
4. Voir ce qui a changé : git status
git status
Git liste les fichiers :
- modified : modifiés ;
- deleted : supprimés ;
- untracked files : nouveaux fichiers, pas encore suivis par Git.
5. Préparer les fichiers : git add
On choisit ce qui fera partie du prochain commit. Soit fichier par fichier :
git add label.txt
Soit tout d’un coup :
git add .
Relance git status : les fichiers ajoutés passent en vert, les autres restent en rouge.
6. Enregistrer : git commit
git commit -m "Test des modifications"
# 3 files changed, 2 insertions(+), 1 deletion(-)
Le message doit décrire ce que tu as fait dans ce commit. Git résume ensuite les changements : fichiers touchés, lignes ajoutées et supprimées.
7. Envoyer sur le serveur : git push
git push
# fatal: The current branch develop has no upstream branch.
La branche develop n’existe que sur ta machine : le serveur ne la connaît pas encore. Git te donne la commande à lancer :
git push --set-upstream origin develop
--set-upstream (ou -u) relie ta branche locale à la branche du serveur. Les fois suivantes, un simple git push suffira.
git add la prépare, git commit l’enregistre dans ton dépôt local, git push l’envoie sur le serveur. git pull fait le chemin inverse.Vérifier sur la plateforme
Rafraîchis la page du dépôt : la branche develop apparaît à côté de master. Tu y vois ton commit, avec son message, et en cliquant dessus, le détail de chaque modification : la ligne supprimée, le fichier ajouté, le fichier supprimé.
Récap
| Commande | Rôle |
|---|---|
git clone <url> | Récupérer un projet |
git branch | Voir les branches et la branche courante |
git checkout -b <nom> | Créer une branche et basculer dessus |
git status | Voir les fichiers modifiés |
git add <fichier> / git add . | Préparer les fichiers pour le commit |
git commit -m "message" | Enregistrer les modifications |
git push -u origin <branche> | Envoyer une nouvelle branche sur le serveur |
Exercice · Un cycle complet
Sur ton projet, crée une branche docs/readme, ajoute une ligne au fichier README.md, puis committe et pousse cette branche sur le serveur.
Voir la solution
git checkout -b docs/readme # ou : git switch -c docs/readme
# … modifie README.md …
git status
git add README.md
git commit -m "Complète le README"
git push --set-upstream origin docs/readme
--set-upstream (ou -u) n’est nécessaire qu’au premier push de la branche. Ensuite, un simple git push suffit.
La suite
Ici, le projet existait déjà sur le serveur. Au prochain chapitre, on part de zéro : git init, puis on pousse le projet sur GitHub.
Ceci est le chapitre 3 du cours Git en pratique. Suis la série pour apprendre à utiliser Git au quotidien et en équipe.