Hébergement : GitLab Pages et CI
Le pipeline (.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_URLsert 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 :
| Champ | Valeur |
|---|---|
| Description | Reconstruction nocturne |
| Intervalle | 0 4 * * * (personnalisé) |
| Fuseau horaire | America/Toronto (Montréal) |
| Branche cible | main |
Réglages GitLab Pages
Projet → Déploiement → Pages :
| Réglage | Valeur | Pourquoi |
|---|---|---|
| Domaine unique | activé (francogenie-ee7668.gitlab.io) | adresse par défaut du projet |
| Forcer HTTPS | activé | |
| Domaine principal | https://new.francogenie.ca | les autres adresses redirigent vers lui (une seule URL indexée) |
| Domaines | new.francogenie.ca, vérifié, certificat Let's Encrypt automatique | voir 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.
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.