3.3 : Le cycle quotidien : modifier, add, commit, push

Le geste que vous répéterez des milliers de fois

Vous connaissez déjà trois zones depuis la leçon 1.1. Il en existe une quatrième depuis que votre dépôt vit sur la forge.

  ┌───────────┐   git add   ┌───────────┐  git commit  ┌───────────┐  git push  ┌──────────┐
  │ L'ÉTABLI  │ ──────────▶ │ LE PLATEAU│ ───────────▶ │ LE REGISTRE│ ─────────▶│ LA FORGE │
  │           │             │           │              │   LOCAL    │           │          │
  │ vos       │             │ ce qui    │              │ votre      │           │ visible  │
  │ fichiers  │             │ partira   │              │ historique │           │ de tous  │
  └───────────┘             └───────────┘              └───────────┘           └──────────┘
       ▲                                                                              │
       └──────────────────────────  git pull  ───────────────────────────────────────┘

Quatre commandes, deux directions. C’est tout ce que fait un administrateur système avec Git, 95 % du temps.


Le cycle, en pratique

Prenons une situation réelle : le service comptabilité déménage, il faut adapter le script de connexion.

1. Récupérer avant de commencer

git pull

Prenez cette habitude avant chaque session de travail. Un collègue a peut-être modifié le même fichier depuis hier. Récupérer d’abord évite de découvrir le problème au moment de publier, quand vous avez déjà tout écrit.

Nous détaillerons ce que fait réellement pull en 3.4. Pour l’instant, retenez le réflexe : on commence par tirer.

2. Travailler

Ouvrez le script, modifiez-le. Git ne vous surveille pas, ne verrouille rien, ne demande rien. Vous êtes sur l’établi.

3. Regarder ce que vous avez fait

git status
git diff

Ces deux commandes avant chaque enregistrement, systématiquement. status dit quels fichiers ont changé, diff montre ce qui a changé dedans.

Ce n’est pas de la paranoïa : c’est ainsi que vous repérerez le fichier de test que vous aviez oublié, ou la ligne de débogage restée en place.

4. Poser sur le plateau

git add Logon.ps1

Un fichier, ou plusieurs. Le principe reste celui de la leçon 1.7 : ne posez que ce qui appartient au même sujet.

5. Enregistrer

git commit -m "Ajout du lecteur P: pour le service Comptabilité suite au déménagement"

Votre travail est gravé dans votre registre local. Il est protégé, daté, expliqué — mais encore invisible pour vos collègues.

6. Publier

git push
Enumerating objects: 5, done.
To https://forge.nordika.local/infrastructure/scripts-powershell.git
   a3f9c21..7d2e881  main -> main

Maintenant, c’est visible sur la forge. Vos collègues peuvent le récupérer, l’interface affiche l’enregistrement, et — à partir de la section 12 — vos outils peuvent réagir.


Les raccourcis que vous utiliserez vraiment

Tout poser d’un coup

git add .        # tout le dossier courant et ses sous-dossiers
git add -A       # tout le dépôt, y compris les suppressions

Pratique, et à manier avec attention : c’est ainsi qu’on ajoute par inadvertance un fichier de mots de passe ou une archive de 300 Mo. Le .gitignore de la leçon suivante est fait exactement pour ça.

Le réflexe qui va avec : un git status juste avant, pour voir ce que vous êtes sur le point de prendre.

Enregistrer directement

git commit -a -m "Correction du seuil d'alerte"

Combine add et commit pour les fichiers déjà suivis. Les nouveaux fichiers sont ignorés — c’est le piège du raccourci : vous croyez avoir tout enregistré, et votre nouveau module n’y est pas.

Enregistrer par morceaux

git add -p

Celui-ci mérite votre attention. Git vous présente vos modifications bloc par bloc et vous demande, pour chacun, si vous voulez le poser sur le plateau.

Deux usages, l’un et l’autre précieux :

  • Séparer proprement deux changements sans rapport faits dans le même fichier — la mission 4 du TP 1, mais à l’intérieur d’un seul fichier.
  • Vous relire. Passer en revue vos propres modifications avant de les enregistrer fait remonter les oublis : le Write-Host de débogage, le chemin de test, le commentaire douteux.

Les réponses les plus utiles : y pour prendre, n pour laisser, s pour découper le bloc en plus petits, q pour arrêter.

Corriger le dernier enregistrement

git commit --amend -m "Le message corrigé"

Faute de frappe dans le message, fichier oublié : cette commande remplace le dernier enregistrement au lieu d’en créer un nouveau.

⚠️ Uniquement avant d’avoir publié. --amend ne modifie pas l’enregistrement : il en crée un nouveau qui remplace le précédent, avec une empreinte différente. Si l’ancien est déjà sur la forge, vos historiques divergent, et vous vous retrouvez dans une situation désagréable que nous traiterons dans l’annexe des catastrophes.

La règle : --amend tant que ce n’est pas poussé, jamais après.


À quel rythme publier ?

C’est la vraie question de cette leçon, et personne n’y répond jamais clairement.

Enregistrez souvent

Un enregistrement ne coûte rien. Il ne consomme quasiment pas d’espace, il ne dérange personne, et il est local.

Le bon critère : dès qu’un changement forme un tout cohérent. Pas « quand c’est fini », pas « à la fin de la journée ». Vous avez corrigé le seuil ? Enregistrez. Vous ajoutez maintenant un serveur ? C’est un autre enregistrement.

Un historique fait de petits enregistrements se lit et se corrige. Un historique fait de gros blocs hétéroclites ne sert à rien : impossible de savoir ce qui a cassé quoi, impossible d’annuler une partie.

Publiez régulièrement

Publier, c’est autre chose : c’est rendre visible.

Trois raisons de le faire au moins une fois par jour :

Votre disque peut mourir. Tant que ce n’est pas poussé, votre travail n’existe qu’à un seul endroit. Un enregistrement local n’est pas une sauvegarde.

Vos collègues travaillent avec des informations périmées. Plus vous gardez vos modifications, plus l’écart grandit, et plus la réunification sera pénible.

Vous oublierez. Le vendredi soir, vous partez en congé avec trois enregistrements non publiés sur votre portable. Personne ne peut reprendre.

Le rythme recommandé

Moment Action
Début de session git pull
Chaque changement cohérent git commit
Avant de partir déjeuner, avant de quitter le bureau git push
Avant toute manipulation risquée git commit — votre filet

Une nuance qui deviendra importante

Aujourd’hui, publier ne fait que rendre visible. À partir de la section 9, un envoi déclenchera des vérifications automatiques. À partir de la section 12, un envoi pourra déclencher un déploiement.

Le geste est le même ; ses conséquences changent d’échelle.

C’est précisément pour cela que la section 4 introduit les branches : elles permettent de continuer à enregistrer et à publier librement, sans que cela touche à ce qui part en production. Gardez cette idée en tête ; elle donnera tout son sens au chapitre suivant.


Vérifier où vous en êtes

git status

Trois messages à savoir lire :

Your branch is up to date with 'origin/main' — tout est synchronisé.

Your branch is ahead of 'origin/main' by 2 commits — vous avez deux enregistrements locaux non publiés. Un git push s’impose.

Your branch is behind 'origin/main' by 3 commits — le serveur a avancé sans vous. Un git pull s’impose.

Attention : ces informations reposent sur origin/main, c’est-à-dire votre dernière connaissance du serveur, comme vu en 3.2. Si vous n’avez pas communiqué avec la forge depuis ce matin, elles peuvent être périmées. La commande qui rafraîchit cette connaissance sans rien modifier chez vous, c’est git fetch — objet de la leçon suivante.


Les erreurs classiques

Symptôme Cause
nothing to commit alors que vous avez modifié Vous n’avez pas fait git add
Un nouveau fichier manque à l’appel git commit -a ignore les fichiers non suivis
Updates were rejected au push Le serveur a avancé : il faut pull d’abord (leçon 3.4)
403 au push Droits insuffisants sur le dépôt
Un fichier indésirable est parti .gitignore manquant (leçon 3.5)
Vous êtes coincé dans un éditeur -m oublié — :q! pour sortir de Vim

Ce qu’il faut retenir

  • Le cycle tient en quatre gestes : pull, modifier, add + commit, push.
  • Commencez toujours par tirer.
  • git status et git diff avant chaque enregistrement : c’est ainsi qu’on repère les oublis.
  • Enregistrez souvent — dès qu’un changement forme un tout cohérent.
  • Publiez au moins une fois par jour : un enregistrement local n’est pas une sauvegarde.
  • git add -p permet de se relire et de séparer deux changements dans un même fichier.
  • git commit --amend corrige le dernier enregistrement — jamais après publication.
  • À partir de la section 12, publier pourra signifier déployer. Les branches y répondront.

Dans la leçon suivante

Nous avons expédié git pull en une ligne. C’est pourtant la commande qui provoque le plus d’incompréhensions, parce qu’elle en fait deux à la fois.

La leçon 3.4 sépare fetch et merge, explique pourquoi Git refuse parfois de publier votre travail, et montre comment consulter ce qu’un collègue a fait avant de l’intégrer chez vous — un réflexe qui vous évitera bien des surprises quand vous serez plusieurs sur le référentiel.