backtivisda.md 3.2 KB
Backtivisda
Backtivisda est le Système de Gestion de Contenu (CMS) de Aktivisda. Il permet d'administrer quotidiennement votre instance de Aktivisda (modifier les images, créer de nouveaux modèles, etc.)
En pratique, Backtivisda est une version modifiée d'Aktivisda où
- Les données sont toujours synchronisées avec votre projet Gitlab : on utilise l’API de Gitlab pour récupérer ces données
- Il y a des fonctionnalités supplémentaires pour manipuler les images.
Backtivisda interagit donc avec l’instance Gitlab qui hébérge vos donées et avec un serveur où sont effectuées les opérations distantes (compression d'image, vectorisation, etc.)
Prérequis
Pour fonctionner vous avez besoin de deux token pour vous authentifier :
- auprès de Gitlab : pour cela créer un token d’accès au projet.
- auprès du serveur de traitement d’images : soit vous disposez de votre propre serveur, soit vous pouvez demander à [email protected] un token
Il faut également que le fichier .env.backtivisda ait été correctement paramétré.
Principe de fonctionnement
!> Bon à savoir pour le moment, les modifications ne sont pas sauvegardées sur votre ordinateur. Cela signifie en particulier que toutes vos modifications disparaissent à chaque fois que vous rafraîchissez votre navigateur (le fameux F5).
Voici ce qui se passe lorsqu’on souhaite faire une modification avec Backtivisda :
- Se rendre sur
/backtivisda; - Le site est alors téléchargé par votre navigateur depuis un serveur où est disposé une version compilée de backtivisda.
- Vous renseignez vos deux tokens (uniquement la première fois, ensuite ces tokens sont enregistrés dans voter navigateur) ;
- Backtivisda va alors télécharger les données depuis Gitlab. Les données sont téléchargées au fur et à mesure, uniquement lorsque nécessaire (par ex. les images de fond sont téléchargées lorsqu'on se rend sur cette page)
- Vous faites les manipulations que vous souhaitez : ajout ou modificatino d’images, de modèles, etc.
- Une fois satisfait·e, vous vous rendez sur la page Synchroniser, vérifiez vos modifications, écrivez un message et cliquez sur Synchroniser
- Un commit est créé et transmis à Gitlab. Il s’agit d’un paquet de toutes vos modifications. Un point de sauvegarde est aussitôt créé, ce qui permet éventuellement d’annuler une modification ;
- Ce commit créée une Pipeline de compilation (regarder la section Pipelines) sur Gitlab
- Cette pipeline attend qu’un worker soit disponible. Aujourd’hui, pour des contraintes techniques, ce worker n'est pas tout le temps disponible. Au bout de 4h, si aucun worker n'est disponible, l'intégration continue échoue ;
- Une fois le worker disponible, Aktivisda est compilé en prenant en compte les nouvelles données (quelques minutes) ;
- Le nouveau site est transféré depuis le worker vers le serveur en charge du service (via FTP ou SSH) ;
- Ça y est, Aktivisda est disponible ! Vous pouvez vous en rendre compte en regardant la date Last Update dans la barre de navigation de Aktivisda