Wiki » Historique » Version 18
« Précédent -
Version 18/26
(diff) -
Suivant » -
Version actuelle
Patrice THEBAULT, 10/03/2015 16:20
Principe de fonctionnement¶
Le paquet eole-zephir-medde sert à alimenter le Zephir avec les informations des modules eSBL & eCDL.
Il contient à minima les dictionnaires et les fonctions nécessaires pour pouvoir déclarer un serveur via le frontend Zephir.
Par extension, il peut aussi contenir tous les dictionnaires "hors Eole" nécessaires aux variantes.
! les dictionnaires portés par Eole ne doivent pas figurer dans ce dépôt ! Ce serait fatal à apt !
Arborescence dépôt¶
|_ creole | |_ funcs | |_ creole3 | |_ mesFonctionsPerso.pyCe répertoire sert à stocker l'ensemble des fonctions personnalisées nécessaires à la saisie.
|_ zephir | |_ default_modules | |_ 6 | |_ ecdl-2.4 | |_ esbl-2.4 | |_ 7 | |_ ecdl-2.4.1 | |_ ecdl-2.4.1Les répertoires 6 et 7 servent à stocker les fichiers contenant les informations de dictionnaires nécessaires par module.
Ces chiffres correspondent respectivement aux versions 2.4 & 2.4.1 d'Eole.
Les fichiers doivent être appelés nom_module-release
ex. ecdl-2.4.1
|_ zephir | |_ dictionnaires | |_ 2.4 | |_ eole | |_ eole-ecdl | |_ eole-esbl | |_ 2.4.1 | |_ eole | |_ eole-ecdl | |_ eole-ecdlannuaire | |_ eole-esbl | |_ supervision-psinCes répertoires correspondent aux noms des paquets d'où sont issus les dictionnaires pour le module.
Ils abritent tous les dictionnaires nécessaires au frontend.
Par exemple, le répertoire
| |_ supervision-psincontient
20_psin.xml 49_ocsinventory_agent.xml
Principes d'alimentation¶
L'alimentation peut se faire de deux manières :
1 - outils zephir-parc¶
Le dépôt zephir-parc contient un tas d'outils permettant quasiment d'automatiser la collecte d'informations nécessaires.
Ces outils ne gèrent que les modules et pas les variantes.
Sur un serveur installé, mis à jour de sa version et instancié
git clone https://dev-eole.ac-dijon.fr/git/zephir-parc.git cd zephir-parc/outils
Ce répertoire contient un script shell zephir_dicts.sh qui, lancé sur le module, va générer une archive sous /tmp (Cette opération est donc à répéter sur un serveur de chaque module)
L'archive est organisée de la manière suivante (cas d'un eCDL) :
ecdl-2.4.1.paqs |_ eole | |_ eole-antivirus | |_ eole-client-annuaire | |_ eole-ead-common | |_ eole-ecdl | |_ eole-ecdlannuaire | |_ eole-exim | |_ eole-fichier-common | |_ eole-fichier-primaire | |_ eole-flask | |_ eole-nut | |_ eole-server | |_ eole-userpassword | |_ supervision-psin
fichier nommodule-release
Le fichier ecdl-2.4.1.paqs correspond au fichier nom_module-release vu précédemment et doit être renommé sans l'extension .paqs.
Soit ici ecdl-2.4.1.paqs devient ecdl-2.4.1
De plus, il doit subir une modification nécessaire pour indiquer si le module concerné est en mode conteneur ou pas :
mode non conteneur : ajout de la ligne: eole/eole-zephir-module
mode conteneur : eole/eole-zephir-module-container
Reste alors à le placer au bon endroit sur le dépôt soit ici : eole-zephir-medde/zephir/default_modules/7/ecdl-2.4.1
répertoires de dictionnaires
L'archive se comporte comme l'arborescence du dépôt. On obtient des répertoires qui correspondent à des paquets et contenant des dictionnaires.
Ils devront être ajoutés au dépôt à l'endroit adéquat sous /zephir/dictionnaires/release soit ici : eole-zephir-medde/zephir/dictionnaires/2.4.1/
Rappel : dans le cadre des modules MEDDE traités ici, il faut purger tous les dicos portés par Eole et ne pas les ajouter sous peine de casser apt
2 - Méthode automatique type EN¶
Un script parse l'ensemble des dicos de tous les dépôts et alimente le paquet des dictionnaires zephir EN automatiquement.
Il reste à développer ET tester au MEDDE
3 - A la main ...¶
Pour chaque dépôt à jour concerné, récupérer de chaque branche (2.4, 2.4.1 ...), l'ensemble des dicos en n'oubliant pas de préciser le nom du paquet pour le répertoire.
Ou, à chaque modification de dictionnaire, se poser la question "Et le Zephir dans tout ça ?" et prendre le réflexe d'alimenter ce dépôt systématiquement et correctement.