1.2 : Git ≠ GitHub ≠ Forgejo : lever le malentendu tout de suite

Sommaire

« Je ne vais pas mettre les scripts de la boîte sur Internet »

C’est probablement la phrase qui a fait perdre le plus de temps aux administrateurs système ces quinze dernières années. Elle est prononcée en réunion, elle clôt le débat, et elle repose sur une confusion complète entre trois choses qui n’ont rien à voir.

Cette confusion a une cause simple : pour l’immense majorité des gens, la découverte de Git s’est faite par GitHub. On leur a dit « crée un compte GitHub », ils ont tapé des commandes git sans savoir ce qu’elles faisaient, et les deux mots se sont soudés dans leur tête. Le fait que « Git » soit littéralement contenu dans « GitHub » a achevé le travail.

Alors mettons les choses au clair, parce que tant que ce n’est pas fait, rien de ce qui suit dans cette formation ne peut fonctionner.

Trois couches, trois rôles

Il y a en réalité trois niveaux distincts, et il est parfaitement possible de n’en utiliser qu’un seul.

┌───────────────────────────────────────────────────────────────┐
│  NIVEAU 3 — LA FORGE                                          │
│  Forgejo, GitLab, GitHub, Gitea…                              │
│  Interface web, comptes, droits, revue de code, CI/CD,        │
│  registre d'images, wiki, tickets, webhooks, API              │
├───────────────────────────────────────────────────────────────┤
│  NIVEAU 2 — LE DÉPÔT DISTANT                                  │
│  Une simple copie du dépôt, accessible par le réseau          │
│  Un serveur SSH, un partage, un autre poste… ou une forge     │
├───────────────────────────────────────────────────────────────┤
│  NIVEAU 1 — GIT                                               │
│  Un logiciel installé sur VOTRE poste                         │
│  Historique, commits, branches, comparaisons — en local       │
└───────────────────────────────────────────────────────────────┘

Niveau 1 — Git est un logiciel local

Git est un programme que vous installez sur votre machine, exactement comme vous installeriez curl, 7zip ou rsync. Il est libre, gratuit, et il fonctionne intégralement hors ligne.

Un peu de contexte, parce qu’il explique beaucoup de choses : Git a été créé en 2005 par Linus Torvalds pour gérer le développement du noyau Linux. Les contraintes du projet étaient très particulières : des milliers de contributeurs répartis dans le monde entier, aucun serveur central de confiance, et l’obligation absolue de pouvoir vérifier qu’un historique n’avait pas été altéré. C’est de là que viennent les deux caractéristiques que vous avez vues en leçon 1.1 : le fonctionnement distribué et l’historique vérifiable par empreinte.

Retenez surtout ceci : Git a été conçu pour fonctionner sans serveur central. L’idée qu’un service en ligne soit nécessaire est une addition ultérieure, pas une caractéristique de l’outil.

Concrètement, tout ce que vous ferez dans les sections 1, 3 et 4 de cette formation — enregistrer des versions, consulter l’historique, comparer, revenir en arrière, créer des branches — se passe exclusivement sur votre disque dur. Aucun paquet ne sort de votre poste.

Niveau 2 — Le dépôt distant n’est qu’une copie

Quand vous voulez travailler à plusieurs, ou simplement disposer de votre historique ailleurs que sur votre poste, vous ajoutez un dépôt distant : une copie du dépôt, quelque part sur le réseau, avec laquelle vous synchronisez la vôtre.

Ce que la plupart des gens ignorent, c’est à quel point ce « quelque part » peut être rudimentaire. Un dépôt distant Git peut être :

  • un dossier sur un autre serveur, accessible en SSH ;
  • un dossier sur un partage réseau monté localement ;
  • un autre dossier sur votre propre machine ;
  • une clé USB ;
  • et, accessoirement, une forge.

Ce n’est pas une provocation théorique : git clone /mnt/nas/scripts.git fonctionne. Vous pouvez faire travailler une équipe entière avec un serveur SSH et rien d’autre. Des projets sérieux ont fonctionné ainsi pendant des années.

Git n’exige donc aucun service en ligne, et pas même une forge.

Niveau 3 — La forge est tout ce qu’il y a autour

Alors pourquoi installer une forge, si un dossier partagé suffit ?

Parce qu’un dépôt distant brut ne fournit que le stockage et la synchronisation. Il ne sait rien faire d’autre. Pas d’interface pour lire un historique confortablement, pas de gestion des droits par équipe, pas de revue avant fusion, pas d’exécution automatique, pas de registre d’images.

Une forge, c’est le dépôt distant plus tout l’écosystème :

Fonction Fournie par
Enregistrer une version (commit) Git
Consulter l’historique, comparer deux états Git
Créer et fusionner une branche Git
Revenir à un état antérieur Git
Synchroniser avec une copie distante Git
Interface web pour naviguer dans le code La forge
Comptes, équipes, permissions par dépôt La forge
Pull requests et revue avant fusion La forge
Protection de branches, obligation de relecture La forge
Tickets, wiki, documentation La forge
Exécution automatique (CI/CD) La forge
Registre d’images de conteneurs La forge
Webhooks et API La forge

Cette répartition est fondamentale, et elle a une conséquence que nous exploiterons plus loin : tout ce qui est à gauche vous appartient et vous suit partout ; tout ce qui est à droite dépend du produit que vous avez choisi. On y revient à la fin de cette leçon.

L’analogie de l’atelier

Reprenons l’image de la leçon précédente, qui va nous accompagner toute la formation.

Git, ce sont vos outils personnels. Le marteau, l’enclume, le poinçon, le registre que vous tenez à la main. Avec ça, seul dans votre garage, vous pouvez déjà travailler proprement, dater et signer chaque pièce que vous produisez, et retrouver ce que vous avez fait il y a six mois. Vous n’avez besoin de personne.

La forge, c’est le bâtiment. L’atelier partagé où plusieurs compagnons travaillent, avec un registre commun consultable par tous, un contremaître qui décide qui a le droit de toucher à quoi, un contrôle qualité avant que la pièce ne sorte, un magasin où sont rangées les pièces finies, un guichet où les clients viennent retirer leur commande, et un marteau-pilon qui se met en marche tout seul dès qu’on lui apporte de la matière.

Vous pouvez forger sans atelier. Vous ne pouvez pas avoir d’atelier sans savoir forger.

Si vous préférez une comparaison plus proche de votre quotidien : Git est au dépôt distant ce qu’un client de messagerie est à un serveur de messagerie. Indispensable, mais ce n’est ni la même machine, ni le même métier, ni le même fournisseur — et changer de serveur ne vous oblige pas à changer de client.

Les forges existantes, en une minute

Nous consacrerons la leçon 1.5 au choix. Ici, il s’agit seulement de savoir de quoi on parle quand ces noms apparaissent.

GitHub — la plus connue, propriété de Microsoft depuis 2018. Service en ligne uniquement (l’offre auto-hébergée, GitHub Enterprise Server, est réservée aux grands comptes). C’est la forge de référence du logiciel libre mondial.

GitLab — existe en version en ligne et en version installable sur vos serveurs. Deux éditions : Community Edition, libre et gratuite, et Enterprise Edition, payante. Très complète, mais gourmande en ressources.

Gitea — une forge légère écrite en Go, conçue dès l’origine pour l’auto-hébergement. Démarre en quelques secondes, tient sur une petite VM.

Forgejo — un fork de Gitea créé en 2022, à gouvernance communautaire, sous licence libre. Techniquement très proche de Gitea, avec le même format de conteneur. C’est la forge que nous utiliserons dans cette formation.

Codeberg — une instance Forgejo publique et gratuite, opérée par une association allemande à but non lucratif. Utile à connaître : c’est la démonstration qu’on peut avoir une forge publique sans dépendre d’un géant américain.

Bitbucket, Azure DevOps — les offres respectives d’Atlassian et de Microsoft, que vous croiserez surtout en entreprise.

Toutes utilisent le même Git. Les commandes que vous apprendrez dans cette formation fonctionnent à l’identique sur les sept.

Ce que ça change pour vous, concrètement

Voilà les quatre conséquences qui comptent vraiment pour un administrateur système.

1. Vous pouvez apprendre et utiliser Git sans aucun compte en ligne

Vous n’avez pas besoin de créer de compte GitHub pour suivre cette formation. Vous n’aurez pas besoin d’Internet non plus pour la majorité des manipulations. La forge que vous monterez en section 2 tournera sur votre propre VM, dans votre propre réseau.

2. « Mettre les scripts sur Git » ne veut pas dire « les mettre sur Internet »

C’est l’objection du début de leçon, et vous avez maintenant de quoi y répondre — que ce soit face à un responsable, à un RSSI ou à un collègue sceptique.

Un dépôt Git est un dossier. Ce dossier est hébergé là où vous décidez de l’héberger. Sur une VM interne, derrière votre pare-feu, avec votre annuaire pour l’authentification et vos sauvegardes habituelles, il est exactement aussi exposé que votre partage réseau actuel — et considérablement mieux tracé.

En pratique, une forge interne améliore votre posture de sécurité par rapport à un partage de fichiers : authentification centralisée, droits granulaires par dépôt, journal inaltérable de qui a modifié quoi, et possibilité d’exiger une relecture avant qu’une modification ne parte en production. Aucun \\srv-fichiers\IT\Scripts$ ne vous offre ça.

3. Votre historique est portable, votre forge ne l’est pas

Point important, à garder en tête pour la leçon 1.5.

Ce que Git gère — l’historique complet, les commits, les branches, les tags — est totalement portable. Un dépôt se déplace d’une forge à l’autre sans rien perdre, et chaque poste qui l’a récupéré en détient une copie intégrale. De ce côté-là, aucun enfermement possible.

En revanche, tout ce que la forge ajoute autour — les tickets, les pull requests avec leurs discussions, les définitions de pipelines, les droits d’accès, les paramètres — ne suit pas automatiquement. Chaque produit a son format.

Le risque d’enfermement ne se situe donc jamais dans Git, mais toujours dans la périphérie. C’est précisément pour cette raison que le choix d’une forge mérite quelques minutes de réflexion — et que l’écart de coût de migration entre deux produits n’est pas le même selon la manière dont vous les utilisez.

4. Rien ne vous oblige à choisir un seul endroit

Un dépôt local peut être synchronisé avec plusieurs dépôts distants simultanément. Rien n’interdit d’avoir votre forge interne comme référence quotidienne et un miroir public sur GitHub pour les projets que vous partagez avec la communauté.

C’est d’ailleurs exactement ce que font beaucoup d’administrateurs : l’interne pour ce qui concerne l’infrastructure de l’entreprise, le public pour ce qui peut servir à d’autres. Nous verrons comment mettre en place cette synchronisation automatique dans la partie finale de la formation.

Le vocabulaire, une bonne fois pour toutes

Ces mots vont revenir en permanence. Autant les fixer maintenant.

Terme Signification
Dépôt (repository, repo) Un projet suivi par Git : les fichiers plus leur historique
Dépôt local La copie sur votre poste, avec son dossier .git
Dépôt distant (remote) Une copie accessible par le réseau, avec laquelle vous synchronisez
origin Le nom donné par convention au dépôt distant principal — rien de magique, c’est juste un nom par défaut
Cloner Récupérer une copie complète d’un dépôt distant, historique inclus
Forge Une plateforme complète : dépôts distants + interface + droits + CI + registre
Instance Une installation particulière d’une forge (« notre instance Forgejo »)
Auto-hébergé (self-hosted) Installé sur vos propres serveurs, par opposition à un service en ligne

Une dernière précision de vocabulaire qui évite bien des quiproquos : on parle de pull request sur GitHub et Forgejo, de merge request sur GitLab. C’est rigoureusement la même chose — proposer une modification à la relecture avant de l’intégrer.

Ce qu’il faut retenir

  • Git est un logiciel local, libre, qui fonctionne sans réseau et sans serveur.
  • Un dépôt distant n’est qu’une copie accessible par le réseau — un simple serveur SSH suffit.
  • Une forge ajoute tout l’écosystème autour : interface, droits, revue, automatisation, registre.
  • GitHub, GitLab, Gitea et Forgejo sont des forges concurrentes, qui utilisent toutes le même Git.
  • Utiliser Git n’implique aucun service en ligne et aucune sortie de vos données.
  • Votre historique est portable ; ce qui ne l’est pas, c’est ce que la forge ajoute autour.

Si vous ne deviez retenir qu’une phrase : Git est l’outil, la forge est le lieu.

Dans la leçon suivante

Le malentendu est levé, le vocabulaire est posé. Reste la vraie question, celle que vous vous posez sans doute encore : au-delà de ranger proprement quelques scripts, qu’est-ce qu’une forge apporte réellement à un administrateur système au quotidien ?

Nous allons y répondre en repartant de ce fameux dossier Scripts, et en suivant ce qui se passe quand un fichier qu’il contient est exécuté par une stratégie de groupe sur deux cents postes — un lundi matin.