Deuxfleurs a fait le choix de stocker ses données via un système de son cru nommé Garage. Ce dernier a de nombreux avantages dont un va particulièrement nous intéresser ici, c’est de publier un “dossier” (on appelle ça un bucket) directement comme un site web. C’est très efficace car on minimise les abstractions et les calculs à réaliser : ça consomme peu de ressources chez Deuxfleurs, et ça fait des sites rapides à consulter pour les internautes. Par contre, le site web doit être sous forme de fichiers HTML, CSS et Javascript : on ne peut pas le générer à la volée comme le fait un Wordpress, en allant chercher les informations dans une base de données. On appelle ce genre de site, “des sites statiques”, car ce sont simplement les mêmes fichiers qui sont envoyés à tout le monde pour constituer le site final.
Alors si vous avez l’habitude de réaliser vos sites webs à la main, vous devriez être aux anges : en une commande, ou un glisser/déposer, votre site web est en ligne. Mais si vous êtes plutôt du genre à utiliser une interface, comme un système de gestion de contenu, alors tout devient plus compliqué…
À moins que… à moins qu’on puisse combiner “sites statiques” et “CMS”. Et heureusement pour nous, les sites statiques sont à la mode, donc pas mal de gens ont travaillé sur la question ces dernières années ! Quand on est cool, on appelle ça une Jamstack. Ici rien à voir avec la confiture ou des concerts de musique, JAM veut dire Javascript, API et Markup. Ce concept est issu de réflexions par des développeurs web sur l’architecture idéale pour développer des sites webs. Nous, on va se contenter de garder les principes qui nous intéresse là dedans.
Un premier principe, c’est un découplage entre le front, c’est à dire le site web que voient les internautes, et le back, c’est à dire l’interface qui permet de créer, modifier, ou supprimer du contenu. Un autre principe, c’est que le front qui est présenté aux internautes doit être le plus pré-calculé possible pour que ce soit aussi rapide et économe que possible de charger une page web. À partir de ces deux principes, on a tout un ensemble de conséquences très désirables (bonnes performances, faibles coûts, sécurité, passage à l’échelle, mise en cache facilitée, etc.).
Maintenant qu’on a vu la théorie, passons à la pratique, et prenons ce (billet de) blog comme exemple ! Vous lisez ce billet depuis le front qui est en réalité une série de fichiers HTML, CSS et Javascript. Ces fichiers sont stockés dans Garage et ont été créés par un générateur de site statique, ici le vénérable Jekyll, qui va transformer des fichiers Markdown en HTML. Bien sûr, Jekyll ne fonctionne pas tout seul, ni automatiquement, il faut le lancer à chaque modification. Pour automatiser ce lancement et l’envoi des fichiers, on va utiliser un exécuteur de tâches, ici Drone. Maintenant, il faut bien stocker ces fichiers Markdown quelque part, pour ça on utilise Git, et plus particulièrement Gitea. Enfin, parce qu’éditer ces fichiers Markdown à la main, et les envoyer dans Git, est une tâche fastidieuse, on a créer une interface back qui permet de cacher toute cette complexité et proposer un environnement d’écriture, nous y voilà, je parle bien de StaticCMS. Lors de votre travail de publication, vous n’aurez pas besoin de vous soucier de tout ces composants. Comme avec Wordpress, vous allez simplement intéragir avec une interface web de gestion de contenu.
Pour vous en convaincre, voici le tableau de bord de notre CMS :
Et voici son interface d’écriture :
À l’instant où je vais appuyer sur “Publier”, alors c’est tout le système qui va se mettre en branle automatiquement : mes modifications seront enregistrées (avec la gestion d’un historique pour pouvoir revenir en arrière), Drone va se lancer et construire les nouvelles pages de mon site web avec Jekyll, et ensuite les envoyer sur Garage.
Alors face à tout ces composants, on pourrait critiquer que ça ajoute une complexité importante, avec de nombreuses pièces mobiles (moving parts en anglais), c’est à dire des composants indépendants, qu’il faut configurer pour faire fonctionner ensemble, et qui ensuite ont leur propre cycle de vie. Tout d’abord, ces composants ont des interfaces bien définies et relativement stables dans le temps, ensuite, ces configurations peuvent être automatisées et cachées. In fine, une plateforme bien intégrée peut très largement réduire la complexitée perçue, tout en laissant une flexibilité très importante pour quelqu’un qui aurait des besoins spécifiques.
Concrètement, aujourd’hui, vous pourriez vous demander quelles sont les étapes pour publier votre site statique avec un CMS sur Deuxfleurs ?
Tout d’abord, il faut préparer un dépôt git pour votre site web. Il vous faut commencer par choisir un générateur de site statique (Jekyll, Hugo, Zola, etc.). Souvent ces générateurs ont une commande pour initialiser le dépôt avec un squelette de fichiers (exemple : jekyll new mon-blog)
Ensuite, suivez le guide de StaticCMS pour intégrer le CMS à votre dépôt de site statique. Vous devriez avoir à la fin un dossier admin avec 3 fichiers : config.yml, index.html et static-cms-app.js (je vous conseille en effet de “vendorer” le fichier plutôt que d’utiliser un CDN). Notez que les informations de la section backend sont spécifiques à votre hébergeur, pour Deuxfleurs voici les paramètres à configurer :
backend:
name: gitea
repo: <username>/<repo>
base_url: https://teabag.deuxfleurs.fr
api_root: https://git.deuxfleurs.fr/api/v1
branch: main
Vous devriez maintenant pouvoir valider vos modifications dans git, les pousser sur le dépôt, et lancer un serveur de développement local (exemple : jekyll serve). En accédant à http://localhost:4000/admin/ (pensez à adapter le port) vous devriez pouvoir accéder à votre interface CMS.
Une fois le CMS en place, vous pouvez configurer l’automatisation via Drone en ajoutant un fichier .drone.yml, puis en activant la CI sur votre dépôt, après avoir configuré les secrets pour publier sur Garage. Au final, vous pourrez ensuite travailler sur votre site web depuis l’URL complète de votre site, dans mon cas https://quentin.dufour.io/admin/.
Bien entendu, nous pourrions imaginer une interface qui vous permettrait de choisir un thème de site web, et qui vous créerait automatiquement le dépôt, avec les bons fichiers, et la configuration Drone qui va bien, de sorte qu’en moins de 5 minutes vous aillez un squelette en ligne sur lequel vous pouvez ajouter du contenu ! C’est pour une autre fois ça :-)