Configurer Forgejo Pages (équivalent GitLab Pages) #2

New issue

thomas-sanson · 2026-05-19T07:42:36+02:00

thomas-sanson commented

2026-05-19 07:42:36 +02:00

Le déploiement de sites statiques façon GitLab Pages n'est pas encore en place sur l'instance.

Doc de référence : https://git-pages.org/

Exemple de tentative : https://forgejo.incubateur.education-nationale.eu/louis.paternault/cours-snt/src/branch/main/.forgejo/workflows/pages.yml

Le déploiement de sites statiques façon GitLab Pages n'est pas encore en place sur l'instance. Doc de référence : https://git-pages.org/ Exemple de tentative : https://forgejo.incubateur.education-nationale.eu/louis.paternault/cours-snt/src/branch/main/.forgejo/workflows/pages.yml

👍 3

louis-paternault added a new dependency

2026-05-19 10:51:52 +02:00

#3 Configurer les runners Forgejo Actions

thomas-sanson commented

2026-05-21 15:46:00 +02:00

c'est bon !

Pages opérationnel sur l'instance, j'ai monté une démo complète qui prouve la chaîne de bout en bout :

Le fonctionnement : un push sur main lance le workflow Actions, qui build avec MkDocs (pour l'exemple) et publie via actions/git-pages@v2. Le site est en ligne ~1 minute après. Pas de secret à configurer côté repo, pas de mot de passe, pas de bucket à créer, le token Forgejo Actions injecté automatiquement suffit. Parité fonctionnelle avec GitLab Pages / GitHub Pages.

Petit truc qui m'a vraiment fait galérer : sur notre cluster Kapsule, quand un pod (le runner ou Forgejo lui-même) essaie de joindre l'IP publique du load balancer de son propre cluster, ça tombe systématiquement en timeout (hairpin NAT pas supporté). J'ai contourné en faisant pointer le hostname forgejo.incubateur.education-nationale.eu vers un proxy interne au cluster avec un cert Let's Encrypt dédié, comme ça toute la publication reste intra-cluster et le LB public n'est plus dans le chemin.

Suite UX : j'ai aussi ouvert #22 pour proposer une mini-action wrapper qui rendrait le workflow encore plus simple pour les profs (1 ligne au lieu de 5).

c'est bon ! Pages opérationnel sur l'instance, j'ai monté une démo complète qui prouve la chaîne de bout en bout : - dépôt : https://forgejo.incubateur.education-nationale.eu/gt-forgejo/demo-pages-mkdocs - site live : https://gt-forgejo.pages.incubateur.education-nationale.eu/demo-pages-mkdocs/ Le fonctionnement : un push sur `main` lance le workflow Actions, qui build avec MkDocs (pour l'exemple) et publie via `actions/git-pages@v2`. Le site est en ligne ~1 minute après. Pas de secret à configurer côté repo, pas de mot de passe, pas de bucket à créer, le token Forgejo Actions injecté automatiquement suffit. Parité fonctionnelle avec GitLab Pages / GitHub Pages. Petit truc qui m'a vraiment fait galérer : sur notre cluster Kapsule, quand un pod (le runner ou Forgejo lui-même) essaie de joindre l'IP publique du load balancer de son propre cluster, ça tombe systématiquement en timeout (hairpin NAT pas supporté). J'ai contourné en faisant pointer le hostname `forgejo.incubateur.education-nationale.eu` vers un proxy interne au cluster avec un cert Let's Encrypt dédié, comme ça toute la publication reste intra-cluster et le LB public n'est plus dans le chemin. Suite UX : j'ai aussi ouvert #22 pour proposer une mini-action wrapper qui rendrait le workflow encore plus simple pour les profs (1 ligne au lieu de 5).

thomas-sanson closed this issue

2026-05-21 15:46:01 +02:00

thomas-sanson added a new dependency

2026-05-21 15:46:10 +02:00

#22 Simplifier la publication Pages : mini-action wrapper gt-forgejo/pages-deploy

thomas-sanson removed a dependency

2026-05-21 15:46:18 +02:00

#22 Simplifier la publication Pages : mini-action wrapper gt-forgejo/pages-deploy

Sign in to join this conversation.