Le piège du comparatif de fonctionnalités
Cherchez « GitLab vs Gitea » et vous tomberez sur des tableaux à quarante lignes où chaque produit coche à peu près les mêmes cases. Gestion des dépôts, oui. Interface web, oui. Revue de code, oui. Intégration continue, oui. Registre de paquets, oui. Authentification centralisée, oui.
Ces tableaux sont exacts, et parfaitement inutiles.
Parce qu’ils comparent ce qu’un produit sait faire le jour où vous l’installez, alors que le vrai sujet est ailleurs : ce qu’il va vous coûter tous les mois pendant trois ans.
Et pour un administrateur système, il y a une raison supplémentaire de raisonner ainsi. Ce que vous vous apprêtez à installer n’est pas un outil de confort posé dans un coin. À la fin de cette formation, votre forge distribuera des scripts à vos postes, alimentera vos serveurs en images de conteneurs, et servira peut-être de source de configuration à vos outils de déploiement. C’est un service de production. Le jour où elle tombe, ce n’est pas « on ne peut plus consulter le code » : ce sont vos GPO, vos déploiements et vos images qui sont impactés.
Une forge simple que vous maîtrisez vaut mieux qu’une forge riche que vous subissez.
Mon expérience : j’ai commencé par GitLab
Je peux difficilement mieux illustrer ce propos qu’en racontant ma propre erreur.
Ma première forge a été GitLab. Et je l’ai choisie exactement comme je viens de vous déconseiller de le faire : j’ai lu les comparatifs, GitLab cochait le plus de cases, donc GitLab. C’était la plus complète, c’était donc forcément la meilleure. Le raisonnement paraissait imparable.
Pendant un temps, tout allait bien. GitLab répondait à tous mes besoins — c’est une plateforme sérieuse, et ce n’est pas une critique du produit. Le problème n’était pas ce qu’elle savait faire, mais ce qu’elle me demandait en retour.
La complexité, d’abord. Chaque fois que je voulais activer une fonction — le registre d’images, les pages statiques — je me retrouvais dans une configuration nettement plus lourde que ce que le besoin justifiait. Beaucoup d’options, beaucoup de paramètres, et le sentiment permanent de n’exploiter qu’une petite partie de ce que je maintenais.
La consommation de ressources, ensuite. Une VM entière, correctement dimensionnée, pour un usage qui restait celui d’une infrastructure de taille modeste.
Les mises à jour, surtout. Un rythme soutenu, et à plusieurs reprises des changements qui ont cassé mes chaînes d’intégration continue existantes. Il fallait reprendre des définitions de pipelines qui fonctionnaient très bien la veille. À cela s’ajoutaient des correctifs de sécurité fréquents, qu’il fallait appliquer sans traîner.
Sur ce dernier point, soyons justes : la fréquence des publications de sécurité traduit aussi un processus actif et transparent, ce qui est plutôt une bonne chose. Mais du point de vue de celui qui exploite, cela se traduit par un rythme de maintenance à tenir — et quand la forge n’est qu’une de vos vingt responsabilités, ce rythme finit par peser.
Au bout d’un moment, le constat s’est imposé : je passais plus de temps à maintenir ma forge qu’à m’en servir.
Je suis passé à Forgejo. Moins d’options, c’est vrai. Mais elle répond à mes besoins, elle tourne à côté de mes autres conteneurs sans que j’aie à y penser, ses mises à jour ne me font plus peur, et ses workflows d’automatisation sont suffisamment proches de ceux de GitHub pour que je trouve des exemples partout.
Ce que j’ai surtout retrouvé, c’est le contrôle. Je comprends ce qui tourne, je sais comment le sauvegarder, je sais comment le remettre en route. Et, accessoirement, j’ai retrouvé du plaisir à l’utiliser — ce qui n’est pas un critère technique, mais qui compte plus qu’on ne le croit sur un outil qu’on ouvre tous les jours.
La leçon que j’en tire, et qui a guidé toute cette formation : la question n’est pas « laquelle en fait le plus ? », mais « laquelle vais-je réellement pouvoir exploiter dans la durée ? ».
Cela ne veut pas dire que GitLab est un mauvais choix. Beaucoup d’équipes l’exploitent très bien — souvent parce qu’elles sont plusieurs à s’en occuper, ou parce qu’elles utilisent réellement l’étendue de ses fonctions. Cela veut dire que le bon choix dépend de qui va maintenir l’outil, pas du nombre de lignes dans le tableau comparatif.
Les trois critères qui comptent vraiment
1. Le coût d’exploitation
C’est le critère décisif, et il se décompose en quatre questions très concrètes.
Combien de ressources ? Une forge légère tient sur une petite VM, à côté de vos autres conteneurs. Une forge complète demande sa propre machine, correctement dimensionnée. Ce n’est pas qu’une question de facture : une VM de plus, c’est une VM à surveiller, à sauvegarder, à patcher.
Combien de composants ? Certaines forges tiennent en un seul processus avec une base de données. D’autres sont des architectures à part entière, avec plusieurs services applicatifs, une base, un cache, un serveur web et un service dédié au stockage des dépôts. Chaque composant supplémentaire est un point de panne et une chose à comprendre le jour où ça ne démarre plus.
Comment se passent les mises à jour ? C’est le point que tout le monde sous-estime. Certaines forges se mettent à jour en changeant une étiquette d’image et en redémarrant. D’autres imposent de respecter un chemin de mise à jour précis, en passant par des versions intermédiaires obligatoires. Ce n’est pas un défaut en soi — c’est le prix de la complexité fonctionnelle — mais c’est une contrainte réelle quand vous avez pris six mois de retard.
Comment on sauvegarde, et surtout comment on restaure ? Question à se poser avant l’installation, pas après. Sauvegarder une forge légère revient à sauvegarder un dossier et une base de données. Sur une architecture plus riche, il faut cohérence entre plusieurs composants, et la procédure de restauration mérite d’être testée sérieusement. Nous y consacrerons deux leçons en section 14, mais le choix se fait maintenant.
2. Le coût de sortie
Souvenez-vous de la leçon 1.2 : votre historique Git est intégralement portable, mais tout ce que la forge ajoute autour ne l’est pas.
Cela a une conséquence directe sur votre décision. Plus vous vous appuierez sur la périphérie — pipelines, tickets, droits fins, registre — plus le choix vous engage. Si vous vous limitez au pattern « ranger », changer de forge est une formalité. Si vous construisez vingt chaînes d’automatisation, c’est un projet.
Ce n’est pas une raison pour ne pas utiliser ces fonctions : c’est tout l’intérêt d’une forge, et cette formation y consacre la moitié de son contenu. C’est simplement une raison de choisir en connaissance de cause.
3. La pérennité du projet
Vous allez confier à cet outil une partie de votre infrastructure. Trois questions valent la peine d’être posées : le projet est-il porté par une entité claire ? Quelle licence ? Que se passe-t-il si le modèle économique change ?
Ce n’est pas une question idéologique, c’est une question de gestion du risque — la même que vous vous posez pour n’importe quelle brique de votre SI.
Les candidats
GitHub
La forge la plus connue au monde, propriété de Microsoft. C’est un service en ligne : vos dépôts sont hébergés chez l’éditeur.
Pour les usages de cette formation, cela pose une difficulté de fond. Vos scripts d’administration, vos exports de GPO, vos configurations système décrivent votre infrastructure de manière très précise. Les héberger chez un tiers relève d’une décision qui vous dépasse probablement, et qui sera difficile à faire valider.
Il existe bien une version installable sur vos serveurs, GitHub Enterprise Server, mais son positionnement tarifaire la place en pratique hors de portée d’une PME.
Où GitHub reste pertinent : comme miroir public des projets que vous souhaitez partager avec la communauté. Nous verrons en fin de formation comment synchroniser automatiquement une forge interne avec un dépôt public.
GitLab Community Edition
GitLab est une plateforme extrêmement complète, disponible en version libre et gratuite (Community Edition) installable sur vos propres serveurs, et en version payante (Enterprise Edition) qui ajoute des fonctions orientées grands comptes.
Ses forces : une couverture fonctionnelle très large, un écosystème mature, une intégration continue reconnue, une documentation abondante, et une présence importante en entreprise — ce qui signifie que la compétence est valorisée sur le marché.
Son coût : GitLab est une application à plusieurs composants, et cela se traduit par des besoins matériels sensiblement plus élevés qu’une forge légère, ainsi qu’une exploitation plus exigeante. Les recommandations officielles de dimensionnement évoluent d’une version à l’autre — consultez-les avant de vous engager, et prévoyez large plutôt que juste.
Quand le choisir : si GitLab est déjà déployé dans votre organisation — auquel cas la question ne se pose pas, et les encadrés d’équivalence de cette formation vous suffiront. Si vous avez une équipe de développement qui l’utilise déjà. Ou si vous avez des exigences avancées de conformité et d’audit.
Gitea
Une forge légère écrite en Go, pensée dès l’origine pour l’auto-hébergement. Un binaire, une base de données, et c’est tout. Elle démarre en quelques secondes et se contente de très peu de ressources.
C’est un excellent produit, et tout ce que vous apprendrez dans cette formation s’y applique quasiment sans adaptation.
Forgejo
Forgejo est un fork de Gitea, créé en 2022 à la suite d’un désaccord sur la gouvernance du projet d’origine. Techniquement, les deux restent très proches. La différence porte principalement sur le mode de gouvernance — associatif et communautaire pour Forgejo — et sur la licence.
C’est la forge que nous utiliserons dans cette formation, pour des raisons que je détaille plus bas.
Codeberg
Une instance Forgejo publique et gratuite, opérée par une association allemande à but non lucratif. Ce n’est pas une forge à installer, mais un hébergeur — l’équivalent associatif et européen de GitHub. À connaître si vous cherchez où publier un projet libre sans dépendre d’un géant américain.
Bitbucket et Azure DevOps
Les offres respectives d’Atlassian et de Microsoft. Vous les croiserez en entreprise, généralement parce qu’un autre outil de la même famille est déjà en place. Si l’une des deux est imposée chez vous, les patterns de cette formation restent valables : seule l’implémentation change.
Le tableau, orienté par nos quatre patterns
Plutôt qu’une liste exhaustive, voici uniquement ce dont nous aurons besoin.
| Besoin de la formation | Forgejo | Gitea | GitLab CE | GitHub |
|---|---|---|---|---|
| Auto-hébergement | ✅ | ✅ | ✅ | ❌ (hors GHES) |
| Ressources nécessaires | Faibles | Faibles | Élevées | — |
| Nombre de composants | Peu | Peu | Nombreux | — |
| Authentification LDAP / OIDC | ✅ | ✅ | ✅ | ✅ |
| Intégration continue intégrée | ✅ | ✅ | ✅ | ✅ |
| Registre de conteneurs intégré | ✅ | ✅ | ✅ | ✅ |
| Hébergement de pages statiques | ⚠️ non natif | ⚠️ non natif | ✅ natif | ✅ natif |
| Miroir vers un dépôt externe | ✅ | ✅ | ✅ | — |
| Licence libre sans version bridée | ✅ | ✅ | ⚠️ CE/EE | ❌ |
Une seule case pose réellement question : l’hébergement de pages statiques. GitLab et GitHub le proposent nativement ; Forgejo et Gitea non. C’est un vrai manque, et nous y consacrerons la section 11 pour le combler — avec une approche qui a l’avantage de réutiliser exactement ce que vous aurez appris en sections 9 et 10.
Ma recommandation, et pourquoi
Forgejo, pour cinq raisons dans cet ordre.
Elle tient sur la VM Docker que vous avez déjà. Pas de machine dédiée, pas de dimensionnement à négocier. Vous la déployez à côté de vos autres conteneurs, en section 2, en une poignée de minutes.
La mise à jour et la sauvegarde sont simples. Changer l’étiquette de l’image et redémarrer pour l’une ; sauvegarder un volume et une base pour l’autre. Sur un service de production que vous exploiterez seul entre deux autres priorités, cette simplicité vaut plus que n’importe quelle fonctionnalité avancée.
Son intégration continue utilise une syntaxe compatible avec celle de GitHub Actions. C’est un argument sous-estimé : les workflows que vous écrirez en section 9 sont largement transposables ailleurs, et la compétence acquise ne meurt pas avec l’outil. Vous trouverez également beaucoup d’exemples réutilisables en ligne.
Le registre de conteneurs est intégré, sans brique supplémentaire. C’est directement le pattern ④ de la section 10.
Aucune version bridée. Pas d’édition payante qui réserve les fonctions intéressantes, pas de comptage de licences à surveiller.
Vous aurez reconnu, dans ces cinq points, exactement l’inverse de ce qui m’avait fait quitter GitLab. Ce n’est pas une coïncidence : cette recommandation n’est pas le résultat d’un comparatif, mais celui de trois ans d’exploitation.
Ce que Forgejo n’a pas — soyons honnêtes
Pas d’hébergement de pages natif, on l’a dit.
Un écosystème d’intégrations tierces plus restreint que celui de GitLab ou GitHub : moins de connecteurs prêts à l’emploi, moins d’outils qui la reconnaissent nativement.
Des fonctions de revue de code moins riches — ce qui, pour l’usage qui nous concerne, ne vous manquera pas.
Et une documentation majoritairement en anglais, avec moins de tutoriels en français que pour GitLab. C’est d’ailleurs une des raisons d’être de cette formation.
Quand ne pas choisir Forgejo
Trois cas où le bon choix est un autre.
GitLab est déjà déployé chez vous. N’installez pas une seconde forge pour le plaisir. Les quatre patterns fonctionnent parfaitement avec GitLab, et vous trouverez les équivalences en fin de chaque section concernée.
Votre équipe de développement a des exigences précises. Si des développeurs utilisent déjà une forge avec leurs propres chaînes d’automatisation, alignez-vous plutôt que de fragmenter.
Vous avez des obligations réglementaires fortes en matière d’audit, de traçabilité certifiée ou de séparation des rôles. Regardez alors les offres qui documentent explicitement ces aspects.
« Et si je me trompe ? »
C’est une inquiétude légitime, et la réponse est rassurante — à une nuance près.
Vos dépôts sont totalement portables. Historique, commits, branches, tags : tout se déplace d’une forge à l’autre sans rien perdre, et chaque poste qui a récupéré un projet en détient déjà une copie complète. De ce côté, aucun enfermement.
Ce qui coûte, c’est la périphérie : les définitions de pipelines, les tickets et leurs discussions, les droits, les paramètres. Chaque forge a son format.
D’où un conseil pratique, si vous hésitez encore : commencez par les patterns ① ② et ③. Ranger vos scripts, versionner vos configurations, distribuer par raw — tout cela repose sur Git seul et ne vous engage quasiment pas. Vous aurez déjà l’essentiel du bénéfice. Vous investirez dans le pattern ④ une fois que vous serez à l’aise avec l’outil, en connaissance de cause.
C’est d’ailleurs exactement l’ordre de cette formation. Ce n’est pas un hasard.
Une note sur Gitea
Si vous avez déjà une instance Gitea en production, ne la remplacez pas pour suivre cette formation. Les deux produits sont suffisamment proches pour que tout ce qui suit s’applique, à quelques différences d’interface près. Je le signalerai lorsque ce sera nécessaire.
Le choix entre les deux relève davantage de la gouvernance et de la licence que de la technique, et c’est un débat sur lequel je ne trancherai pas ici : les deux sont des produits sérieux, activement maintenus, et parfaitement adaptés à l’usage que nous allons en faire.
Ce qu’il faut retenir
- Un comparatif de fonctionnalités ne sert à rien : toutes les forges cochent les mêmes cases.
- Le critère décisif est le coût d’exploitation : ressources, nombre de composants, mises à jour, sauvegarde et restauration.
- Votre forge sera un service de production — la simplicité y vaut plus que la richesse.
- Le coût de sortie ne concerne jamais Git, toujours la périphérie.
- Forgejo est le choix retenu ici : légère, simple à exploiter, registre intégré, automatisation à syntaxe transférable, sans version bridée.
- GitLab reste le bon choix s’il est déjà en place ou si vos besoins de conformité l’exigent.
- En cas de doute : commencez par les patterns ① ② ③, qui n’engagent presque rien.
Dans la leçon suivante
Assez de théorie. Nous allons installer Git — le logiciel, sur votre poste, pas la forge, qui attendra la section 2.
Installation sous Windows et sous Linux, configuration de votre identité, réglage des fins de ligne — ce petit détail qui provoquera sinon des différences fantômes entre vos collègues Windows et vos serveurs Linux — et quelques options qui vous éviteront des ennuis dès la première semaine.