À qui s’adresse ce tutoriel ?

Vous avez créé un artefact avec une I.A. générative et souhaitez le partager facilement ? Ce guide vous accompagne pas à pas pour publier votre page HTML sur la Forge de l’Éducation nationale, sans compétences techniques particulières.

Étape 1 — Connexion à la Forge

1. Accédez au site : docs.forge.apps.education.fr
2. Entrez dans l’atelier GitLab.
3. Utilisez le connecteur adapté, puis sélectionnez « Éducation Nationale » pour vous identifier.
4. Cliquez sur Nouveau Projet, puis choisissez Créer un projet vide.

Le projet est créé. Il reste à télécharger l’artefact et à configurer le site.

Étape 2 — Télécharger l’artefact

1. Depuis le site de l’I.A. ou l’application de bureau, cliquez sur Télécharger.
2. Renommez le fichier en index.html avant de continuer.

Le nom index.html est indispensable : c’est le fichier que le serveur chargera automatiquement à l’ouverture du site.

Étape 3 — Déposer le fichier sur la Forge

De retour sur la Forge, déposez votre fichier. La méthode la plus simple pour un fichier unique :

1. Cliquez sur le bouton ➕.
2. Sélectionnez Téléverser un fichier.
3. Déposez votre fichier index.html.

Il ne reste plus qu’une étape : configurer votre dépôt pour publier la page HTML comme un site.

Étape 4 — Publication avec « Pages »

1. Rendez-vous dans le menu Déploiement › Pages.
2. Dans « Select your build image », saisissez alpine:latest (ce réglage sera écrasé automatiquement ensuite). Passez à l’étape suivante.
3. Copiez le code de configuration dans le fichier de droite.

   pages:
     stage: deploy
     script:
       - mkdir public
       - cp index.html public/
     artifacts:
       paths:
         - public
     only:
       - main

4. Cliquez sur Suivant plusieurs fois jusqu’à obtenir un message confirmant le lancement d’un pipeline.

Qu’est-ce qu’un pipeline ?
Un pipeline est une série d’étapes automatisées (construction, déploiement…) déclenchées par vos actions sur le dépôt — ici, il publie votre page HTML automatiquement.

Le pipeline exécute le code et publie la page. Votre site est fonctionnel !

Étape 5 — Personnaliser l’adresse de publication

Par défaut, des caractères aléatoires sont ajoutés à l’URL pour la rendre unique. Pour obtenir une adresse plus lisible :

1. Retournez dans Déploiement › Pages — vous devriez voir votre site listé.
2. Cliquez sur Domaines et paramètres.
3. Décochez l’option « Utiliser un domaine unique ».
4. Enregistrez les modifications.

Votre site est désormais visible à une adresse plus simple et mémorisable.

Et ensuite ?

Si vous continuez à améliorer votre site avec Claude ou une autre IA, vous pouvez mettre à jour votre fichier index.html de deux façons :

• Téléverser la nouvelle version : répétez l’étape 3 en déposant la version mise à jour.
• Modifier directement le code : utilisez l’éditeur web de la Forge (Web EDI) pour modifier le fichier en ligne.

Une fois vos changements terminés, validez (commit) vos modifications. Chaque commit déclenche automatiquement un nouveau pipeline qui republiera votre site à jour.

Qu’est-ce qu’un commit ?
Un commit est un instantané des modifications apportées à votre projet dans Git. Il enregistre vos changements avec un message descriptif pour suivre l’historique du code.

Lien vers un article pour coder une application en VibeCoding