Étude de cas

Héberger son portfolio avec Hugo, GitLab CI et Caddy

Un site statique bilingue, publié sur mon propre serveur, avec une maintenance minimale. Les pistes étudiées, le choix et ses compromis.

· 7 min de lecture · Mis à jour le 16 nov. 2026

Je voulais un site statique pour publier simplement quelques articles, hébergé sur le Virtual Private Server Serveur virtuel loué chez un hébergeur, que l'on administre comme une machine à soi. En savoir plus que j’avais déjà, sans surcharger ce petit serveur, où la sécurité est basée sur la simplicité. Résultat : Hugo, un pipeline GitLab Intégration continue Chaîne automatique qui construit, teste et déploie le code à chaque envoi dans le dépôt. En savoir plus qui pousse les fichiers par Synchronisation de fichiers Copie un dossier vers une autre machine en n'envoyant que ce qui a changé. En savoir plus, et Caddy qui les sert. Le build prend moins d’une seconde et il n’y a rien à maintenir côté serveur.

Le besoin

Ce site sert de vitrine : des fiches projets, un parcours, et des articles que je relaie sur LinkedIn. Pour qu’il vive, il faut que publier soit facile. Il faut aussi que la maintenance soit minimale, sans sacrifier la sécurité.

Mes critères :

  • Publication : écrire en Markdown dans n’importe quel éditeur de texte, publier par git push, avec une relecture possible avant la mise en ligne et des articles programmés.
  • Maintenance : le moins de pièces mobiles possible. Pas de base de données, pas d’écosystème npm à surveiller.
  • Existant : un VPS OVH qui fait déjà tourner Caddy, avec le Transport Layer Security Protocole qui chiffre les échanges entre le navigateur et le serveur. C'est le « S » de HTTPS. En savoir plus automatique.
  • Coût : rien de plus que ce VPS.
  • Contenu : français et anglais, de bons aperçus de partage pour LinkedIn, pas de bannière cookies.

Les pistes étudiées

PistePublicationMaintenanceExistantVerdict
CMS (WordPress, Ghost)interface webbase de données, mises à jour, surface d’attaqueun service de plus sur le VPSÉcartée : trop de maintenance pour un site qui change deux fois par mois
Astro ou Next.js en statiquegit pushchaîne npm à tenir à jourcompatibleÉcartée : le build dépend de centaines de paquets
Hugo sur un hébergeur géré (GitLab Pages, Netlify)git pushquasi nulleinutiliséÉcartée : le VPS est déjà payé, et je garde la main sur les en-têtes et les logs
Hugo sur le VPS, déployé par la CIgit pushun binaire à version figéeréutiliséRetenue

Le choix et ses raisons

Hugo est un binaire unique. Il gère nativement le multilingue, les taxonomies, le traitement d’images et même la génération des images de partage (titre et fond de la charte pour chaque article). Le thème est fait maison, en CSS natif sans Tailwind ni PostCSS : il n’y a donc aucun package.json dans le dépôt.

GitLab CI construit le site avec une version figée de Hugo, vérifiée par son empreinte Fonction de hachage Calcule une empreinte unique d'un fichier. Si l'empreinte correspond à celle publiée, le fichier n'a pas été modifié. En savoir plus, puis l’envoie sur le VPS. Le serveur n’a besoin ni de Hugo ni d’aucun autre outil de build. Les branches autres que main partent sur un site d’aperçu, ce qui donne la relecture avant publication. Un pipeline planifié chaque matin publie les articles dont la date est arrivée.

Caddy était déjà en place sur le VPS et s’occupe des certificats. Il suffit d’ajouter un fichier de configuration pour le site.

GoatCounter mesure l’audience. Il ne pose aucun cookie et ne garde pas de données personnelles, donc pas de bannière de consentement. C’est un binaire Go unique avec une base SQLite, qui tourne sur le même VPS comme service Gestionnaire de services Linux Démarre les services au lancement du serveur, les relance s'ils s'arrêtent et centralise leurs journaux. En savoir plus. Caddy le sert sous le domaine du site : le script de comptage vient de david.rondello.org/gc/, et la Content Security Policy En-tête HTTP qui indique au navigateur d'où une page a le droit de charger scripts, styles et images. Il limite les dégâts d'une injection de code. En savoir plus reste limitée au domaine lui-même. Le tableau de bord est sur un sous-domaine à part.

Architecture du portfolioUn git push depuis mon poste déclenche le pipeline GitLab CI : build Hugo, puis envoi par rsync sur le VPS OVH, où Caddy sert le site et relaie la mesure d'audience GoatCounter.MON POSTEGITLAB CIVPS OVHÉditeurMarkdownhugo server -DBuildhugo --minifyversion figée, SHA-256Déploiementmain → productionbranches → aperçu+ pipeline planifié chaque matin(articles programmés)CaddyTLS auto, CSP, cachedavid.rondello.org/srv/portfoliopublic/preview/GoatCounteraudiencesans cookiegit pushrsyncSSHsert/gc
De l'éditeur au visiteur : un git push, un build, un rsync.

Compromis acceptés :

  • Pas d’édition depuis un téléphone ou une interface web : tout passe par Git.
  • Le VPS est un point unique : s’il tombe, le site tombe. Pour un portfolio, c’est acceptable.
  • Pas de formulaire de contact ni de commentaires : le site reste statique, le contact passe par LinkedIn.
  • Un thème maison, c’est du temps au départ, en échange d’un site sans dépendance à un thème tiers.

La mise en œuvre

Le déploiement tient en deux commandes (intégrées dans la CI de GitLab) :

hugo --gc --minify --environment production
rsync -rlz --checksum --delete-delay --delay-updates public/ deploy@vps:public/

--delay-updates met les nouveaux fichiers en place d’un coup à la fin du transfert, ce qui évite qu’un visiteur tombe sur un site à moitié à jour. --checksum est nécessaire parce que Hugo réécrit tous les fichiers à chaque build : sans cette option, rsync renverrait tout le site à chaque fois.

Côté sécurité, la CI se connecte avec un utilisateur dédié sans sudo, et sa clé SSH est limitée à rsync dans le répertoire des fichiers du site grâce à rrsync. Même si la clé fuit, elle ne permet que d’écrire dans ce dossier.

Caddy ajoute une CSP stricte (aucun script ni style en ligne dans les gabarits), un cache d’un an sur les fichiers à empreinte, une revalidation systématique du HTML, et une page 404 dans la langue de l’URL.

Une petite subtilité a été la clé SSH stockée dans une variable GitLab. Une fois copiée, il lui manquait le retour à la ligne final, et OpenSSH répondait par un error in libcrypto qui n’aide pas à comprendre. Le pipeline nettoie maintenant la clé avant de l’utiliser.

La bonne pratique sur GitLab est de stocker une clé privée dans une variable de type « File ». GitLab ne sait masquer dans les logs que les valeurs d’une seule ligne, sans espace : une clé privée ne peut donc pas être masquée, et dans une variable classique, un env ou un echo dans le pipeline l’afficherait en clair. Avec le type « File », GitLab écrit la clé dans un fichier temporaire, et la variable ne contient que le chemin de ce fichier, prêt à passer à ssh -i. GitHub Actions fonctionne autrement : un secret y est toujours du texte, qu’il faut écrire soi-même dans un fichier, avec le même risque de perdre le retour à la ligne final.

Le thème a été généré à partir d’un Design System mis au point avec Claude Design.

Bilan après quelques jours

  • Le build complet prend quelques centaines de millisecondes en local, images comprises.
  • Ajouter la mesure d’audience après coup a été simple : un service systemd pour GoatCounter et deux blocs dans la configuration de Caddy.
  • Une alternative que j’aurais pu considérer : Publii avec le même process de publication via GitLab CI.

À retenir : un site statique bien fait ne demande presque aucune maintenance, et c’est ce qui permet de réserver du temps à l’écriture d’article 😉.