Guide de démarrage

La plateforme Jelina comprend des logiciels pour les équipements, les serveurs et les clients, conçus pour déployer votre code en toute sécurité sur un ensemble d’équipements.

Le principe est simple : après installation de JelinaOS, vous pouvez gérer, superviser et mettre à jour tous vos équipements et applications depuis le tableau de bord JelinaCloud. La configuration applicative est stockée dans un bloc distinct et livrée à votre flotte pour faciliter le déploiement.

Ce guide décrit les composants et processus d’un déploiement Jelina type et apporte les détails nécessaires pour répondre aux questions les plus courantes sur son fonctionnement interne.

Pour passer à la pratique, démarrez votre propre projet.

Sur l’équipement

Les équipements de l’écosystème exécutent JelinaOS, un système hôte minimal fondé sur Debian ou Ubuntu, fourni avec le moteur de conteneurs Docker. Le système hôte lance Jelinvisor, l’agent de gestion, ainsi que les services conteneurisés et les programmes natifs. Chaque système de base Jelina peut exécuter toute image Docker et tout programme ELF Linux compatible avec l’architecture de l’équipement. Les systèmes de base partagent le noyau de l’hôte, mais fonctionnent autrement de façon indépendante. Vous pouvez configurer les services conteneurisés en mode privilégié pour accéder directement au matériel ou même charger des modules dans le noyau. Le gestionnaire Jelina s’exécute dans son propre conteneur, permettant à l’équipement de continuer à fonctionner même si une application plante.

Mises à jour du système et du noyau

Jelina vise une capacité de mise à jour à 100 %. Le système et le noyau de JelinaOS sont mis à jour indépendamment et disposent chacun de partitions A/B distinctes. Si l’équipement utilise A, la nouvelle version est écrite sur B, puis le système bascule vers B après réussite. Si l’installation échoue ou qu’une erreur inattendue survient après basculement, il conserve A ou y revient. Jelina maintient toujours au moins une partition utilisable pour préserver les applications et les données.

Tous les équipements JelinaOS, de développement comme de production, peuvent recevoir des mises à jour système et noyau, pilotées depuis le tableau de bord JelinaCloud.

Configuration de l’équipement

Comment ajouter un équipement à votre flotte ?

Téléchargez d’abord l’image JelinaOS. Une configuration unique est intégrée à chaque téléchargement. Si vous avez déjà l’image, vous pouvez télécharger uniquement la configuration et l’y écrire avec jelina_flash_stream, outil non encore disponible. Le fichier contient les paramètres de base de la flotte, une clé d’enregistrement unique liée à celle-ci et l’adresse d’enregistrement.

Après écriture de l’image, vérifiez la connexion réseau. Au démarrage, Jelinvisor s’exécute et enregistre automatiquement l’équipement sans intervention. Il utilise la configuration pour rejoindre la flotte cible et génère une API Key unique pour les échanges ultérieurs. Après succès, le cloud conserve cette clé et supprime la clé d’enregistrement. Il mémorise alors l’équipement, qui devient visible dans le tableau de bord.

Une fois enregistré dans la flotte, l’équipement installe automatiquement sa dernière Release disponible. Si une Release fixe est définie pour la flotte, il installe celle-ci.

Construire une Release

Une Release regroupe plusieurs applications conteneurisées et natives, Program. Sa configuration repose sur docker-compose2.0, avec des extensions pour les applications non conteneurisées. Développeurs comme non-développeurs peuvent saisir le Compose manuellement ou le générer en renseignant la liste de services de l’interface. Après configuration, téléversez les images et programmes, puis publiez la Release pour la déployer sur tous les équipements de la flotte.

Construire un Increment, facultatif

Si une application native nécessite un environnement d’exécution supplémentaire, vous pouvez le configurer en téléversant un paquet incrémental, Increment.

Attention : l’Increment est envoyé depuis un équipement vers JelinaCloud. Configurez d’abord l’environnement sur cet équipement, puis sélectionnez-le dans le tableau de bord pour lancer le téléversement. Il empaquette son environnement et l’envoie à sa flotte.

Un Increment ne prend effet qu’après association à une Release. L’équipement installe d’abord l’Increment associé, puis la Release, pour fournir le bon environnement aux applications. En théorie, ces paquets permettent à JelinaOS d’exécuter tout type d’application, selon leur contenu.

Accéder à l’équipement

Selon l’intervalle défini dans la flotte, l’équipement récupère périodiquement son état cible : versions de Release, JelinaOS, Kernel et Jelinvisor, Increment à utiliser, configuration et variables de service.

Toutes les 30 s, il remonte son état, notamment ses informations et celles des services en cours. Une connexion persistante transmet également les journaux à JelinaCloud pour observer le système et les applications.

Le tableau de bord présente les informations détaillées, les services, les mises à jour à venir et les journaux. Il permet aussi de contrôler le cycle de vie de l’équipement et de ses applications.

Notifications d’anomalies

Pour signaler rapidement les incidents, tous les membres de la flotte reçoivent automatiquement une notification si l’équipement devient hors ligne ou présente une anomalie de service, de fonctionnement ou de consommation des ressources. Les seuils de ressources sont personnalisables. Si la même anomalie se répète dans un délai de 3 heures, JelinaCloud ne la notifie qu’une fois.

Accélérer le développement

Jelina permet d’uniformiser les environnements de test et de développement, de déployer rapidement et de tester les fonctions applicatives. Les journaux facilitent l’analyse du comportement sur le matériel réel et accélèrent la réalisation du projet.