« Premiers pas - v4 » et « E-comBox:Main Page » : différence entre les pages

De Documentation e-comBox
(Différence entre les pages)
Aucun résumé des modifications
 
 
Ligne 1 : Ligne 1 :
[[Fichier:MenuGaucheV4.png|droite|692x692px]]
{{ProjectInfobox
L’application e-comBox est une application Web qui permet de lancer et gérer un certain nombre de sites basés sur les applications suivantes :
|name = Projet e-comBox
* Prestashop :
|summary = L’application e-comBox est une application Web, utilisant la technologie des conteneurs Docker, installable uniquement sur Linux pour la version 4.
** une instance vierge,
|members = Christelle Thiry, Cécile Pignon-Nivaggioni, Apollonie Raffalli, étudiants du BTS SIO du Lycée Laetitia Bonaparte à Ajaccio, équipes du réseau Certa.
** une instance personnalisée (site Art Concept Stories) ;
}}
* WordPress avec WooCommerce :
** une instance vierge,
** une instance personnalisée (site Art Concept Stories) ;
* WordPress sans WooCommerce, mais avec le add-in H5P ;
* Mautic ;
* Suite CRM ;
* Odoo dans sa version 12,13 et 14 :
** une instance vierge de chaque version,
** six instances personnalisées (SweetyBio, AdA, generik, pépinières, primeur et surplomb) ;
* Kanboard (gestion de projet) :
** une instance vierge,
** une instance personnalisée (BdDev) ;
* HumHub (réseau social).
{{doc-important|Depuis la version 3, il est également possible de créer des sites à partir d'une image personnalisée.}}
<br>
{{note | L'installation de l'e-comBox est documentée pour [[Installation_sur_Linux_-_v4|Linux]]. Il n'est pas possible d'installer la version 4 sur Windows ou MacOS. | reminder}}
 
{{note|La version 4 nécessite de se connecter via un compte "Prof". Voir [[Gestion_Utilisateurs|ici]] le mode opératoire.}}
 
== L'interface de l'e-comBox ==
L'interface de l'e-comBox est composée d'un menu à gauche, d'un bandeau avec :
 
* un raccourci vers la page d'aide,  
* un bouton pour accéder à la page de modification de mot de passe,
* un bouton pour se déconnecter,
 
et d'une zone principale qui s'adapte en fonction de l'élément de menu sélectionné :
[[Fichier:Accueil v4.png|centré|900x900px]]
Le tableau de bord permet d'avoir une vue d'ensemble sur :
* la version de l'e-comBox ;
* le nombre de sites créés ainsi que leur état (démarré ou stoppé) ;
* l'instance de l'e-comBox ;
* le nom de l'utilisateur connecté ;
* les ressources utilisées (mémoire, espace de stockage et CPU) en cliquant sur le lien correspondant.
[[Fichier:Dashboard v4.png|centré|900x900px]]
 
== Gestion des sites ==
Le menu gauche liste l'ensemble des types de sites disponibles : Prestashop, WooCommerce, Blog, Mautic, Suite CRM, Odoo, Kanboard et HumHub.
Un clic sur chacun affiche la page de gestion correspondante.
 
=== Créer un site ===
 
Pour créer un site, il suffit de saisir un complément de nom pour le site puis cliquer sur le bouton ''créer'' (ou valider directement avec la touche "entrée" du clavier) :
 
 
[[File:DocUtilisateur-images-image22.png|1000px|centre]]


[[File:DocUtilisateur-images-image16.png|400px|droite]]
L’application e-comBox permet d'installer le plus simplement possible, au sein d'un réseau d'établissement, sur un portable personnel ou chez un hébergeur en ligne (serveur OVH par exemple), plusieurs instances de différentes applications (prestashop, wordpress, mautic, odoo, kanboard, etc) sous forme de conteneurs docker : les serveurs pourront être créés à la demande en tant que de besoin. L’idée est ici de répondre aux besoins pédagogiques les plus étendus des enseignants tout en réduisant les contraintes techniques au minimum.
Au clic du bouton ''créer'' (ou après avoir validé via la touche "entrée"), vous pouvez choisir de créer plusieurs sites.
<br>
<br>
<br>
<br>
Si vous laissez par défaut, un seul site sera créé et le nom du site sera de la forme : '''''type de site-complément de nom'''''.
''L’application e-comBox est elle-même une application web “dockérisée” installable sur n’importe quel système d’exploitation (Windows 10, Linux et MacOS) qui permet de lancer et gérer le ou les conteneurs dans lesquels le service est installé.''
Par exemple ici le nom sera '''''blog-01'''''.
 
{{note|Le complément de nom peut contenir des chiffres et/ou des lettres minuscules. Les accents et caractères spéciaux ne sont pas autorisés.}}
<br>
<br>
Après validation, un témoin d'activité apparaît. Lorsque le site est prêt un message (sous forme de ''pop-up'') l'indique.
[[File:DocUtilisateur-images-image17.png|300px|centre]]
<br>
{{note|Le temps de création du site dépend de la qualité de la connexion internet et des ressources matérielles de la machine sur laquelle e-comBox est installée sachant que la première création d'un site est toujours beaucoup plus longue que les suivantes car l'image (qui est ensuite stockée sur la machine) est téléchargée.}}
Une fois la création terminée, le site est automatiquement démarré et la "carte" correspondante apparaît dans la zone ''Gérer les sites à partir d'un modèle fourni'' :
<br>
<br>
Des scripts sont fournis pour les systèmes Linux (Debian et Ubuntu) pour installer l'application.


[[File:Images13.png|900x900px|centre]]
{{note | la version 4 permet le déploiement de l'e-comBox à grande échelle dans les académies et dans les régions. Elle est disponible uniquement sur Linux.}}


Pour créer plusieurs sites automatiquement, il suffit de donner un nom littéral au site et de choisir le nombre de sites que l'on veut créer (un numéro d'ordre s'incrémentera après le nom du site) :
Une instance de l'application est installée sur '''un seul poste (ou serveur)''', l'interface d'administration et les sites créés sont ensuite accessibles à distance via n'importe quelle machine.
[[Fichier:Creation 4 blogs.png|centré|900x900px]]
<br>
Quatre sites de noms "blog-eleve1" à "blog-eleve4" seront créés :
[[Fichier:Creation plusieurs sites.png|centré|900x900px]]


{{note | L’application est livrée sous la '''licence CeCILL''' (Acronyme pour Ce(A)C(nrs)I(NRIA)L(ogiciel)L(ibre)) soumise au droit français et respectant les principes de diffusion des logiciels libres. Vous pouvez utiliser, modifier et/ou redistribuer ce programme sous les conditions de la licence CeCILL telle que diffusée par le CEA, le CNRS et l'INRIA sur le site [https://www.cecill.info/ https://www.cecill.info/]|reminder}}
<br>


'''Pour les sites Prestashop et WooCommerce''', il est possible de créer 2 types de sites :
'''Une vidéo de présentation est disponible''' : https://www.reseaucerta.org/pgi/e-combox
* '''vierge''' : site par défaut proposé par Prestashop et WooCommerce ;
<br>
* '''Art Concepts Stories''' : e-boutique opérationnelle (300 références, 150 clients, 130 commandes).


Il est donc nécessaire de choisir un type avant de cliquer sur le bouton ''créer'' :  
{{note| Pour tout problème rencontré avec l’utilisation de la e-comBox ou son installation vous devez créer un compte sur le support dédié (http://llb.ac-corse.fr/ecomboxsupport/signup_page.php) et ajouter un nouveau ticket. Cela permet notament aux autres utilisateurs de la e-comBox d’avoir accès à la résolution des différents problèmes. Vous trouverez l’aide pour l’utilisation du support [[Contactez_le_support|ici]].
[[Fichier:Creation presta.png|centré|900x900px]]
Lors de la création de ce ticket, il faut y ajouter les logs qui nous aideront à comprendre les causes de l'incident. Pour savoir où sont stockés les logs, vous pouvez vous référer à la [[FAQ - v4|FAQ]] |warn}}
'''De même pour les sites Odoo''', il est possible de choisir entre les versions 12,13, 14 ou des images personnalisées :
[[Fichier:Creation odoo.png|centré|900x900px]]
=== Démarrer/arrêter un site ===


Un site démarré est affiché de la façon suivante :
==Nouveautés de la version 4==
[[Fichier:Site demarre.png|centré|600x600px]]
La nouvelle version d'e-comBox est disponible ! Comme chaque incrémentation cette version apporte son lot de nouveautés et d'améliorations.
Un clic sur le bouton bleu (interrupteur) permet alors d'arrêter le site. Un site stoppé est affiché de la façon suivante :
[[File:Image2.png|600px|centre]]
Un nouveau clic sur l'interrupteur permet de le démarrer.<br>


{{Warning/fr|msg=Le démarrage d'un site peut prendre quelques minutes car une mise à jour est réalisée automatiquement afin de prendre en compte la modification éventuelle de l'environnement d'e-comBox (en cas de changement de réseau par exemple).}}
{{Note | Cette version n'est proposée que pour une installation sur Linux. Si vous désirez installer l'e-comBox sur un poste windows, il vous faudra installer la version 3. | error}}


=== Accéder à un site ===
Les principales nouveautés de cette version sont :
*La possibilité d'utiliser un reverse-proxy externe.
*La gestion de comptes utilisateurs (les professeurs ne voient et ne peuvent agir que sur les sites qu'ils ont eux-mêmes créés).
*Intégration du protocole HTTPS.
*Utilisation d'un seul port (qui peut être celui classiquement utilisé pour HTTPS) même si on n'installe pas de Reverse Proxy externe.
*Installation de l'e-comBox sans intervention de l'administrateur.
*Déploiement automatisé : exemple de script et de documentation pour un déploiement via Ansible.
*Gestion optimisée et facilitée des certificats avec un script permettant de générer un certificat avec letsEncrypt.
*Partage de ses propres modèles de sites : le partage de modèles de sites sera possible directement à partir de l'interface e-comBox après avoir créé un compte sur la plateforme Docker Hub.
*Récupération d'un modèle de site créé par un utilisateur de la communauté : il sera désormais possible, à partir du nom complet du modèle, de créer un site à partir d'un modèle partagé par un utilisateur de la communauté e-comBox.
*Actions sur les sites : possibilité de réaliser une action (supprimer, stopper, démarrer) sur plusieurs sites en les sélectionnant.
*Accès aux identifiants de connexion des différents sites directement à partir de l'interface d'e-comBox.


Pour accéder à un site, ce dernier doit être démarré.
Les scripts utilisés sont disponibles sur gitlab :https://gitlab.com/e-combox/e-comBox_scriptsLinux.


Un lien cliquable ''Accéder au site'' (redirigeant vers l'URL du site dans un nouvel onglet du navigateur) est affiché pour chaque site démarré.
{{note | Les scripts ont été testés sur les versions Linux (obligatoirement 64 bits) suivantes :
* Ubuntu (à partir la version 18.04) ;
* Debian 9 ;
* Debian 10 ;
* Debian 11 (actuellement stable). | reminder}}


'''Les URL peuvent être visualisées :'''
==Fonctionnalités de l’e-comBox==
[[File: MenuDetailleV3.png|180px|droite]]L’application e-comBox est une application Web qui permet de lancer et gérer un certain nombre de sites basés sur les applications suivantes :
*Prestashop :
**une instance vierge,
**une instance personnalisée (site Art Concept Stories) ;
*WordPress avec WooCommerce :
**une instance vierge,
**une instance personnalisée (site Art Concept Stories) ;
*WordPress sans WooCommerce, mais avec le add-in H5P ;
*Mautic ;
*Suite CRM ;
*Odoo :
**versions 12, 13 et 14,
**six instances personnalisées : SweetyBio, primeur, surplomb, pépinières, adA et Generik;
*Kanboard (gestion de projet) :
**une instance vierge,
**une instance personnalisée (BdDev) ;
*HumHub (réseau social).
'''La gestion de base''' permet de :
*lister les types de sites (Wordpress, prestashop, etc.) à partir desquels il est possible de créer un ou plusieurs sites ;
*créer, démarrer, arrêter ou supprimer un site ;
*lister les sites créés (avec l’état pour chacun et son URL d’accès au backoffice) ;
*créer un modèle à partir d'un site créé et personnalisé.
'''La gestion avancée''' permet l’accès :
*SFTP aux sites Prestashop et Wordpress ;
*via phpMyAdmin aux bases de données des sites Prestashop et Wordpress ;
*“admin” à l’interface de Portainer ;
*gérer les modèles de sites créés (visualisation, suppression, récupération et partage).


* '''Au survol du lien ''Accéder au site'' :'''
==Quatre types d'installation pour l'e-comBox==
[[Fichier:Affiche URL.png|centré|600x600px]]
L'installation peut se faire sur :
*'''un poste de l'établissement''' ;
*'''un serveur de l'établissement''' ;
*'''un serveur dans le cloud''' ;
*'''le poste personnel du professeur'''.
{{note|Pour une installation sur Linux, '''c'est le serveur qui est sur Linux''', l'ordinateur du professeur peut être sur n'importe quel système d'exploitation. Il accède à l'interface de l'e-comBox '''à distance''' avec un navigateur.}}
L'accès via un navigateur à l'interface de l'e-comBox peut évidemment se faire à distance.
<br>
Pour des raisons de commodité, il sera fait l’usage de “git” (le script l’installe) pour récupérer des fichiers sur les [https://gitlab.com/e-combox dépôts officiels ''gitlab''] de l’application.


* '''Au clic sur le bouton ''Afficher les URL'' :'''
==Caractéristiques minimum de la machine==
[[Fichier:Btn affiche URL.png|centré|600x600px]]
'''L'application nécessite au minimum :'''
{{Done|Le bouton Afficher les URL n'apparaît qu'à partir du moment où au moins un site est démarré.}} {{note|Les URL sont au format ''http://<hôte ou adresse IP d'ecomBox>:<port du proxy>/<nom-du-site>/<chemin-backoffice>''.
*Linux : distribution basée sur Linux 64 bits comme Debian 9/10 ou Ubuntu à partir de la version 18.04 ;
Par exemple, dans l'image ci-dessus, l'hôte est "llb.ac-corse.fr", le port du proxy est "11252" et le chemin vers le backoffice est "/wp-admin". '''Seuls les noms des sites changent (blog-01, blog-02, blog-03 et blog-04)'''.}}
*la virtualisation activée dans le BIOS (ce qui est fait, en règle générale, par défaut) ;
*la fonction SLAT supportée au niveau du processeur ;
*une connexion Internet de qualité ;
*8 Go de RAM : plus il y a de RAM, mieux c'est, pour notamment faire démarrer les sites en même temps ;
*le service Docker avec “docker-compose” (le script se chargent de l’installer) ;


=== Exporter la liste des URL au format PDF ===
Pour chaque type de site (Prestashop, WooCommerce, Blog, etc.) il est possible d'afficher en un clic la liste des URL pour l'ensemble des sites démarrés. Pour cela, il suffit de cliquer sur le bouton ''Afficher les URL'' :
[[Fichier:Export pdf.png|centré|400x400px]]
Le bouton ''Exporter'' permet de générer et d'ouvrir automatiquement un fichier PDF contenant cette liste :
[[Fichier:Pdf.png|centré|600x600px]]
{{Note/fr|Les URL sur ce fichier PDF sont cliquables.}}
=== Supprimer un site ===
Pour supprimer un site, il faut cliquer sur le bouton en haut à droite de la "carte" correspondante :
[[Fichier:Del site.png|centré|600x600px]]
{{Warning/fr|msg={{color|red|La suppression est irréversible et les données associées au site seront supprimées !}}}}
'''Par sécurité, une confirmation est demandée''' : en cliquant sur ''Valider'', après un petit temps de chargement (l'animation ''Loading'' est affichée), le site est supprimé.
[[Fichier:Popup del.png|gauche|vignette]]
<br>Ce ''pop-up'' vous en averti en s'affichant en haut à droite de la page.<br>{{Note/fr|La carte associée disparaît alors de l'e-comBox.}}
<br clear=all>
=== Dupliquer un site ===
== Gestion avancée ==
La gestion avancée permet :
* d'accéder aux sources des sites Prestashop et Odoo ;
* d'accéder aux bases de données des sites Prestashop, WooCommerce et Blog ;
* d'administrer directement les conteneurs : {{color|red|'''à utiliser avec prudence'''}}.
=== Accès SFTP ===
L'accès SFTP permet d'accéder aux sources des sites Prestashop et Odoo.
[[Fichier:Accueil sftp.png|centré|900x900px]]
{{note|Sur cette page ne sont affichés que les sites Prestashop et Odoo démarrés car pour activer le SFTP, le site associé doit obligatoirement être démarré.}}
Lorsque le SFTP est activé pour un site l'affichage est du type :
[[Fichier:Sftp active.png|centré|600x600px]]
{{Note/fr|Une fois le SFTP activé, il est possible d'accéder aux sources dans un nouvel onglet à partir de l'URL  de l'hôte fournie afin de faire d'éventuelles modifications (l'identifiant de connexion est ecb, un mot de passe aléatoire est généré. Ces deux informations figurent sur la carte).}}
[[Fichier:Connexion sftp.png|centré|600x600px]]
Voici par exemple un extrait du contenu des "addons" d'Odoo :
[[Fichier:Addons odoo.png|centré|900x900px]]
<br>Accès phpMyAdmin
L'activation de l'interface web ''phpMyAdmin'' pour un site Prestashop, WooCommerce ou Blog permet l'administration de la base de données associée via le navigateur.
[[Fichier:Accueil pma.png|centré|900x900px]]
{{note | Sur cette page ne sont affichés que les sites Prestashop, WooCommerce et Blog démarrés car pour activer phpMyAdmin, le site associé doit obligatoirement être démarré.}}
Lorsque phpMyAdmin est activé pour un site l'affichage est du type :
[[Fichier:Pma active.png|centré|600x600px]]
{{Note/fr|Une fois phpMyadmin activé, il sera possible d'accéder via le navigateur à la base de données du site.}}
Par exemple ici, pour le site ''blog-eleve2,'' phpMyAdmin sera accessible à l'adresse https://172.31.40.117:8800/pma-blogeleve2/''.''
=== Accès admin ===
Il s'agit d'un lien vers l'interface d'administration de Portainer. Ce lien n'est visible que pour les utilisateurs disposant des droits ''admin''.
[[Fichier:Accueil portainer.png|centré|900x900px]]
{{Warning/fr|msg=Cette interface doit être utilisée avec une grande prudence car il est possible ici de supprimer les containers et les données d'un site sans aucune demande de confirmation ! L'application ''e-comBox'' peut également être supprimée !}}
== Caractéristiques de chaque type d'application ==
=== Les identifiants d'accès ===
Les identifiants d'accès sont dans un fichier qui est installé par les scripts dans le dossier ''/opt/e-comBox.''
=== Généralités sur les différentes applications ===
{| class="wikitable"
|-
! Application !! Version !! Commentaires
|-
| Prestashop
| 1.7.6.5
| 2 versions : une e-boutique opérationnelle ''Art Concept Stories'' (300 références, 150 clients, 130 commandes) et une boutique avec la version ''démo'' proposée par Prestashop.
|-
| wooCommerce
| 5.4.2
| 2 versions : une e-boutique opérationnelle ''Art Concept Stories'' (300 références, 150 clients) et une boutique "squelette" totalement vierge.
|-
| Blog
| 5.4.2
| Le module H5p est installé et activé.
|-
| Mautic
| 3
| Mautic nécessite une configuration : voir ci-dessous le mode opératoire avec les éléments nécessaires.
|-
| Suite CRM
| 7.10.11
|
|-
| Odoo
| 12 et 13
| Odoo n'intègre aucun site mais comprend les modules les plus utilisés. D'autres modules peuvent être intégrés facilement via le SFTP.
|-
| Kanboard
| 1.2.10
|Voir ci-dessous pour basculer l'interface graphique en français.
|-
| Humhub
| 1.3.12
|
|}
==== Configuration de Mautic ====
[[File:Image26.png|600px|droite]]
Mautic doit être configuré avec les éléments suivants :
<br>
<br>
<br>
{{note|8 Go de RAM est réellement un minimum, il ne faudra pas espérer faire tourner plus de 20 sites en même temps et vous risquez de rencontrer certaines lenteurs.
{{note/fr}} Database Password : le mot de passe est donné sur l'interface au moment de la création du site.
<br/>
<br>
Pour un '''serveur Linux''' devant héberger plusieurs sites pour deux classes de 32 élèves, il est conseillé de disposer d'au minimum 16 Go de RAM. |warn}}
[[Fichier:Mautic.png|gauche|600x600px]]
<br clear=all>
 
Pour Basculer Mautic en français via l'interface graphique :
* roue dentée/configuration/system setting ;
* puis ''Apply'' ou ''Save &amp; Close'' ;
* se reconnecter.
 
{{note/fr}} Il est possible de changer d'autres paramètres comme ''Default timezone''.
 
{{Warning/fr}} Les paramètres de ''Mautic AdresseIP:port'' ne change jamais dans  ''Configuration/paramètres généraux'' (même en cas de changement d'adresse IP) mais cela n'entraîne pas d'effets de bords et l'application continue de fonctionner normalement.
 
====Basculer Kanboard en français====
 
Sur l'interface graphique :
# Aller dans la rubrique Application settings.
# Modifier la langue, le fuseau horaire et le format des dates.
# Enregistrer.


== Aide ==
==Ports utilisés==
En cas de besoin les liens suivants sont mis à disposition dans la page ''Aide'' :
Les ports 8880, 8800 et 5443 sont utilisés par défaut pour l'application elle-même. Ils doivent être libres sur le serveur. Si ce n'est pas le cas, vous devrez spécifier d'autres ports lors de l'installation de la e-comBox. Dans cette version :
* [[E-comBox:Main_Page|documentation en ligne]] ;
*Si vous n'installez pas de Reverse Proxy externe, par défaut seul le port 8800 est exposé, vous pouvez le fixer à 443 (PORT_RP=443) de manière à ce que l'interface, Portainer et l'ensemble des applications soient accessibles directement (sans précision du port) via https.
* [[Trousse_de_premiers_secours|trousse de premiers secours]] ;
*Si vous installez un Reverse Proxy externe, c'est le port exposé par ce Reverse Proxy qui sera utilisé. Vous pouvez donc laisser les ports par défaut au niveau de l'application.
* [[FAQ - v4|FAQ]] ;
* [[Contactez_le_support|plateforme de support]] pour déclarer un incident avec un mode opératoire.

Version du 24 février 2023 à 00:36

Wikimedia Foundation project
Projet e-comBox
L’application e-comBox est une application Web, utilisant la technologie des conteneurs Docker, installable uniquement sur Linux pour la version 4.
Team members: Christelle Thiry, Cécile Pignon-Nivaggioni, Apollonie Raffalli, étudiants du BTS SIO du Lycée Laetitia Bonaparte à Ajaccio, équipes du réseau Certa.

L’application e-comBox permet d'installer le plus simplement possible, au sein d'un réseau d'établissement, sur un portable personnel ou chez un hébergeur en ligne (serveur OVH par exemple), plusieurs instances de différentes applications (prestashop, wordpress, mautic, odoo, kanboard, etc) sous forme de conteneurs docker : les serveurs pourront être créés à la demande en tant que de besoin. L’idée est ici de répondre aux besoins pédagogiques les plus étendus des enseignants tout en réduisant les contraintes techniques au minimum.

L’application e-comBox est elle-même une application web “dockérisée” installable sur n’importe quel système d’exploitation (Windows 10, Linux et MacOS) qui permet de lancer et gérer le ou les conteneurs dans lesquels le service est installé.

Des scripts sont fournis pour les systèmes Linux (Debian et Ubuntu) pour installer l'application.

la version 4 permet le déploiement de l'e-comBox à grande échelle dans les académies et dans les régions. Elle est disponible uniquement sur Linux.

Une instance de l'application est installée sur un seul poste (ou serveur), l'interface d'administration et les sites créés sont ensuite accessibles à distance via n'importe quelle machine.

L’application est livrée sous la licence CeCILL (Acronyme pour Ce(A)C(nrs)I(NRIA)L(ogiciel)L(ibre)) soumise au droit français et respectant les principes de diffusion des logiciels libres. Vous pouvez utiliser, modifier et/ou redistribuer ce programme sous les conditions de la licence CeCILL telle que diffusée par le CEA, le CNRS et l'INRIA sur le site https://www.cecill.info/


Une vidéo de présentation est disponible : https://www.reseaucerta.org/pgi/e-combox

Pour tout problème rencontré avec l’utilisation de la e-comBox ou son installation vous devez créer un compte sur le support dédié (http://llb.ac-corse.fr/ecomboxsupport/signup_page.php) et ajouter un nouveau ticket. Cela permet notament aux autres utilisateurs de la e-comBox d’avoir accès à la résolution des différents problèmes. Vous trouverez l’aide pour l’utilisation du support ici. Lors de la création de ce ticket, il faut y ajouter les logs qui nous aideront à comprendre les causes de l'incident. Pour savoir où sont stockés les logs, vous pouvez vous référer à la FAQ

Nouveautés de la version 4

La nouvelle version d'e-comBox est disponible ! Comme chaque incrémentation cette version apporte son lot de nouveautés et d'améliorations.

Cette version n'est proposée que pour une installation sur Linux. Si vous désirez installer l'e-comBox sur un poste windows, il vous faudra installer la version 3.

Les principales nouveautés de cette version sont :

  • La possibilité d'utiliser un reverse-proxy externe.
  • La gestion de comptes utilisateurs (les professeurs ne voient et ne peuvent agir que sur les sites qu'ils ont eux-mêmes créés).
  • Intégration du protocole HTTPS.
  • Utilisation d'un seul port (qui peut être celui classiquement utilisé pour HTTPS) même si on n'installe pas de Reverse Proxy externe.
  • Installation de l'e-comBox sans intervention de l'administrateur.
  • Déploiement automatisé : exemple de script et de documentation pour un déploiement via Ansible.
  • Gestion optimisée et facilitée des certificats avec un script permettant de générer un certificat avec letsEncrypt.
  • Partage de ses propres modèles de sites : le partage de modèles de sites sera possible directement à partir de l'interface e-comBox après avoir créé un compte sur la plateforme Docker Hub.
  • Récupération d'un modèle de site créé par un utilisateur de la communauté : il sera désormais possible, à partir du nom complet du modèle, de créer un site à partir d'un modèle partagé par un utilisateur de la communauté e-comBox.
  • Actions sur les sites : possibilité de réaliser une action (supprimer, stopper, démarrer) sur plusieurs sites en les sélectionnant.
  • Accès aux identifiants de connexion des différents sites directement à partir de l'interface d'e-comBox.

Les scripts utilisés sont disponibles sur gitlab :https://gitlab.com/e-combox/e-comBox_scriptsLinux.

Les scripts ont été testés sur les versions Linux (obligatoirement 64 bits) suivantes :
  • Ubuntu (à partir la version 18.04) ;
  • Debian 9 ;
  • Debian 10 ;
  • Debian 11 (actuellement stable).

Fonctionnalités de l’e-comBox

MenuDetailleV3.png

L’application e-comBox est une application Web qui permet de lancer et gérer un certain nombre de sites basés sur les applications suivantes :

  • Prestashop :
    • une instance vierge,
    • une instance personnalisée (site Art Concept Stories) ;
  • WordPress avec WooCommerce :
    • une instance vierge,
    • une instance personnalisée (site Art Concept Stories) ;
  • WordPress sans WooCommerce, mais avec le add-in H5P ;
  • Mautic ;
  • Suite CRM ;
  • Odoo :
    • versions 12, 13 et 14,
    • six instances personnalisées : SweetyBio, primeur, surplomb, pépinières, adA et Generik;
  • Kanboard (gestion de projet) :
    • une instance vierge,
    • une instance personnalisée (BdDev) ;
  • HumHub (réseau social).

La gestion de base permet de :

  • lister les types de sites (Wordpress, prestashop, etc.) à partir desquels il est possible de créer un ou plusieurs sites ;
  • créer, démarrer, arrêter ou supprimer un site ;
  • lister les sites créés (avec l’état pour chacun et son URL d’accès au backoffice) ;
  • créer un modèle à partir d'un site créé et personnalisé.

La gestion avancée permet l’accès :

  • SFTP aux sites Prestashop et Wordpress ;
  • via phpMyAdmin aux bases de données des sites Prestashop et Wordpress ;
  • “admin” à l’interface de Portainer ;
  • gérer les modèles de sites créés (visualisation, suppression, récupération et partage).

Quatre types d'installation pour l'e-comBox

L'installation peut se faire sur :

  • un poste de l'établissement ;
  • un serveur de l'établissement ;
  • un serveur dans le cloud ;
  • le poste personnel du professeur.
Pour une installation sur Linux, c'est le serveur qui est sur Linux, l'ordinateur du professeur peut être sur n'importe quel système d'exploitation. Il accède à l'interface de l'e-comBox à distance avec un navigateur.

L'accès via un navigateur à l'interface de l'e-comBox peut évidemment se faire à distance.
Pour des raisons de commodité, il sera fait l’usage de “git” (le script l’installe) pour récupérer des fichiers sur les dépôts officiels gitlab de l’application.

Caractéristiques minimum de la machine

L'application nécessite au minimum :

  • Linux : distribution basée sur Linux 64 bits comme Debian 9/10 ou Ubuntu à partir de la version 18.04 ;
  • la virtualisation activée dans le BIOS (ce qui est fait, en règle générale, par défaut) ;
  • la fonction SLAT supportée au niveau du processeur ;
  • une connexion Internet de qualité ;
  • 8 Go de RAM : plus il y a de RAM, mieux c'est, pour notamment faire démarrer les sites en même temps ;
  • le service Docker avec “docker-compose” (le script se chargent de l’installer) ;


8 Go de RAM est réellement un minimum, il ne faudra pas espérer faire tourner plus de 20 sites en même temps et vous risquez de rencontrer certaines lenteurs.


Pour un serveur Linux devant héberger plusieurs sites pour deux classes de 32 élèves, il est conseillé de disposer d'au minimum 16 Go de RAM.

Ports utilisés

Les ports 8880, 8800 et 5443 sont utilisés par défaut pour l'application elle-même. Ils doivent être libres sur le serveur. Si ce n'est pas le cas, vous devrez spécifier d'autres ports lors de l'installation de la e-comBox. Dans cette version :

  • Si vous n'installez pas de Reverse Proxy externe, par défaut seul le port 8800 est exposé, vous pouvez le fixer à 443 (PORT_RP=443) de manière à ce que l'interface, Portainer et l'ensemble des applications soient accessibles directement (sans précision du port) via https.
  • Si vous installez un Reverse Proxy externe, c'est le port exposé par ce Reverse Proxy qui sera utilisé. Vous pouvez donc laisser les ports par défaut au niveau de l'application.
Récupérée de « https://wiki-ecombox.btssio.corsica/index.php?title=Premiers_pas_-_v4&oldid=818 »