TP 2 — Déployer votre forge et la mettre en service

📚Git pour les administrateurs système : La Forge
🔧 Travaux pratiques⏱ 120 min

Objectif

À l’issue de ce TP, vous disposerez d’une forge réellement utilisable en production — pas d’un bac à sable. C’est celle que vous garderez pour toute la suite de la formation, et probablement au-delà.

Vous allez :

  • déployer Forgejo et sa base de données ;
  • le publier sous son nom définitif, en HTTPS ;
  • valider l’installation avec les bons réglages ;
  • raccorder l’authentification à votre annuaire ou votre fournisseur d’identité ;
  • structurer les organisations et les équipes ;
  • et surtout vérifier que votre accès de secours fonctionne — le contrôle que tout le monde oublie.

Prérequis

Élément Détail
Une VM Linux Docker et Docker Compose installés
Un nom DNS Résolvant vers la VM, en interne
Un reverse proxy Nginx, Traefik ou Caddy — ou aucun, voir parcours minimal
Un certificat Autorité interne, Let’s Encrypt, ou auto-signé pour un lab
(optionnel) Un IdP Authentik, Keycloak, ADFS, Entra ID
(optionnel) Un annuaire Active Directory avec un compte de service

Trois parcours possibles pour la partie authentification, selon ce dont vous disposez :

  • Parcours A — vous avez un fournisseur d’identité → mission 5A
  • Parcours B — vous avez un annuaire mais pas d’IdP → mission 5B
  • Parcours C — ni l’un ni l’autre → mission 5C

⚠️ Avant de commencer : notez vos décisions

Reprenez la checklist de la leçon 2.1 et remplissez-la. Vous en aurez besoin à chaque mission, et certaines de ces valeurs sont difficiles à changer après coup.

# Décision Votre valeur
1 Nom DNS de la forge
2 Type de certificat
3 Chemin des données sur l’hôte
4 Nom de l’organisation principale
5 Nom de la source d’authentification
6 Emplacement de sauvegarde

Mission 1 — Déployer

Préparez l’arborescence sur l’hôte, avec les bonnes permissions, puis déployez Forgejo et PostgreSQL.

Contraintes :

  • Le mot de passe de la base ne doit apparaître nulle part dans le docker-compose.yml.
  • L’image doit être épinglée sur une version majeure.
  • La base ne doit être joignable que par Forgejo.
  • Aucun port ne doit être publié sur l’hôte (sauf si vous suivez le parcours sans reverse proxy).
  • Forgejo ne doit pas démarrer avant que la base ne soit réellement prête.

💡 Indices

  • Le mot de passe passe par un fichier .env et une substitution ${...}.
  • Les permissions du dossier de données doivent correspondre à USER_UID et USER_GID.
  • Un depends_on simple ne suffit pas : il faut y associer un healthcheck sur la base.
  • Deux réseaux : un privé pour la base, un partagé avec le proxy.

Point de contrôle : docker compose ps affiche deux services running, dont la base marquée healthy.


Mission 2 — Publier, puis vérifier

Publiez la forge derrière votre reverse proxy, sous son nom définitif, en HTTPS.

⚠️ Ne validez pas l’assistant d’installation à ce stade.

Contraintes :

  • Redirection automatique de HTTP vers HTTPS.
  • Les envois volumineux ne doivent pas être bloqués.
  • Les barres obliques encodées doivent être transmises correctement.
  • Les WebSockets doivent passer.
  • Forgejo doit voir l’adresse réelle des clients, pas celle du proxy.

💡 Indices

  • Côté Nginx : client_max_body_size, merge_slashes off, les en-têtes Connection et Upgrade.
  • Côté Traefik : attention au conteneur rattaché à deux réseaux.
  • Côté Forgejo : REVERSE_PROXY_TRUSTED_PROXIES doit couvrir la plage du réseau Docker de votre proxy. Trouvez-la avec docker network inspect.

Points de contrôle :

curl -I http://forge.votre-domaine        # 301
curl -I https://forge.votre-domaine       # 200
docker compose logs forge-server | tail   # votre IP, pas celle du proxy

Mission 3 — Valider l’assistant

Accédez à la forge par son nom définitif et déroulez l’assistant.

Contraintes :

  • Ne touchez à aucun champ de la section base de données.
  • Le serveur SSH doit être désactivé.
  • L’URL de base doit être exacte, barre oblique finale comprise.
  • L’inscription libre doit être fermée.
  • Le compte administrateur créé ici ne doit pas être votre compte nominatif.
  • Configurez l’envoi de courriels si vous disposez d’un relais.

💡 Indices

  • Le port SSH se désactive en vidant le champ.
  • Sur un relais interne en port 25, laissez identifiant et mot de passe vides — l’authentification exigerait TLS.
  • Le compte administrateur est votre porte de secours : nommez-le en conséquence, et rangez son mot de passe dans votre coffre.

Point de contrôle : vous êtes connecté, et le pied de page affiche la version de Forgejo.


Mission 4 — Durcir

Ajoutez au compose les réglages qui ne figurent pas dans l’assistant, puis redémarrez.

À obtenir :

  • Double authentification obligatoire pour les administrateurs.
  • Tout nouveau dépôt créé privé par défaut.
  • Cache dimensionné pour une petite instance.
  • Création d’organisations réservée aux administrateurs.

💡 Indice

Quatre variables, dans les sections security, repository, cache et admin. Reportez-vous à la leçon 2.4.

Point de contrôle : à la reconnexion, Forgejo vous invite à configurer un second facteur. Faites-le tout de suite, sur votre compte comme sur le compte de secours.


Mission 5A — Authentification par OIDC (parcours A)

Déclarez Forgejo comme client dans votre fournisseur d’identité, puis créez la source côté forge.

Contraintes :

  • Seuls les membres d’un groupe donné doivent pouvoir se connecter.
  • Les comptes doivent être créés automatiquement à la première connexion.
  • Un utilisateur dont l’adresse existe déjà localement doit devoir prouver qu’il possède le compte avant rattachement.
  • Les groupes doivent remonter dans le jeton.

💡 Indices

  • Décidez le nom de la source avant de configurer l’IdP : il détermine l’URI de redirection.
  • Les groupes ne sont presque jamais transmis par défaut : scope, mapper ou règle de revendication selon votre produit.
  • ACCOUNT_LINKING doit rester à login.
  • Pour vérifier que les groupes arrivent : renseignez temporairement le champ « groupe administrateur ».

Points de contrôle :

  • Un compte de test membre du groupe se connecte et son compte est créé.
  • Un compte non membre du groupe est refusé.
  • Le compte d’administration local se connecte toujours par mot de passe.

Mission 5B — Authentification par LDAP (parcours B)

Créez une source LDAP via BindDN vers votre Active Directory.

Contraintes :

  • Connexion chiffrée.
  • Compte de service dédié, en lecture seule.
  • Seuls les membres d’un groupe donné peuvent se connecter.
  • Un compte désactivé dans l’annuaire ne doit pas pouvoir se connecter.
  • N’activez pas encore la synchronisation périodique.

💡 Indices

  • Validez votre filtre côté annuaire avant de le saisir dans Forgejo : ldapsearch ou Get-ADUser -LDAPFilter.
  • L’exclusion des comptes désactivés passe par une comparaison binaire sur UserAccountControl.
  • L’attribut e-mail est requis : un compte sans adresse ne sera pas créé.

Points de contrôle :

  • Un compte du groupe se connecte, avec nom, prénom et adresse renseignés.
  • Un compte hors du groupe est refusé.
  • Un compte désactivé est refusé.
  • Le compte d’administration local fonctionne toujours.

Mission 5C — Sans annuaire (parcours C)

Créez deux comptes locaux supplémentaires depuis l’administration du site, avec des rôles différents. Vous les utiliserez pour tester les permissions en mission 6.

Notez que vous pourrez revenir sur cette mission plus tard : ajouter une source d’authentification n’invalide pas les comptes locaux existants.


Mission 6 — Structurer

Créez la structure d’organisations et d’équipes qui portera vos dépôts.

À obtenir :

  • Une organisation principale pour le travail de l’équipe informatique.
  • Une organisation distincte destinée à ce qui devra être distribué largement.
  • Au moins trois équipes avec des niveaux d’accès différents.
  • Deux propriétaires sur l’organisation principale, dont le compte de secours.
  • (Parcours A ou B) Une correspondance automatique entre vos groupes et vos équipes, avec retrait des utilisateurs qui quittent le groupe.

💡 Indices

  • Reportez-vous à la matrice de la leçon 2.9.
  • La correspondance se déclare dans la source d’authentification, au format JSON.
  • Testez avec un seul groupe avant de bâtir la correspondance complète : le format de la clé diffère entre OIDC et LDAP.
  • N’oubliez pas la case de retrait automatique, sans quoi les droits ne sont jamais repris.

Point de contrôle : ajoutez votre compte de test au groupe, reconnectez-vous, et vérifiez qu’il apparaît dans la bonne équipe. Retirez-le du groupe, reconnectez-vous, vérifiez qu’il en sort.


Mission 7 — Visibilité

Créez deux dépôts vides :

  • scripts-powershell dans l’organisation principale, privé ;
  • gpo dans l’organisation de distribution, public.

Puis vérifiez réellement ce que chacun expose.

💡 Comment vérifier

Ouvrez une fenêtre de navigation privée, sans être connecté :

  • Le dépôt privé doit renvoyer une page d’erreur ou une invitation à se connecter.
  • Le dépôt public doit s’afficher.

Puis testez en ligne de commande, sans authentification :

curl -I https://forge.votre-domaine/public-interne/gpo

Avant de valider cette mission, déroulez les quatre contrôles d’exposition de la leçon 2.10. Si l’un d’eux échoue, repassez le dépôt en privé.


Mission 8 — Le contrôle que tout le monde oublie

C’est la mission la plus importante du TP, et la plus rapide.

Simulez l’indisponibilité de votre authentification externe et vérifiez que vous pouvez toujours entrer.

💡 Comment procéder

Le plus simple, sans rien casser : ouvrez une session de navigation privée et connectez-vous uniquement avec le compte d’administration local et son mot de passe.

Si vous voulez aller plus loin, désactivez temporairement la source d’authentification depuis l’administration du site, vérifiez que la connexion locale fonctionne, puis réactivez-la.

Puis documentez-le. Écrivez, quelque part que vos collègues trouveront, la procédure d’accès de secours : quel compte, où est le mot de passe, quoi faire si l’IdP est en panne.

Le jour où ce sera nécessaire, ce ne sera peut-être pas vous qui serez devant l’écran.


🎁 Bonus

Bonus 1 — Envoyez un courriel de test depuis Administration du site → Configuration.

Bonus 2 — Consultez le fichier de configuration généré et comparez-le à vos variables :

docker compose exec forge-server cat /data/gitea/conf/app.ini

Bonus 3 — Redéployez votre forge sans assistant, dans un environnement de test : toute la configuration dans le compose, INSTALL_LOCK=true, et création du compte administrateur en ligne de commande. C’est l’approche que vous voudrez adopter en production.


Ce que vous devez avoir à la fin

  • Une forge joignable en HTTPS sous son nom définitif
  • Aucun secret en clair dans le docker-compose.yml
  • Les journaux affichant l’adresse réelle des clients
  • L’inscription libre fermée
  • La double authentification active sur les comptes administrateurs
  • Une authentification centralisée fonctionnelle (parcours A ou B)
  • Un compte de test refusé lorsqu’il n’appartient pas au groupe autorisé
  • Deux organisations, trois équipes, deux propriétaires
  • Un dépôt privé invisible sans authentification, un dépôt public accessible
  • Un accès de secours testé et documenté

Ce que ce TP vous a réellement appris

La mission 8 paraît anecdotique — trois minutes, une connexion en navigation privée. Elle est pourtant la seule qui vous sauvera un jour.

Une forge est un service de production dont dépendront bientôt vos stratégies de groupe, vos déploiements et vos images de conteneurs. Le jour où votre fournisseur d’identité tombera, ce n’est pas « l’accès au code » que vous perdrez : c’est la capacité à corriger quoi que ce soit.

La plupart des administrateurs découvrent qu’ils n’ont pas d’accès de secours au moment précis où ils en auraient besoin. Vous, non.