¶ Gitlab pages
¶ Comment héberger votre site sur le Gitlab d'INP-net ?
¶ 1. Créer votre dépôt sur https://git.inpt.fr
Connectez vous avec votre compte INP-net et cliquez sur nouveau dépôt / new repository
Puis cliquez sur "Créer un projet vide", rentrer le nom de votre site et décochez "Initialiser le dépôt avec un README".
Note: si vous souhaitez avoir votre site sur identifiant.pages.inpt.fr et pas identifiant.pages.inpt.fr/dépôt, le nom du dépôt doit être exactement "identifiant.pages.inpt.fr" (où identifiant est votre @)
par exemple, pour un site sur net7.pages.inpt.fr/, il faut que le dépôt soit à net7/net7.pages.inpt.fr. Si le dépôt est à net7/site, l'URL sera net7.pages.inpt.fr/site
¶ 2. Pousser votre code sur votre ordi vers le dépôt distant
Après la création du dépôt, vous avez trois options :
- Créer un nouveau dépôt sur votre ordi
- Pousser un dossier existant
- Pousser un dépôt Git existant
Vous pouvez suivre les instructions affichées selon votre cas.
¶ 3. Activer la fonctionnalité CI/CD sur votre dépôt
Allez dans Paramètres dans la barre à gauche, puis Général puis cherchez "CI/CD", activez la fonctionnalité et enregistrez.
¶ 4. Déployer votre site avec Gitlab Pages
Allez dans Déploiement, puis Pages et suivez les instructions.
Si votre site est du pur HTML/CSS/JS, à la première étape :
- Vous pouvez mettre l'image "busybox" qui est un Linux très léger.
- Et spécifier le dossier à publier, "public" par défaut. Ce dossier contiendra tout ce qui doit être publié, votre fichier index.html devrait être dedans par exemple.
Deuxième étape (installation) : vous n'avez rien à installer, donc ne mettez rien.
Troisième étape (build): vous n'avez rien non plus à build, mais GitLab nécessite quand même un script, vous pouvez mettre un simple echo "Déploiement..."
Votre fichier .gitlab-ci.yaml (qui est en aperçu à droite) devrait ressembler à ça :
# The Docker image that will be used to build your app
image: busybox
create-pages:
pages:
# The folder that contains the files to be exposed at the Page URL
publish: public
rules:
# This ensures that only pushes to the default branch will trigger
# a pages deploy
- if: $CI_COMMIT_REF_NAME == $CI_DEFAULT_BRANCH
script:
- echo "Déploiement..."
Si vous utilisez un framework (Svelte, NextJS, Astro...), la documentation de celui-ci devrait vous indiquer quelles commandes utiliser pour l'installation et le build.
¶ 5. Voir le lien généré
Après le déploiement de votre site, revenez dans l'onglet Pages et le lien généré vers votre site sera affiché.
⚠️ Par défaut, le lien changera à chaque changement du site avec l'identifiant du commit, pour que votre site ait le même lien à chaque changement, vous pouvez aller dans l'onglet Pages, le sous onglet "Domaines & Paramètres" et décocher "Utiliser un domaine unique"
¶ 6. (optionnel) Mettre un nom de domaine personnalisé**
Revenez sur l'onglet Pages puis Domaines & Paramètres, et cliquez sur "Ajouter un domaine" ce domaine doit pointer vers l'IP 147.127.160.237, qui est celle du serveur Pages.