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-Hostde 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 statusetgit diffavant 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 -ppermet de se relire et de séparer deux changements dans un même fichier.git commit --amendcorrige 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.