Pourquoi une carte avant de commencer
La plupart des formations Git sont des listes de commandes. On y apprend add, commit, push, branch, merge, puis on referme le navigateur en sachant faire des choses sans savoir à quoi elles servent.
Nous allons procéder autrement, parce que ce n’est pas votre problème. Votre problème n’est pas d’apprendre des commandes : c’est de savoir quoi mettre dans une forge, et ce que ça vous rapporte.
Or, si les usages possibles sont innombrables, les mécaniques, elles, se comptent sur les doigts d’une main. Il y en a quatre. Une fois que vous les avez comprises, vous n’avez plus besoin qu’on vous explique chaque cas particulier : vous reconnaissez le pattern, et vous savez quoi faire.
C’est le cœur de cette formation, et c’est ce qui vous permettra, à la fin, d’inventer des usages dont je n’ai pas parlé.
La question qui range tout
Pour identifier le pattern, une seule question suffit : dans quel sens circule l’information, et qui est aux deux bouts ?
Quatre réponses possibles, quatre patterns.
┌──────────────────────┐
│ │
① RANGER ────────▶│ │
l'humain écrit │ │
l'humain lit │ │
│ │
② POUSSER ────────▶│ LE DÉPÔT │
la machine écrit │ │
│ │
│ │◀──── ③ TIRER
│ │ la machine lit
│ │
│ │────▶ ④ DÉCLENCHER
│ │ l'écriture agit
└──────────────────────┘
Reprenons-les une par une. Pour chacune, vous verrez la mécanique, ce qu’elle remplace dans votre quotidien actuel, et où elle est traitée dans la formation.
① RANGER — le dépôt est un référentiel
L’humain écrit, l’humain lit.
C’est le pattern le plus évident, celui auquel tout le monde pense en premier, et le point de départ obligatoire de tous les autres. Vous placez dans un dépôt ce que vous produisez, et vous y revenez pour le consulter ou le modifier.
Ce que vous y rangez : vos scripts PowerShell et Bash, vos stacks Docker, vos playbooks, vos Dockerfile, vos procédures et votre documentation d’exploitation.
Ce que ça remplace : le dossier Scripts du partage réseau, les fichiers _v2_final_OK, la clé USB de dépannage, le dossier Mes documents du technicien qui a quitté l’entreprise l’an dernier.
Ce que ça vous apporte immédiatement : un endroit unique où chercher, un historique complet de chaque modification, et la possibilité de revenir en arrière sans dépendre d’une sauvegarde.
L’exemple de fil rouge que nous construirons : le référentiel de scripts de Nordika, et un référentiel de stacks Docker où chaque application dispose de son dossier, de son docker-compose.yml, de son README et de son fichier d’exemple de variables.
📍 Traité en section 5 — Le magasin d’outils
② POUSSER — le dépôt est un journal
La machine écrit.
Voilà le premier pattern contre-intuitif, celui dont personne ne parle et qui change pourtant beaucoup de choses.
Jusqu’ici, vous ranger dans le dépôt ce que vous écrivez. Mais l’essentiel de la configuration que vous administrez, vous ne l’écrivez pas dans un éditeur : elle est modifiée par des installations de paquets, par des assistants graphiques, par des consoles d’administration, par des commandes ponctuelles tapées à 23h un soir d’incident.
L’idée de ce pattern est simple : faire en sorte que la machine dépose elle-même sa configuration dans le dépôt, automatiquement et régulièrement. Le dépôt devient alors un journal de l’état réel de votre infrastructure, tenu sans effort.
Les cas que nous traiterons :
/etcsous surveillance. Avec l’outiletckeeper, chaque installation de paquet, chaque modification de configuration produit automatiquement un enregistrement. Vous obtenez, gratuitement, l’historique complet de la configuration système de vos serveurs Linux.- Les configurations Nginx centralisées. Plusieurs reverse proxies, chacun avec ses fichiers, tous consolidés dans un dépôt commun. Vous voyez d’un coup d’œil ce qui diffère entre eux, et vous savez quand une directive a été ajoutée.
- Les stratégies de groupe exportées. C’est probablement le cas le plus spectaculaire pour un administrateur Active Directory : une tâche planifiée exporte régulièrement vos GPO, et vous obtenez enfin ce qui n’existe nulle part dans la console Microsoft — un différentiel lisible entre deux états d’une GPO.
- Les exports d’appliances. Configurations de pare-feu, de switchs, d’équipements réseau : même principe, même bénéfice.
Ce que ça remplace : rien, en général. Et c’est bien le problème. Aujourd’hui, personne ne sait quand cette directive a été ajoutée au sshd_config du serveur de production, ni par qui.
📍 Traité en section 6 — Le registre de l’atelier
③ TIRER — le dépôt est une source
La machine lit.
On inverse le sens. Cette fois, le dépôt n’est plus une destination mais une source de distribution : les machines viennent y chercher ce dont elles ont besoin, au moment où elles en ont besoin.
C’est le pattern qui transforme la forge d’un outil de rangement en une pièce active de votre infrastructure.
Côté Windows, le cas emblématique : une stratégie de groupe qui n’exécute plus un script stocké dans SYSVOL, mais un lanceur de cinq lignes qui va chercher le script sur la forge et l’exécute. Les avantages sont directs — pas d’attente de réplication, une version identifiée précisément, un historique de ce qui a été distribué, et la possibilité de corriger sans toucher à la GPO elle-même.
C’est puissant, et c’est aussi le pattern qui demande le plus de précautions : nous y consacrerons une leçon entière de règles de sécurité, parce qu’un dépôt qui alimente deux cents postes en code exécuté avec des droits élevés n’est plus un simple dossier.
Côté Linux, les déclinaisons sont nombreuses :
- Un script d’amorçage récupéré en une commande pour installer et configurer un serveur entier.
- Le déploiement d’une stack Docker tirée directement du référentiel.
- Les clés SSH publiques de l’équipe, versionnées dans un dépôt et déposées sur chaque nouvelle machine à l’installation. Ajouter un collègue devient un enregistrement dans un dépôt, et non une tournée sur trente serveurs.
- La post-installation d’un poste ou d’un serveur pour ceux qui n’utilisent pas encore Ansible : un dépôt, un script, une commande.
Ce que ça remplace : SYSVOL, les scripts copiés à la main de serveur en serveur, les clés SSH ajoutées une par une, le fichier de procédure d’installation que personne ne relit.
📍 Traité en sections 7 (Windows) et 8 (Linux) — Le guichet de retrait
④ DÉCLENCHER — le dépôt est un moteur
L’écriture provoque une action.
Le dernier pattern est celui qui surprend le plus les administrateurs système, parce qu’il porte un nom qui les a longtemps tenus à distance : l’intégration continue, la fameuse « CI/CD ».
Débarrassée de son vocabulaire, c’est pourtant une idée que vous connaissez déjà parfaitement : une tâche planifiée, sauf qu’au lieu d’être déclenchée par l’heure, elle est déclenchée par une modification du dépôt.
Rien de plus. Un serveur reste à l’écoute ; dès qu’un enregistrement arrive, il exécute la liste d’actions que vous avez décrite dans un fichier.
Ce que nous en ferons :
- Vérifier vos scripts automatiquement. À chaque modification, un analyseur passe sur vos scripts PowerShell et Bash et signale les erreurs et les mauvaises pratiques. Il vérifie aussi qu’aucun mot de passe n’a été oublié dedans.
- Construire et publier vos images Docker. Vos images maison sont reconstruites automatiquement et déposées dans votre propre registre.
- Alimenter votre registre interne. Les images publiques dont dépendent vos services — bases de données, caches, serveurs web — sont recopiées régulièrement chez vous. Fini le déploiement bloqué un mardi matin parce qu’un service public a atteint sa limite de téléchargements.
- Publier votre documentation. Vos procédures et vos runbooks, écrits en texte simple à côté des scripts qu’ils décrivent, deviennent un site web interne régénéré à chaque modification. Et le même mécanisme permet de publier de petits outils internes — un inventaire des conteneurs, un tableau de bord, une page de suivi.
- Alimenter vos outils. De plus en plus d’applications d’administration vont chercher leur configuration dans un dépôt Git : Semaphore pour les playbooks Ansible, Dockerhand pour les stacks Docker, et bien d’autres. Le dépôt devient alors la source de vérité de votre infrastructure, et un enregistrement devient un déploiement.
Ce que ça remplace : les vérifications manuelles qu’on ne fait jamais, la dépendance aux registres publics, la documentation périmée, et les déploiements à la main.
📍 Traité en sections 9 à 12 — Le marteau-pilon, le magasin de pièces, la vitrine et la source de vérité
La carte, en un tableau
| Pattern | Le dépôt est… | Qui écrit | Qui lit | Exemples | Section | |
|---|---|---|---|---|---|---|
| ① | Ranger | un référentiel | vous | vous | scripts, stacks, doc | 5 |
| ② | Pousser | un journal | la machine | vous | /etc, Nginx, GPO exportées |
6 |
| ③ | Tirer | une source | vous | la machine | GPO, amorçage, clés SSH | 7-8 |
| ④ | Déclencher | un moteur | vous | un automate | CI, images, doc, GitOps | 9-12 |
Comment ils s’enchaînent
Ces quatre mécaniques ne sont pas des chapitres indépendants : elles se combinent, et c’est là que la forge prend toute sa valeur.
Prenons un exemple complet, celui que nous aurons construit à la fin de la formation. Vous devez modifier le script de connexion de Nordika.
- Vous ouvrez le dépôt de scripts et vous corrigez le fichier. (① ranger)
- Vous proposez la modification, un collègue la relit, elle est intégrée.
- Au moment de l’intégration, une vérification automatique se lance : analyse du script, recherche de secrets oubliés. (④ déclencher)
- Vous marquez cette version comme bonne pour la production.
- Au prochain démarrage de session, les deux cents postes vont chercher cette version précise sur la forge et l’exécutent. (③ tirer)
- Sur les serveurs,
etckeepercontinue en parallèle de consigner chaque changement de configuration. (② pousser) - La documentation d’exploitation, modifiée en même temps que le script, est republiée automatiquement. (④ déclencher)
Sept étapes, quatre patterns, et à aucun moment un fichier n’a été copié à la main sur un partage réseau.
Ce que vous aurez à la fin de cette formation
Pour être très concret, voici les livrables. À la fin des quatorze sections, vous disposerez :
- d’une forge Forgejo opérationnelle, en conteneurs, publiée en HTTPS et raccordée à votre annuaire ;
- d’un référentiel de scripts structuré, migré depuis votre partage réseau, avec son historique ;
- d’un référentiel de stacks Docker documenté ;
- de la configuration système de vos serveurs Linux versionnée automatiquement ;
- de vos stratégies de groupe exportées et comparables dans le temps ;
- d’une GPO qui exécute un script hébergé sur la forge, épinglé sur une version précise ;
- d’un script d’amorçage capable d’installer un serveur Linux complet en une commande ;
- d’un registre d’images de conteneurs interne, alimenté automatiquement ;
- de vérifications automatiques sur chaque modification de script ;
- d’une documentation d’exploitation publiée en interne, à jour par construction ;
- de règles de travail en équipe explicites, et d’une procédure de sauvegarde et de restauration de la forge testée.
« Je veux faire X, par où je commence ? »
Si vous êtes venu pour un besoin précis, cette table vous indique le chemin le plus court. Les sections 1 à 4 restent le passage obligé — elles posent les bases sans lesquelles rien du reste ne fonctionne.
| Votre besoin | Après les bases, allez en… |
|---|---|
Ranger mes scripts et arrêter les _v2_final |
Section 5 |
Savoir qui a modifié /etc et quand |
Section 6 |
| Suivre l’évolution de mes GPO dans le temps | Section 6 |
| Centraliser mes configurations Nginx | Section 6 |
| Distribuer un script par GPO sans réplication SYSVOL | Section 7 |
| Installer un serveur Linux en une commande | Section 8 |
| Distribuer les clés SSH de l’équipe | Section 8 |
| Vérifier automatiquement la qualité de mes scripts | Section 9 |
| Ne plus dépendre d’un registre d’images public | Section 10 |
| Publier une documentation technique à jour | Section 11 |
| Brancher Semaphore ou un outil de déploiement sur Git | Section 12 |
| Organiser le travail de mon équipe | Section 13 |
Une remarque sur l’ordre
Un point qui a son importance : les patterns ② ③ et ④ reposent tous sur le ①.
Il n’est pas possible de distribuer proprement un script par GPO si le dépôt qui le contient est mal structuré. Une chaîne d’automatisation branchée sur un dépôt désordonné produit des résultats désordonnés. Et un journal automatique de configuration ne sert à rien si personne ne sait où le chercher.
L’ordre des sections n’est donc pas arbitraire, et je vous déconseille de sauter la section 5 même si elle vous paraît la moins spectaculaire. C’est le socle.
Ce qu’il faut retenir
- Les usages d’une forge sont innombrables ; les mécaniques sont quatre.
- Ranger : vous écrivez, vous lisez. Le référentiel.
- Pousser : la machine écrit. Le journal de configuration.
- Tirer : la machine lit. Le canal de distribution.
- Déclencher : l’écriture provoque une action. L’automatisation.
- Pour identifier un pattern, posez-vous une seule question : qui écrit, qui lit ?
- Les trois derniers patterns s’appuient sur le premier : commencez toujours par bien ranger.
Gardez cette carte sous la main. Vous la retrouverez à l’ouverture de chaque partie de la formation, et une dernière fois en conclusion — pour construire vos propres usages.
Dans la leçon suivante
Vous savez ce que vous allez construire. Reste à choisir l’outil dans lequel le construire.
La leçon suivante compare Forgejo, GitLab, Gitea et GitHub du point de vue d’un administrateur système : ressources nécessaires, facilité d’exploitation, fonctionnalités réellement utiles pour nos quatre patterns, et coût de sortie le jour où l’on change d’avis.
Vous verrez que le critère décisif n’est pas celui qu’on met en avant dans les comparatifs habituels.