« E-comBox:Main Page » et « Usage des scripts - v4 » : différence entre les pages

De Documentation e-comBox
(Différence entre les pages)
 
 
Ligne 1 : Ligne 1 :
{{ProjectInfobox
{{note|De nombreux scripts pour gérer l'application sont fournis dans les '''versions 4.1 et 4.2'''. Une brève description pour chacun d'entre eux est donné ci-dessous.|reminder}}
|name = Projet e-comBox
|summary = L’application e-comBox est une application Web, utilisant la technologie des conteneurs Docker, installable uniquement sur Linux pour la version 4.
|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.
{{Note/fr|type=warn|Il est rappelé qu'à partir de la version des scripts 4.1.1 (20/04/2023), tous les "B" majuscule dans les noms de dossier basculent en "b" minuscule, ainsi le dossier d'installation /opt/e-comBox devient /opt/e-combox. C'est ce dernier chemin qui est utilisé ici. Si vous avez une version plus ancienne, le dossier d'installation est /opt/e-comBox.}}
<br>
<br>
''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é.''
<br>
<br>
Des scripts sont fournis pour les systèmes Linux (Debian et Ubuntu) pour installer l'application.


{{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.}}
== Gestion des certificats : manage_certificats.sh ==


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.
{{note | Ce script permet la création et la mise à jour du certificat pour l'accès à l'interface de l'e-comBox et l'ajout de certificats pour Portainer. Des options doivent être passées en ligne de commande (voir Usage ci-après).}}                                                                                   
<br>
<pre>
Usage: bash /opt/e-combox/manage_certificats.sh -c|u [-m "valeur"] [-a] [-h]
  -c Création et mise en place d'un certificat Lets'encrypt
  -u Mise à jour du certificat à partir des paramètres du fichier param.conf
  -m Adresse de courriel  [-m "adresse courriel"], non obligatoire
  -a Installation de la mise à jour automatique du certificat lorsque celui-ci est expiré. Cette option n'a d'utilité qu'une seule fois
  -p    Ajout d'un certificat au format PEM dans Portainer
  -h Détail des options
</pre>
'''L'option "-c"''' automatise la création et l'installation d'un certificat Let's Encrypt directement utilisable pour l'application.


{{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}}
{{note|Votre instance doit être joignable sur le port 80. Attention, vous n'avez pas à installer de serveur Web, le script se charge de tout. L'instance doit juste être en mesure de répondre à une requête de type http://votre_nom_de_domaine (où le nom de domaine est la valeur renseigné dans la paramètre DOMAINE de param.conf). Une redirection peut donc être nécessaire.|warn}}
<br>


'''Une vidéo de présentation est disponible''' : https://www.reseaucerta.org/pgi/e-combox
'''Le script :'''  
<br>
* crée le certificat en utilisant le paramètre "DOMAINE" du param.conf et de manière optionnelle le paramètre MAIL (qui peut être soit renseigné dans param.conf soit directement ajouté via l'option "-m" de la ligne de commande) ;
* copie les fichiers dans /opt/e-combox/letsencrypt/live/<domaine> ;
* renseigne les paramètres correspondants de param.conf :
** CHEMIN_CERT="/opt/e-combox/letsencrypt/live/<domaine>/fullchain.pem"
** CHEMIN_KEY="/opt/e-combox/letsencrypt/live/<domaine>/privkey.pem"
** MAIL (si un mail est passé en ligne de commande) ;
* installe le certificat au niveau de l'application.


{{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]].
'''L'option "-a"''' (que l'on peut activer ultérieurement) met en place une tâche automatique qui vérifie quotidiennement si le certificat a expiré et le met à jour le cas échéant.
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}}


==Nouveautés de la version 4==
'''L'option "-u"''' :
La nouvelle version d'e-comBox est disponible ! Comme chaque incrémentation cette version apporte son lot de nouveautés et d'améliorations.


{{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}}
* met à jour le certificat de l'e-comBox si des valeurs à CHEMIN_CERT et à CHEMIN_KEY sont modifiées, ajoutées ou supprimées ;
* met à jour le certificat de l'e-comBox (si ce type de certificat auto-signé est utilisé) mais aussi d'autres certificats nécessaires qui s'appuient sur les variables CODE_PAYS, NOM_PAYS, NOM_REGION, NOM_ORGANISATION. Ainsi, si au moins une de ces 4 paramètres sont modifiés, il est nécessaire de mettre à jour les certificats.


Les principales nouveautés de cette version sont :
'''L'option "-p"''' ajoute, si besoin, un certificat (donné en option) sur Portainer.
*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.
== Réinitialisation de l'application : reinitialise_application.sh ==
{{note|Ce script permet de réinitialiser l'application.  Des options doivent être passées en ligne de commande (voir Usage ci-après).|}}{{Note/fr|type=error|Attention, tous les sites seront perdus.}}<pre>
Usage: bash /opt/e-combox/reinitialise_application.sh -a -f [-n] [-v "valeur"] [-i "valeur"] [-d "valeur"] [-r "valeur"] [-c "valeur"] [-p "valeur"] [-h]
  -a Suppression de tous les conteneurs, volumes, réseaux et images.
  -f    Force la suppression même si l'accès à Portainer n'est plus possible.
  -n Réinstallation de l'application.
  -v Version de l'application à installer si vous voulez changer de version [-v "version"].
  -i Adresse IP privée nom de domaine correspondant à une adresse IP privée  [-i "@IP_PRIVEE" | -i "nom_domaine"].
  -d Adresse IP publique nom de domaine correspondant à une adresse IP publique  [-d "@IP_PUBLIQUE" | -d "nom_domaine"].
        Pour supprimer une valeur existante -d "".
  -r Passage par un Reverse-Proxy externe ou non  [-r "O" | -r "N"].
  -c Chemin en cas de Reverse-Proxy externe [-c "chemin"].
        Pour supprimer un chemin existant -c "".
  -p Mot de passe de Portainer [-p "mot_de_passe"].
        Les caractères suivants " $ ` \ & | ! [space] ne peuvent pas être utilisés en ligne de commande
  -h Détail des options.
</pre>


{{note | Les scripts ont été testés sur les versions Linux (obligatoirement 64 bits) suivantes :
'''L'option "-a"''' est obligatoire, elle force la suppression des conteneurs, volumes, réseaux et images.
* Ubuntu (à partir la version 18.04) ;
'''L'option "-f"''' peut être utilisée si l'accès à Portainer n'est plus possible.
* Debian 9 ;
* Debian 10 ;
* Debian 11 (actuellement stable). | reminder}}


==Fonctionnalités de l’e-comBox==
L'ajout de '''l'option "-n"''' permet de réinstaller l'application en changeant éventuellement la version via l'option "-v".
[[Fichier:Menu Gauche détaillé v4.png|droite|577x577px]]
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==
Sans l'option "-n", l'application n'est pas réinstallée mais est prête à l'être, l'ancien fichier param.conf sera sauvegardé en param.sauv.conf et un fichier param.conf contenant les valeurs pas défaut sera téléchargé.
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.


==Caractéristiques minimum de la machine==
Dans le cadre d'une réinstallation, '''l'option "-p"''' est obligatoire si un mot de passe pour Portainer n'a pas été renseigné dans le param.conf car, lors de la réinitialisation, les anciens identifiants de Portainer ont également été réinitialisés.
'''L'application nécessite au minimum :'''
{{note | Le mot de passe ne peut pas contenir les caractères " et $.| warn}}
*Linux : distribution basée sur Linux 64 bits comme Debian 9/10 ou Ubuntu à partir de la version 18.04 ;
Les '''autres options''' servent à la réinstallation de l'application pour alimenter le fichier param.conf, options identiques à celles utilisables lors de la configuration de l'application via le script configure_application.sh.
*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) ;


<br>
== Suppression de l'application : delete_application.sh ==
{{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 | Ce script permet de supprimer l'application e-comBox. Une option -e ou -a doit obligatoirement être passée en ligne de commande (voir Usage ci-après).}}
<br/>
<pre>
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}}
Usage: bash /opt/e-combox/delete_application.sh -e | -a -f [-h]
  -e Suppression de l'application uniquement
  -a Suppression de l'application, docker et docker-compose
  -f    Force la suppression même si l'accès à Portainer n'est plus possible
  -h Détail des options
</pre>


==Ports utilisés==
'''L'option "-e"''' supprime uniquement l'application.
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 :
{{note | Attention, le dossier /opt/e-comBox sera supprimé ainsi que les logs.|warn}}
*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.
 
'''L'option "-a"''' supprime également Docker et Docker Compose.
 
== Mise à jour de l'application : update_ecb.sh ==
{{Note/fr|Lorsqu'une nouvelle image de l'e-comBox est disponible, ce script met à jour l'application sans que l'on soit obligé de dérouler le script configure_application.sh.}}
Il est exécutable sans option.
 
== Gestion des images : manage_images.sh ==
{{note|Ce script permet de télécharger, supprimer et mettre à jour les images de l'e-comBox sans être obligé de reconfigurer l'application. Des options doivent être renseignées en ligne de commande (voir Usage ci-après).}}
 
<pre>
Usage: bash /opt/e-combox/manage_images.sh -d|u|t [-a] [-p] [-w] [-b] [-m] [-s] [-o] [-k] [-r] [-i \"nom_image\"] [-f \"nom_image\" | -f \"type_image\"] [- h]"
  -d Suppression des images non associées à un site en cours d'exécution [-d]
  -u Mise à jour des images. Les sites doivent être redémarrés pour la mise à jour soit effective [-u]
  -a L'action porte sur toutes les images existantes.
  -p Suppression ou mise à jour des images Prestashop [-p]
  -w Suppression ou mise à jour des images WooCommerce [-w]
  -b Suppression ou mise à jour des images Blog [-b]
  -m Suppression ou mise à jour des images Mautic [-m]
  -s Suppression ou mise à jour des images Suite CRM [-s]
  -o Suppression ou mise à jour des images Odoo [-o]
  -k Suppression ou mise à jour des images Kanboard [-k]
  -r Suppression ou mise à jour des images HumHub [-r]
  -i Suppression ou mise à jour d'une image spécifique [-i "nom_image"]
  -f Mise à jour d'une image utilitaire [-f "nom_image" | -f "type_image"]
  -t    Téléchargement de toutes les images des sites (utile pour accélérer la création du premier site correspondant aux images) [-t]"
  -h Détail des options
</pre>'''L'opération de suppression d'images''' peut être utile '''si vous devez gagner de la place'''. Certaines images prennent de la place sur le disque dur sans être utilisées. C'est une opération qui peut être salutaire et qui est sans risque, il n'est pas possible de supprimer des images associées à des sites en cours d'exécution. '''Le seul inconvénient est que le démarrage des sites seront peu plus lents car il faudra télécharger de nouveau les images correspondantes.'''
 
'''À contrario, si vous n'avez pas besoin de gain de place,''' il peut être intéressant de télécharger toutes les images (option "-t") avant la première utilisation de l'instance, cela accélérera le lancement du premier site d'un même type.
 
'''La mise à jour de l'image''' peut s'avérer nécessaire si celle-ci a été modifiée suite à un bug ou à une faille de sécurité.
 
== Configuration ou re-configuration de l'intégralité de l'application : configure_application.sh ==
{{note|Ce script doit être utilisé pour :
* installer l'application ;
* re-configurer l'application si des éléments importants de l'environnement ont changé (adresse IP, domaine, passage par un Reverse Proxy externe, passage par un proxy).
Il peut être utilisé avec des options facultatives qui remplacent les valeurs du fichier param.conf.
La valeur des principaux paramètres peut être passée directement en ligne de commande (voir Usage ci-après).}}
<pre>
Usage: bash /opt/e-combox/configure_application.sh [-f "valeur"] [-i "valeur"] [-d "valeur"] [-r "valeur"] [-c "valeur"] [-p "valeur"] [-h]
  -f Chemin vers le fichier de paramètres  [-f "/chemin/nom_fichier"]
  -i Adresse IP privée ou nom de domaine correspondant à une adresse IP privée  [-i "@IP_PRIVEE" | -i "nom_domaine"]
  -d Adresse IP publique ou nom de domaine correspondant à une adresse IP publique  [-d @IP_PUBLIQUE | -d nom_domaine]. Pour supprimer une adresse IP publique ou un domaine existant -d ""
  -r Passage par un Reverse-Proxy externe ou non  [-r "O" | -r "N"]
  -c Chemin en cas de Reverse-Proxy externe [-c "chemin"]. Pour supprimer un chemin existant -c ""
  -p Mot de passe de Portainer  [-p "mot_de_passe"]
        Les caractères suivants " $ ` \ & | ! [space] ne passent pas en ligne de commande
  -s Met la variable de suppression des images à "true" le temps d'exécution du script [-s]
  -b Met la variable de suppression des images à "false" le temps d'exécution du script [-n]
  -h Détail des options
</pre>
 
{{note | lors d'une reconfiguration, si le fichier param.conf est correctement renseigné et que vous n'avez pas changé le mot de passe de Portainer, le script configure_application.sh peut être lancé sans option. | reminder }}
 
Voir également la partie sur [[Installation_sur_Linux_-_v4#Installation_de_l'e-comBox_4.1|l'installation de l'application]].
 
== Configuration de l'authentification openID Connect : configure_oauth.sh (version 4.2) ==
{{Note|Ce script permet de configurer l'authentification OpenId Connect ou de revenir à une authentification interne. Des options doivent être passées en ligne de commande (voir Usage ci-après). Un serveur d'authentification SSO compatible (comme keycloak) doit être installé au préalable.
À noter que l'authentification peut directement être configurer à l'installation ou à la reconfiguration de l'application.}}
<pre>
 
Usage: bash /opt/e-combox/configure_oauth.sh -f [-h]-a|i [-h] [-s] [-j \"CLIENT_ID\"] [-k \"CLIENT_SECRET\"] [-l \"AUTHORIZATION_URL=\"] [-m \"ACCESS_TOKEN_URL=\"] [-n \"RESOURCE_URL=\"] [-o \"LOGOUT_URLL=\"] [-p \"USER_IDENTIFIER=\"] [-q \"SCOPES\"] [-r \"/CHEMIN/CERT_OAUTH\"]
    -a      Activation de l'authentification 0Auth. Dans ce cas les autres paramètres doivent être renseignés soit dans param.conf, soit passés en option à l'exécution du script."
    -i      Activation de l'authentification Interne"
    -s      Activation du SS0"
    -j      Identifiant public de l'application OAuth [-j \"CLIENT_ID\"]"
    -k      Client secret  [-k \"CLIENT_SECRET\"]"
    -l      URL pour s'authentifier auprès du fournisseur OAuth [-l \"AUTHORIZATION_URL=\"]"
    -m      URL pour récupérer le token d'accès [-m \"ACCESS_TOKEN_URL=\"]"
    -n      URL pour récupérer des informations sur l'utilisateur authentifié [-n \"RESOURCE_URL=\"]"
    -o      URL pour rediriger l'utilisateur vers le fournisseur OAuth afin de déconnecter l'utilisateur de la session [-o \"LOGOUT_URL=\"]"
    -p      Identifiant qui sera utilisé par Portainer pour créer un compte pour l'utilisateur authentifié [-p \"USER_IDENTIFIER=\"]"
    -q      Étendues requises par le fournisseur OAuth pour récupérer des informations sur l'utilisateur authentifié [-q \"SCOPES\"]"
    -r      Fichier certificat du fournisseur 0Auth (en cas de besoin)  [-r \"/CHEMIN/CERT_OAUTH\"]"
    -h Détail des options
</pre>
 
'''L'option -a''' active l'authentification "OAuth". Elle a pour effet de mettre le paramètre OAUTH_ENABLE à "true". '''À ce moment là, les paramètres qui suivent dans le param.conf sont pris en compte''' (sinon, ils ne le sont pas). Si les paramètres sont absents de param.conf, il est nécessaire de les passer en ligne de commande.
 
'''L'interface de connexion de l'e-comBox''' est modifiée pour prendre en compte la nouvelle authentification :
[[Fichier:Interface-ecombox-oauth.png|centré|750x750px]]
{{Note/fr|inline=1|type=warn|Seul l'utilisateur "admin" peut maintenant se connecter en interne.}}
'''Un exemple avec les éléments correspondants dans le fichier param.conf est fourni ci-dessous :'''
<pre>
# Ajout du mode d'authentification pour les comptes non-admin basé sur le protocole OAuth (false par défaut).
# Si false, il n'est pas tenu compte des paramètres qui suivent.
# Si true, vous devez fournir la valeur des paramètres qui suivent.
# Veuillez-vous référer à votre fournisseur OAuth pour déterminer les bonnes valeurs.
OAUTH_ENABLE="true"
 
# true ou false
# Lors de l'utilisation de SSO (variable à "true"), le fournisseur OAuth n'est pas obligé de demander des informations d'identification.
SSO_ENABLE="true"
 
# Identifiant public de l'application OAuth.
CLIENT_ID="portainerar"
 
# Client Secret
CLIENT_SECRET="vlaOB3mFrBz6yWgbw5w3NIjNmrBiPbxm"
 
# URL utilisée pour s'authentifier auprès du fournisseur OAuth.
# L'utilisateur sera redirigé vers la page d'authentification du fournisseur d'identité.
AUTHORIZATION_URL="https://keycloak.cub.corsica:8443/realms/cub/protocol/openid-connect/auth"
 
# URL utilisée par Portainer pour échanger un code d'authentification OAuth valide contre un token d'accès.
ACCESS_TOKEN_URL="https://keycloak.cub.corsica:8443/realms/cub/protocol/openid-connect/token"
 
# URL utilisée par Portainer pour récupérer des informations sur l'utilisateur authentifié.
RESOURCE_URL="https://keycloak.cub.corsica:8443/realms/cub/protocol/openid-connect/userinfo"
 
# URL utilisée par Portainer pour rediriger l'utilisateur vers le fournisseur OAuth afin de déconnecter l'utilisateur de la session du fournisseur d'identité.
LOGOUT_URL="https://keycloak.cub.corsica:8443/realms/cub/protocol/openid-connect/logout"
 
# Identifiant qui sera utilisé par Portainer pour créer un compte pour l'utilisateur authentifié.
# Extrait du serveur de ressources spécifié via le champ URL de la ressource.
USER_IDENTIFIER="email"
 
# Étendues requises par le fournisseur OAuth pour récupérer des informations sur l'utilisateur authentifié.
SCOPES="openid email"
 
# Fichier certificat du fournisseur 0Auth avec le chemin complet /chemin/fichier.pem.
# Ce denier doit être intégré à Portainer
CERT_OAUTH="/etc/ssl/letsencrypt/keycloak.cub.corsica.pem"
</pre>{{Note/fr|type=reminder|Le dernier paramètre (CERT_OAUTH) permet d'ajouter le certificat du fournisseur OAuth à Portainer. Il n'est pas forcément indispensable. Cela dépend de la configuration de votre serveur.}}
 
 
Ce qui donne la '''configuration de Portainer''' ci-dessous :
[[Fichier:Conf1 portainer-oauth.png|centré|900x900px]]
 
'''Automatic user provisioning'''  et '''Default team''' sont des paramètres mis par défaut de manière à ce que les utilisateurs qui se connectent soient automatiquement ajoutés sur Portainer dans le groupe "Profs".
{{Note | Si vous avez déjà des utilisateurs internes et que vous voulez que les nouveaux utilisateurs ne viennent pas s'ajouter mais les remplacent (de manière à ne pas avoir de manipulations complémentaires à faire sur les propriétés des sites), il suffit que les premiers aient les mêmes identifiants (à modifier donc éventuellement au préalable). | warn}}
 
[[Fichier:Conf2 portainer-oauth.png|centré|vignette|900x900px]]
 
== Nettoyage des volumes : nettoyage_volumes.sh (version 4.2) ==
{{note|Ce script supprime les volumes qui ne sont associés à aucun site.}}Il arrive que des volumes "orphelins" soient créés. Par exemple, si un site en cours de création n'aboutit pas pour une raison ou une autre. En dehors du fait que les volumes prennent de la place inutilement, cela peut à terme causer un dysfonctionnement lors, par exemple, de la création d'un site du même nom que le site qui n'a pas aboutit.
 
{{note|type=reminder|Ce script est automatiquement lancé à la reconfiguration de l'application.}}.
 
== Réinitialisation du mot de passe de Portainer : reset_pass_portainer.sh ==
{{Note|Ce script permet de réinitialiser, en cas de perte, le mot de passe de Portainer. L'option "-f" doit obligatoirement être passée en ligne de commande (voir Usage ci-après).}}
<pre>
Usage: /opt/e-combox/reset_pass_portainer.sh -f [-h]
-f Réinitialisation du mot de passe de Portainer
-h Détail des options
</pre>
 
{{Note | Vous devez ensuite vous connecter sur Portainer pour modifier le mot de passe fourni afin que ce dernier soit compatible avec l'application. <nowiki>Les caractères suivants " $ ` \ & | ! [space] ne peuvent pas être utilisés en ligne de commande. Si vous saisissez votre mot de passe dans le fichier param.conf, seuls les caractères spéciaux \ " et ` sont interdits</nowiki>. | warn}}
 
== Sauvegarde et Restauration ==
=== sauv_sites.sh (modifié dans la version 4.2) ===
{{note|Ce script permet de sauvegarder l'intégralité des sites dans une archive '''".tar.gz"'''. Des options peuvent être renseignées en ligne de commande (voir Usage ci-après). Si aucune option n'est passée, une boite de dialogue permet de préciser l'espace de stockage et le nom de l'archive.}}
 
'''Fonctionnalités apportées par la version 4.2 :'''
* possibilité de dérouler le script sans interaction ;
* la sauvegarde effectuée permet la restauration de l'intégralité des sites mais également d'un seul site.
 
<pre>
Usage: Usage: bash /opt/e-combox/sauv_sites.sh [-a \"nom_archive.tar.gz\"] [-h].
  -a    Chemin vers l'archive de sauvegarde [-a \"nom_archive.tar.gz\"].
  -h Détail des options
</pre>'''
 
{{note | Le nom de l'archive de sauvegarde doit forcément se terminer en .tar.gz.| warn}}
 
La sauvegarde est composée de l'archive de sauvegarde à laquelle est associé un dossier du nom de l'archive sans le ".tar.gz" qui contient lui-même des fichiers ".json" dans lesquels figurent des informations sur chaque site. Ces fichiers sont nécessaires dans le cadre de la restauration d'un seul site.
 
=== restaure_sites.sh (modifié dans la version 4.2) ===
{{note|Ce script permet de restaurer, à partir d'une archive '''".tar.gz"''' et des dossiers associés, l'intégralité des sites ou un seul site. Des options peuvent être renseignées en ligne de commande (voir Usage ci-après). Si l'option -r n'est pas passée, c'est l'intégralité des sites qui sont restaurés et une boite de dialogue permet de préciser l'espace de stockage et le nom de l'archive (au cas où l'option -a ne le précise pas).}}
 
 
'''Fonctionnalités apportées par la version 4.2 :'''
* possibilité de dérouler le script sans interaction ;
* possibilité de ne restaurer qu'un seul site.
 
<pre>
Usage: Usage: bash /opt/e-combox/restaure_sites.sh -f|r \"nom du site\" [-h] [-s] [-a \"chemin_complet_archive_sauvegarde.tar.gz\"]"
  -f    Restauration de l'intégralité des sites.
  -r    Restauration d'un seul site [-r \"nom du site\"].
  -a    Chemin vers l'archive de sauvegarde [-a \"chemin_complet_archive_sauvegarde.tar.gz\"]". Si le chemin est fourni le script se déroulera sans interactivité. 
  -h Détail des options
</pre>'''
 
=== restaure_v3.sh ===
{{note|Ce script permet de restaurer, à partir d'une archive '''".tar.gz"''' la version v3 de l'e-comBox ainsi que les sites qui y étaient ratachés.}}
 
Le script ne prend aucun paramètre en ligne de commande.
 
== Utilisation d'Ansible (en cours de rédaction...) ==

Version du 31 juillet 2023 à 23:07

De nombreux scripts pour gérer l'application sont fournis dans les versions 4.1 et 4.2. Une brève description pour chacun d'entre eux est donné ci-dessous.
Il est rappelé qu'à partir de la version des scripts 4.1.1 (20/04/2023), tous les "B" majuscule dans les noms de dossier basculent en "b" minuscule, ainsi le dossier d'installation /opt/e-comBox devient /opt/e-combox. C'est ce dernier chemin qui est utilisé ici. Si vous avez une version plus ancienne, le dossier d'installation est /opt/e-comBox.

Gestion des certificats : manage_certificats.sh

Ce script permet la création et la mise à jour du certificat pour l'accès à l'interface de l'e-comBox et l'ajout de certificats pour Portainer. Des options doivent être passées en ligne de commande (voir Usage ci-après).
Usage: bash /opt/e-combox/manage_certificats.sh -c|u [-m "valeur"] [-a] [-h]
  -c	Création et mise en place d'un certificat Lets'encrypt
  -u	Mise à jour du certificat à partir des paramètres du fichier param.conf
  -m	Adresse de courriel  [-m "adresse courriel"], non obligatoire
  -a	Installation de la mise à jour automatique du certificat lorsque celui-ci est expiré. Cette option n'a d'utilité qu'une seule fois
  -p    Ajout d'un certificat au format PEM dans Portainer
  -h	Détail des options

L'option "-c" automatise la création et l'installation d'un certificat Let's Encrypt directement utilisable pour l'application.

Votre instance doit être joignable sur le port 80. Attention, vous n'avez pas à installer de serveur Web, le script se charge de tout. L'instance doit juste être en mesure de répondre à une requête de type http://votre_nom_de_domaine (où le nom de domaine est la valeur renseigné dans la paramètre DOMAINE de param.conf). Une redirection peut donc être nécessaire.

Le script :

  • crée le certificat en utilisant le paramètre "DOMAINE" du param.conf et de manière optionnelle le paramètre MAIL (qui peut être soit renseigné dans param.conf soit directement ajouté via l'option "-m" de la ligne de commande) ;
  • copie les fichiers dans /opt/e-combox/letsencrypt/live/<domaine> ;
  • renseigne les paramètres correspondants de param.conf :
    • CHEMIN_CERT="/opt/e-combox/letsencrypt/live/<domaine>/fullchain.pem"
    • CHEMIN_KEY="/opt/e-combox/letsencrypt/live/<domaine>/privkey.pem"
    • MAIL (si un mail est passé en ligne de commande) ;
  • installe le certificat au niveau de l'application.

L'option "-a" (que l'on peut activer ultérieurement) met en place une tâche automatique qui vérifie quotidiennement si le certificat a expiré et le met à jour le cas échéant.

L'option "-u" :

  • met à jour le certificat de l'e-comBox si des valeurs à CHEMIN_CERT et à CHEMIN_KEY sont modifiées, ajoutées ou supprimées ;
  • met à jour le certificat de l'e-comBox (si ce type de certificat auto-signé est utilisé) mais aussi d'autres certificats nécessaires qui s'appuient sur les variables CODE_PAYS, NOM_PAYS, NOM_REGION, NOM_ORGANISATION. Ainsi, si au moins une de ces 4 paramètres sont modifiés, il est nécessaire de mettre à jour les certificats.

L'option "-p" ajoute, si besoin, un certificat (donné en option) sur Portainer.

Réinitialisation de l'application : reinitialise_application.sh

Ce script permet de réinitialiser l'application. Des options doivent être passées en ligne de commande (voir Usage ci-après).
Attention, tous les sites seront perdus.
Usage: bash /opt/e-combox/reinitialise_application.sh -a -f [-n] [-v "valeur"] [-i "valeur"] [-d "valeur"] [-r "valeur"] [-c "valeur"] [-p "valeur"] [-h]
  -a	Suppression de tous les conteneurs, volumes, réseaux et images.
  -f    Force la suppression même si l'accès à Portainer n'est plus possible.
  -n	Réinstallation de l'application.
  -v	Version de l'application à installer si vous voulez changer de version [-v "version"].
  -i	Adresse IP privée nom de domaine correspondant à une adresse IP privée  [-i "@IP_PRIVEE" | -i "nom_domaine"].
  -d	Adresse IP publique nom de domaine correspondant à une adresse IP publique  [-d "@IP_PUBLIQUE" | -d "nom_domaine"]. 
        Pour supprimer une valeur existante -d "".
  -r	Passage par un Reverse-Proxy externe ou non  [-r "O" | -r "N"].
  -c	Chemin en cas de Reverse-Proxy externe [-c "chemin"]. 
        Pour supprimer un chemin existant -c "".
  -p	Mot de passe de Portainer [-p "mot_de_passe"].
        Les caractères suivants " $ ` \ & | ! [space] ne peuvent pas être utilisés en ligne de commande
  -h	Détail des options.

L'option "-a" est obligatoire, elle force la suppression des conteneurs, volumes, réseaux et images. L'option "-f" peut être utilisée si l'accès à Portainer n'est plus possible.

L'ajout de l'option "-n" permet de réinstaller l'application en changeant éventuellement la version via l'option "-v".

Sans l'option "-n", l'application n'est pas réinstallée mais est prête à l'être, l'ancien fichier param.conf sera sauvegardé en param.sauv.conf et un fichier param.conf contenant les valeurs pas défaut sera téléchargé.

Dans le cadre d'une réinstallation, l'option "-p" est obligatoire si un mot de passe pour Portainer n'a pas été renseigné dans le param.conf car, lors de la réinitialisation, les anciens identifiants de Portainer ont également été réinitialisés.

Le mot de passe ne peut pas contenir les caractères " et $.

Les autres options servent à la réinstallation de l'application pour alimenter le fichier param.conf, options identiques à celles utilisables lors de la configuration de l'application via le script configure_application.sh.

Suppression de l'application : delete_application.sh

Ce script permet de supprimer l'application e-comBox. Une option -e ou -a doit obligatoirement être passée en ligne de commande (voir Usage ci-après).
Usage: bash /opt/e-combox/delete_application.sh -e | -a -f [-h]
  -e	Suppression de l'application uniquement
  -a	Suppression de l'application, docker et docker-compose
  -f    Force la suppression même si l'accès à Portainer n'est plus possible
  -h	Détail des options

L'option "-e" supprime uniquement l'application.

Attention, le dossier /opt/e-comBox sera supprimé ainsi que les logs.


L'option "-a" supprime également Docker et Docker Compose.

Mise à jour de l'application : update_ecb.sh

Lorsqu'une nouvelle image de l'e-comBox est disponible, ce script met à jour l'application sans que l'on soit obligé de dérouler le script configure_application.sh.

Il est exécutable sans option.

Gestion des images : manage_images.sh

Ce script permet de télécharger, supprimer et mettre à jour les images de l'e-comBox sans être obligé de reconfigurer l'application. Des options doivent être renseignées en ligne de commande (voir Usage ci-après).
Usage: bash /opt/e-combox/manage_images.sh -d|u|t [-a] [-p] [-w] [-b] [-m] [-s] [-o] [-k] [-r] [-i \"nom_image\"] [-f \"nom_image\" | -f \"type_image\"] [- h]"
  -d	Suppression des images non associées à un site en cours d'exécution [-d]
  -u	Mise à jour des images. Les sites doivent être redémarrés pour la mise à jour soit effective [-u]
  -a	L'action porte sur toutes les images existantes.
  -p	Suppression ou mise à jour des images Prestashop [-p]
  -w	Suppression ou mise à jour des images WooCommerce [-w]
  -b	Suppression ou mise à jour des images Blog [-b]
  -m	Suppression ou mise à jour des images Mautic [-m]
  -s	Suppression ou mise à jour des images Suite CRM [-s]
  -o	Suppression ou mise à jour des images Odoo [-o]
  -k	Suppression ou mise à jour des images Kanboard [-k]
  -r	Suppression ou mise à jour des images HumHub [-r]
  -i	Suppression ou mise à jour d'une image spécifique [-i "nom_image"]
  -f	Mise à jour d'une image utilitaire [-f "nom_image" | -f "type_image"]
  -t    Téléchargement de toutes les images des sites (utile pour accélérer la création du premier site correspondant aux images) [-t]"
  -h	Détail des options

L'opération de suppression d'images peut être utile si vous devez gagner de la place. Certaines images prennent de la place sur le disque dur sans être utilisées. C'est une opération qui peut être salutaire et qui est sans risque, il n'est pas possible de supprimer des images associées à des sites en cours d'exécution. Le seul inconvénient est que le démarrage des sites seront peu plus lents car il faudra télécharger de nouveau les images correspondantes.

À contrario, si vous n'avez pas besoin de gain de place, il peut être intéressant de télécharger toutes les images (option "-t") avant la première utilisation de l'instance, cela accélérera le lancement du premier site d'un même type.

La mise à jour de l'image peut s'avérer nécessaire si celle-ci a été modifiée suite à un bug ou à une faille de sécurité.

Configuration ou re-configuration de l'intégralité de l'application : configure_application.sh

Ce script doit être utilisé pour :
  • installer l'application ;
  • re-configurer l'application si des éléments importants de l'environnement ont changé (adresse IP, domaine, passage par un Reverse Proxy externe, passage par un proxy).

Il peut être utilisé avec des options facultatives qui remplacent les valeurs du fichier param.conf.

La valeur des principaux paramètres peut être passée directement en ligne de commande (voir Usage ci-après).
Usage: bash /opt/e-combox/configure_application.sh [-f "valeur"] [-i "valeur"] [-d "valeur"] [-r "valeur"] [-c "valeur"] [-p "valeur"] [-h]
  -f	Chemin vers le fichier de paramètres  [-f "/chemin/nom_fichier"]
  -i	Adresse IP privée ou nom de domaine correspondant à une adresse IP privée  [-i "@IP_PRIVEE" | -i "nom_domaine"]
  -d	Adresse IP publique ou nom de domaine correspondant à une adresse IP publique  [-d @IP_PUBLIQUE | -d nom_domaine]. Pour supprimer une adresse IP publique ou un domaine existant -d ""
  -r	Passage par un Reverse-Proxy externe ou non  [-r "O" | -r "N"]
  -c	Chemin en cas de Reverse-Proxy externe [-c "chemin"]. Pour supprimer un chemin existant -c ""
  -p	Mot de passe de Portainer  [-p "mot_de_passe"]
        Les caractères suivants " $ ` \ & | ! [space] ne passent pas en ligne de commande
  -s	Met la variable de suppression des images à "true" le temps d'exécution du script [-s]
  -b	Met la variable de suppression des images à "false" le temps d'exécution du script [-n]
  -h	Détail des options
lors d'une reconfiguration, si le fichier param.conf est correctement renseigné et que vous n'avez pas changé le mot de passe de Portainer, le script configure_application.sh peut être lancé sans option.

Voir également la partie sur l'installation de l'application.

Configuration de l'authentification openID Connect : configure_oauth.sh (version 4.2)

Ce script permet de configurer l'authentification OpenId Connect ou de revenir à une authentification interne. Des options doivent être passées en ligne de commande (voir Usage ci-après). Un serveur d'authentification SSO compatible (comme keycloak) doit être installé au préalable. À noter que l'authentification peut directement être configurer à l'installation ou à la reconfiguration de l'application.

Usage: bash /opt/e-combox/configure_oauth.sh -f [-h]-a|i [-h] [-s] [-j \"CLIENT_ID\"] [-k \"CLIENT_SECRET\"] [-l \"AUTHORIZATION_URL=\"] [-m \"ACCESS_TOKEN_URL=\"] [-n \"RESOURCE_URL=\"] [-o \"LOGOUT_URLL=\"] [-p \"USER_IDENTIFIER=\"] [-q \"SCOPES\"] [-r \"/CHEMIN/CERT_OAUTH\"]
    -a      Activation de l'authentification 0Auth. Dans ce cas les autres paramètres doivent être renseignés soit dans param.conf, soit passés en option à l'exécution du script."
    -i      Activation de l'authentification Interne"
    -s      Activation du SS0"
    -j      Identifiant public de l'application OAuth [-j \"CLIENT_ID\"]"
    -k      Client secret  [-k \"CLIENT_SECRET\"]"
    -l      URL pour s'authentifier auprès du fournisseur OAuth [-l \"AUTHORIZATION_URL=\"]"
    -m      URL pour récupérer le token d'accès [-m \"ACCESS_TOKEN_URL=\"]"
    -n      URL pour récupérer des informations sur l'utilisateur authentifié [-n \"RESOURCE_URL=\"]"
    -o      URL pour rediriger l'utilisateur vers le fournisseur OAuth afin de déconnecter l'utilisateur de la session [-o \"LOGOUT_URL=\"]"
    -p      Identifiant qui sera utilisé par Portainer pour créer un compte pour l'utilisateur authentifié [-p \"USER_IDENTIFIER=\"]"
    -q      Étendues requises par le fournisseur OAuth pour récupérer des informations sur l'utilisateur authentifié [-q \"SCOPES\"]"
    -r      Fichier certificat du fournisseur 0Auth (en cas de besoin)  [-r \"/CHEMIN/CERT_OAUTH\"]"
    -h		Détail des options

L'option -a active l'authentification "OAuth". Elle a pour effet de mettre le paramètre OAUTH_ENABLE à "true". À ce moment là, les paramètres qui suivent dans le param.conf sont pris en compte (sinon, ils ne le sont pas). Si les paramètres sont absents de param.conf, il est nécessaire de les passer en ligne de commande.

L'interface de connexion de l'e-comBox est modifiée pour prendre en compte la nouvelle authentification :

Interface-ecombox-oauth.png
Seul l'utilisateur "admin" peut maintenant se connecter en interne.

Un exemple avec les éléments correspondants dans le fichier param.conf est fourni ci-dessous :

# Ajout du mode d'authentification pour les comptes non-admin basé sur le protocole OAuth (false par défaut).
# Si false, il n'est pas tenu compte des paramètres qui suivent.
# Si true, vous devez fournir la valeur des paramètres qui suivent.
# Veuillez-vous référer à votre fournisseur OAuth pour déterminer les bonnes valeurs.
OAUTH_ENABLE="true"

# true ou false
# Lors de l'utilisation de SSO (variable à "true"), le fournisseur OAuth n'est pas obligé de demander des informations d'identification.
SSO_ENABLE="true"

# Identifiant public de l'application OAuth.
CLIENT_ID="portainerar"

# Client Secret
CLIENT_SECRET="vlaOB3mFrBz6yWgbw5w3NIjNmrBiPbxm"

# URL utilisée pour s'authentifier auprès du fournisseur OAuth.
# L'utilisateur sera redirigé vers la page d'authentification du fournisseur d'identité.
AUTHORIZATION_URL="https://keycloak.cub.corsica:8443/realms/cub/protocol/openid-connect/auth"

# URL utilisée par Portainer pour échanger un code d'authentification OAuth valide contre un token d'accès.
ACCESS_TOKEN_URL="https://keycloak.cub.corsica:8443/realms/cub/protocol/openid-connect/token"

# URL utilisée par Portainer pour récupérer des informations sur l'utilisateur authentifié.
RESOURCE_URL="https://keycloak.cub.corsica:8443/realms/cub/protocol/openid-connect/userinfo"

# URL utilisée par Portainer pour rediriger l'utilisateur vers le fournisseur OAuth afin de déconnecter l'utilisateur de la session du fournisseur d'identité.
LOGOUT_URL="https://keycloak.cub.corsica:8443/realms/cub/protocol/openid-connect/logout"

# Identifiant qui sera utilisé par Portainer pour créer un compte pour l'utilisateur authentifié. 
# Extrait du serveur de ressources spécifié via le champ URL de la ressource.
USER_IDENTIFIER="email"

# Étendues requises par le fournisseur OAuth pour récupérer des informations sur l'utilisateur authentifié.
SCOPES="openid email"

# Fichier certificat du fournisseur 0Auth avec le chemin complet /chemin/fichier.pem.
# Ce denier doit être intégré à Portainer
CERT_OAUTH="/etc/ssl/letsencrypt/keycloak.cub.corsica.pem"
Le dernier paramètre (CERT_OAUTH) permet d'ajouter le certificat du fournisseur OAuth à Portainer. Il n'est pas forcément indispensable. Cela dépend de la configuration de votre serveur.


Ce qui donne la configuration de Portainer ci-dessous :

Conf1 portainer-oauth.png

Automatic user provisioning et Default team sont des paramètres mis par défaut de manière à ce que les utilisateurs qui se connectent soient automatiquement ajoutés sur Portainer dans le groupe "Profs".

Si vous avez déjà des utilisateurs internes et que vous voulez que les nouveaux utilisateurs ne viennent pas s'ajouter mais les remplacent (de manière à ne pas avoir de manipulations complémentaires à faire sur les propriétés des sites), il suffit que les premiers aient les mêmes identifiants (à modifier donc éventuellement au préalable).
Conf2 portainer-oauth.png

Nettoyage des volumes : nettoyage_volumes.sh (version 4.2)

Ce script supprime les volumes qui ne sont associés à aucun site.

Il arrive que des volumes "orphelins" soient créés. Par exemple, si un site en cours de création n'aboutit pas pour une raison ou une autre. En dehors du fait que les volumes prennent de la place inutilement, cela peut à terme causer un dysfonctionnement lors, par exemple, de la création d'un site du même nom que le site qui n'a pas aboutit.

Ce script est automatiquement lancé à la reconfiguration de l'application.

.

Réinitialisation du mot de passe de Portainer : reset_pass_portainer.sh

Ce script permet de réinitialiser, en cas de perte, le mot de passe de Portainer. L'option "-f" doit obligatoirement être passée en ligne de commande (voir Usage ci-après).
Usage: /opt/e-combox/reset_pass_portainer.sh -f [-h]
	-f		Réinitialisation du mot de passe de Portainer
	-h		Détail des options
Vous devez ensuite vous connecter sur Portainer pour modifier le mot de passe fourni afin que ce dernier soit compatible avec l'application. Les caractères suivants " $ ` \ & | ! [space] ne peuvent pas être utilisés en ligne de commande. Si vous saisissez votre mot de passe dans le fichier param.conf, seuls les caractères spéciaux \ " et ` sont interdits.

Sauvegarde et Restauration

sauv_sites.sh (modifié dans la version 4.2)

Ce script permet de sauvegarder l'intégralité des sites dans une archive ".tar.gz". Des options peuvent être renseignées en ligne de commande (voir Usage ci-après). Si aucune option n'est passée, une boite de dialogue permet de préciser l'espace de stockage et le nom de l'archive.

Fonctionnalités apportées par la version 4.2 :

  • possibilité de dérouler le script sans interaction ;
  • la sauvegarde effectuée permet la restauration de l'intégralité des sites mais également d'un seul site.
Usage: Usage: bash /opt/e-combox/sauv_sites.sh [-a \"nom_archive.tar.gz\"] [-h].
  -a    Chemin vers l'archive de sauvegarde [-a \"nom_archive.tar.gz\"].
  -h	Détail des options

Le nom de l'archive de sauvegarde doit forcément se terminer en .tar.gz.

La sauvegarde est composée de l'archive de sauvegarde à laquelle est associé un dossier du nom de l'archive sans le ".tar.gz" qui contient lui-même des fichiers ".json" dans lesquels figurent des informations sur chaque site. Ces fichiers sont nécessaires dans le cadre de la restauration d'un seul site.

restaure_sites.sh (modifié dans la version 4.2)

Ce script permet de restaurer, à partir d'une archive ".tar.gz" et des dossiers associés, l'intégralité des sites ou un seul site. Des options peuvent être renseignées en ligne de commande (voir Usage ci-après). Si l'option -r n'est pas passée, c'est l'intégralité des sites qui sont restaurés et une boite de dialogue permet de préciser l'espace de stockage et le nom de l'archive (au cas où l'option -a ne le précise pas).


Fonctionnalités apportées par la version 4.2 :

  • possibilité de dérouler le script sans interaction ;
  • possibilité de ne restaurer qu'un seul site.
Usage: Usage: bash /opt/e-combox/restaure_sites.sh -f|r \"nom du site\" [-h] [-s] [-a \"chemin_complet_archive_sauvegarde.tar.gz\"]"
  -f    Restauration de l'intégralité des sites.
  -r    Restauration d'un seul site [-r \"nom du site\"].
  -a    Chemin vers l'archive de sauvegarde [-a \"chemin_complet_archive_sauvegarde.tar.gz\"]". Si le chemin est fourni le script se déroulera sans interactivité.   
  -h	Détail des options

restaure_v3.sh

Ce script permet de restaurer, à partir d'une archive ".tar.gz" la version v3 de l'e-comBox ainsi que les sites qui y étaient ratachés.

Le script ne prend aucun paramètre en ligne de commande.

Utilisation d'Ansible (en cours de rédaction...)