Aller au contenu principal

Hébergement : GitLab Pages et CI

Le pipeline (.gitlab-ci.yml)​

.gitlab-ci.yml
default:
image: node:24-alpine

stages: [verifier, publier]

verifier: # sur les merge requests : build seul, rien n'est publié
script: [npm run build]

pages: # sur main : build puis publication de dist/
variables:
SITE_URL: https://new.francogenie.ca
BASE_PATH: /
script: [npm run build]
pages:
publish: dist
  • Déclenché à chaque commit sur main, donc à chaque enregistrement dans le CMS.
  • Durée : une à deux minutes. Le cache npm accélère les builds suivants.
  • SITE_URL sert aux liens canoniques, aux balises Open Graph et aux fichiers .ics.
  • Si le build échoue, rien n'est publié : le site en ligne garde la version précédente.

Suivi : projet → Compilation → Pipelines. Un pipeline rouge = lire le journal du job pages, le message indique le fichier et le champ invalides.

Pipeline programmé​

Le prochain 6@8 et le passage aux archives sont recalculés dans le navigateur, mais le HTML d'origine n'est régénéré qu'au build. Une planification reconstruit le site chaque nuit :

Projet → Compilation → Planifications de pipelines → Nouvelle planification :

ChampValeur
DescriptionReconstruction nocturne
Intervalle0 4 * * * (personnalisé)
Fuseau horaireAmerica/Toronto (Montréal)
Branche ciblemain

Réglages GitLab Pages​

Projet → Déploiement → Pages :

RéglageValeurPourquoi
Domaine uniqueactivé (francogenie-ee7668.gitlab.io)adresse par défaut du projet
Forcer HTTPSactivé
Domaine principalhttps://new.francogenie.cales autres adresses redirigent vers lui (une seule URL indexée)
Domainesnew.francogenie.ca, vérifié, certificat Let's Encrypt automatiquevoir DNS et domaine

Visibilité. Le projet est privé (le code n'est visible que des membres), mais le site doit être public. Projet → Paramètres → Général → Visibilité, fonctionnalités, autorisations → Pages : Tout le monde. Par l'API : pages_access_level=public.

Après un changement de visibilité ou un transfert du projet

GitLab peut « perdre » le déploiement Pages : la page Déploiement → Pages affiche alors l'assistant Get started with GitLab Pages et le site renvoie vers une connexion GitLab (401). Relancer un pipeline sur main (Compilation → Pipelines → Exécuter le pipeline) recrée le déploiement.

Limites de GitLab Pages​

  • Pas d'en-têtes HTTP personnalisés ni de règles de cache configurables.
  • Redirections possibles avec un fichier public/_redirects (non utilisé pour l'instant).
  • Taille maximale du site publié : 1 Go (le site fait environ 16 Mo).
  • Quota de minutes de CI du groupe : un build consomme environ une minute.