{"canonical_url":"https://engineer.company/fr/glossary/forge/","content_markdown":"# Forge\n\n## Ce que c'est\n\nUne forge, aussi appelée forge logicielle, forge de code ou forge Git, est le\nserveur qu'une équipe choisit comme lieu de référence pour ses dépôts, avec les\nservices qui les entourent. Chaque clone complet d'un dépôt Git contient tout\nl'historique : en principe, aucune copie ne prévaut sur une autre. En pratique,\nune équipe a besoin d'un endroit où pousser le code, qui décide des droits de\nlecture et d'écriture et où se déroulent les discussions sur ce code. Cet endroit\nest la forge.\n\nÀ la base, une forge conserve des dépôts nus, c'est-à-dire l'historique sans\nfichiers extraits dans un répertoire de travail, et utilise un ou plusieurs des\nprotocoles de transfert de Git. Le livre Git en recense quatre : le protocole\nlocal pour un répertoire de la même machine, HTTP, SSH et le protocole propre à\nGit, dont le démon écoute sur le port 9418 sans aucune authentification. Tout le\nreste s'ajoute à cette base, dans des proportions très variables.\n\nLa documentation de Forgejo décrit le côté le plus complet de cette gamme :\nsuivi des tickets, demandes d'intégration, wiki intégré, registre de paquets\npour de nombreux écosystèmes de langages, Forgejo Actions pour exécuter des\ntâches, miroirs de dépôts, migration depuis d'autres services, protection des\nbranches et des étiquettes, et webhooks. Soft Serve se situe à l'autre extrémité.\nIl se présente comme un « serveur Git auto-hébergeable pour la ligne de\ncommande » : un seul binaire, `soft`, qui sert les dépôts par SSH, HTTP ou le\nprotocole Git, contrôle les accès à l'aide de clés publiques SSH et prend en\ncharge les collaborateurs, les dépôts privés et les webhooks. Ce sont deux\nforges ; elles diffèrent par la part du travail de l'équipe qu'elles cherchent\nà réunir.\n\nLes forges ont aussi commencé à communiquer entre elles. ForgeFed est un\nprotocole de fédération des plateformes d'hébergement et de collaboration sur\ndes projets logiciels, conçu comme une extension d'ActivityPub. Il représente\nles dépôts, les gestionnaires de tickets, les gestionnaires de correctifs, les\nprojets et les équipes comme des acteurs qui s'envoient des activités. Il vise\nun langage commun aux réseaux de forges et d'outils de gestion de projets : une\npersonne pourrait ouvrir, depuis un serveur, un ticket concernant un dépôt d'un\nautre serveur, et un dépôt pourrait changer de serveur tandis que son ancienne\ncopie resterait archivée en lecture seule et renverrait vers sa nouvelle adresse.\n\n## Pourquoi c'est important\n\nLa forge est le lieu où les règles peuvent être imposées. Une règle sur la\nmachine d'un développeur ne s'applique que tant que cette machine est correctement\nconfigurée ; un hook sur le serveur s'exécute à chaque push. Le hook\n`pre-receive` de Git reçoit sur l'entrée standard chaque référence poussée,\nsous la forme d'un ancien identifiant, d'un nouvel identifiant et d'un nom. S'il\nse termine avec un code non nul, aucune référence n'est mise à jour. La\nprotection des branches, les revues obligatoires et les vérifications de signature\ndes commits sur les grandes forges affinent la même idée : la copie partagée\nrefuse ce que l'équipe a convenu de ne pas accepter.\n\nChoisir une forge, c'est aussi choisir qui détient le code. Un service hébergé\nprend en charge les coûts d'exploitation et la disponibilité. En contrepartie,\nle code, la liste des accès et toutes les discussions résident sur le matériel\nd'un tiers et sont soumis à ses conditions. L'auto-hébergement inverse cet\néchange. Aucun choix n'est gratuit. La différence compte surtout pour une\nentreprise qui indique à ses clients où se trouvent leurs données.\n\nUne forge détient aussi des données que Git ne conserve pas. Les commits et les\nétiquettes voyagent avec chaque clone ; les tickets, les fils de revue, les\nlistes d'accès et les hooks côté serveur appartiennent à la seule forge. Cette\nséparation détermine ce qu'une sauvegarde doit couvrir et ce qu'une migration\nentre forges doit emporter.\n\n## À quoi cela ressemble en pratique\n\nL'entreprise exploite sa propre forge. Trois projets présentés sur ce site\nmontrent ce qu'il a fallu mettre en place.\n\nSon code source était auparavant hébergé par un service tiers. Le projet de\n[déploiement de sa propre forge Git](/fr/portfolio/your-code-on-your-own-hardware/)\npart d'un constat : exploiter une forge implique d'en assurer l'authentification,\nle contrôle d'accès, le stockage, les sauvegardes et la façade publique. La forge\nest Soft Serve, un seul binaire supervisé par le système d'exploitation, choisi\npour son approche centrée sur SSH et l'absence d'interface web d'administration.\nElle est configurée comme une forge privée : les accès anonymes et sans clé sont refusés, et\nchaque dépôt déclaré est marqué privé. Son service SSH n'écoute que sur\nl'interface de bouclage, sur le port 23231 ; les accès extérieurs passent par un\nhôte de rebond. Un multiplexeur permettant de partager un port public entre HTTPS\net Git sur SSH a été écrit, puis laissé désactivé : un point d'écoute inutilisé\nreste une surface d'attaque. Le résultat est énoncé simplement : l'entreprise\nhéberge son propre code sur son propre matériel.\n\nLe dépôt de ce site y réside lui aussi. Ses consignes désignent la forge\nauto-hébergée, Soft Serve sur SSH, comme dépôt distant canonique, qualifient\nl'ancienne copie hébergée de miroir historique et précisent qu'il n'y a pas de CI\nhébergée : les contrôles de qualité s'exécutent localement et dans les hooks Git.\n\nUn hook côté serveur doit être testé dans l’environnement qui reçoit un véritable push Git. Il a donc été\n[testé avec un vrai dépôt nu et un vrai push](/fr/portfolio/rehearsed-the-forge-ci-hook-found-2-defects/)\navant d'être considéré comme fiable. Le test crée un dépôt nu, installe le hook,\nclone, crée un commit, pousse et vérifie les deux chemins : acceptation et refus.\nIl a révélé deux défauts, invisibles à la lecture du fichier. Le second est\ninstructif : lorsqu'il exécute un hook, Git exporte une variable désignant le\nrépertoire du dépôt. La suite de tests lancée par le hook en héritait ; dix-neuf\ntests échouaient sur du code correct, jusqu'à ce que l'environnement soit nettoyé\nà la frontière entre les deux contextes. La page en précise aussi la limite :\nle test ne construit pas de push comportant des mises à jour forcées ou des\nsuppressions de branches.\n\nTout cela partage\n[un hôte à un seul cœur et 512 Mo de mémoire](/fr/portfolio/a-whole-company-on-one-small-server/)\navec tous les autres services de l'entreprise accessibles au public : sept\ndomaines TLS, un\nservice onion, des serveurs Gemini et Gopher et le blocage des intrusions.\nL'automatisation des sauvegardes est implémentée séparément ; cela ne signifie\npas que les sauvegardes sont actives. Une forge dotée d'un panneau web aurait\najouté une application résidente à ce budget, d'où l'exclusion de ces plateformes\ndès la conception. Sur cet hôte, la mémoire disponible est descendue jusqu'à\nenviron 310 Mo sur 464 au cours d'une journée de mesures enregistrées.\n\n## Où les problèmes surviennent\n\nSur certaines forges, les visiteurs anonymes ont un accès en lecture par défaut.\nLa documentation de Soft Serve indique qu'à l'installation, les connexions\nanonymes disposent de droits de lecture seule, contrôlés par `anon-access` et\n`allow-keyless`. Une forge privée règle le premier sur `no-access` et le second\nsur false. Il est utile de vérifier le résultat depuis une machine sans clé\nchargée. Le démon propre à Git est encore plus radical : le livre Git précise\nqu'un dépôt servi par ce démon est soit clonable par tout le monde, soit non\nservi.\n\nUn hook qui appelle Git dans un autre répertoire agit sur le mauvais dépôt.\nPendant un push, Git exécute les hooks de réception dans le dépôt nu et exporte\n`GIT_DIR` et des variables apparentées pour que les commandes Git du hook le\nretrouvent. Tous les processus qu'il lance en héritent, y compris des tests dans\nune copie de travail située ailleurs. Le manuel githooks demande de supprimer\nces variables avant de travailler sur un autre dépôt. Un hook `pre-receive`\nminimal qui teste chaque commit poussé dans un répertoire temporaire le fait dans\nun sous-shell :\n\n```sh\nwhile read -r _ newrev _; do\n  git cat-file -e \"$newrev^{commit}\" 2\u003e/dev/null || continue\n  tree=$(mktemp -d)\n  git archive \"$newrev\" | tar -x -C \"$tree\"\n  (\n    unset $(git rev-parse --local-env-vars)\n    cd \"$tree\" \u0026\u0026 ./run-tests\n  ) || exit 1\ndone\n```\n\nUne forge restaurée retrouve son code, mais pas ses règles. N'importe quel clone\npeut repeupler les dépôts d'un serveur perdu, mais le livre Git rappelle que les\nhooks côté serveur et les paramètres similaires restent sur le serveur. Les\ntickets, revues, clés et listes d'accès n'ont jamais fait partie des clones.\nSauvegarder une forge implique de sauvegarder son répertoire de données et sa\nconfiguration, de restaurer les deux quelque part et de vérifier qu'un push que\nle hook doit refuser est effectivement refusé.\n\nChaque point d'écoute ouvert par une forge est un élément à défendre. L'exemple\nde configuration de Soft Serve place SSH sur le port 23231, HTTP sur 23232, le\ndémon Git sur 9418 et un serveur de statistiques sur 23233. Une équipe qui pousse\nuniquement par SSH peut désactiver les autres ou les lier à l'interface de\nbouclage : les ports ouverts correspondent alors aux seuls usages réels.\n\nChanger de forge emporte le code et laisse les discussions derrière. Un push\nmiroir copie toutes les références sous `refs/`, branches et étiquettes comprises,\net rien d'autre. Les tickets, fils de revue, labels et listes d'accès nécessitent\nl'outil de migration de la nouvelle forge, ou un protocole comme ForgeFed :\ncelui-ci copie les commits, les étiquettes, les tickets, les demandes de fusion\net les commentaires, puis laisse l'ancien dépôt archivé avec un lien vers le\nnouveau.\n\n## Pour aller plus loin\n\n- [Spécification ForgeFed](https://forgefed.org/spec/) — le protocole de\n  fédération des forges, ses acteurs, ses activités et le processus de migration\n  qui archive l'ancien dépôt.\n- [Soft Serve](https://github.com/charmbracelet/soft-serve) — la documentation du\n  projet : un serveur Git en un seul binaire, centré sur SSH, avec notamment\n  les paramètres `anon-access` et `allow-keyless`.\n- [Documentation Forgejo](https://forgejo.org/docs/latest/) — les guides\n  d'administration et d'utilisation d'une forge auto-hébergée complète, de\n  l'installation aux sauvegardes, aux Actions et aux miroirs.\n- [githooks](https://git-scm.com/docs/githooks) — tous les hooks exécutés par Git,\n  dont `pre-receive`, et l'environnement dont hérite un hook de push.\n- [Les protocoles](https://git-scm.com/book/en/v2/Git-on-the-Server-The-Protocols)\n  — les quatre moyens utilisés par Git pour transférer des données entre\n  machines, et leurs coûts de configuration et de sécurité.\n- [ActivityPub](https://www.w3.org/TR/activitypub/) — la recommandation du W3C\n  étendue par ForgeFed.\n\n\u003chttps://engineer.company/fr/glossary/forge/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Ce qu'une forge ajoute aux dépôts qu'elle héberge, à quel point elle peut être légère et les difficultés de l'auto-hébergement du code partagé.","formats":{"gemtext":"https://engineer.company/fr/glossary/forge/index.gmi","gopher":"https://engineer.company/fr/glossary/forge/gophermap","html":"https://engineer.company/fr/glossary/forge/","json":"https://engineer.company/fr/glossary/forge/index.json","markdown":"https://engineer.company/fr/glossary/forge/index.md","pdf":"https://engineer.company/fr/glossary/forge/index.pdf"},"kind":"page","language":"fr","title":"Qu'est-ce qu'une forge ?","url":"https://engineer.company/fr/glossary/forge/","version":1}