Créer une variante

Depuis l'interface web

L'ajout d'une variante se fait depuis le menu modules, en cliquant sur sur variantes sur la ligne du module désiré.

Il faut ensuite cliquer sur ajouter une variante ce qui affiche un formulaire de création.

  • le champ Libellé permet de préciser à quoi se rapporte la variante ;
  • le champ Mot de passe permet à d'autres utilisateurs de modifier cette variante. Si aucun mot de passe n'est défini, seul l'utilisateur ayant créé la variante pourra la modifier ;
  • le champ Identifiant de la variante source (copie) permet de créer la nouvelle variante à partir d'une variante existante.

Une fois la variante créée, elle s'affiche dans la liste des variantes relatives au module. Il est ainsi possible de l'éditer ou de la supprimer.

Depuis un serveur

La procédure de création d'une variante depuis un serveur est la suivante :

  • installation d'un serveur avec le module EOLE (ou utilisation d'un serveur existant) ;

  • enregistrement du serveur sur Zéphir ;

  • création des modifications sur le serveur avec patchs, dictionnaires locaux, ou installation de paquetages supplémentaires. Attention de bien tester les modifications sur le serveur avant de créer une variante ;

  • une fois le résultat désiré obtenu :

    • déplacer les patchs dans /usr/share/eole/creole/patch/variante/ ;
    • les dictionnaires doivent être gérés depuis l'interface Zéphir ;
    • les paquets propres à EOLE qui contiennent des dictionnaires sont à gérer dans la variante dans l'interface Zéphir ;
    • si vous avez ajouté des paquets non EOLE ou des fichiers qui ne sont pas référencés dans des dictionnaires locaux, vous pouvez les spécifier dans le fichier /usr/share/zephir/zephir_conf/fichiers_variante.
  • lancer le script de création de variante /usr/share/zephir/scripts/creation_variante.

    Le mot de passe donné lors de la création de la variante est le mot de passe à donner à d'autres utilisateurs pour qu'ils puissent modifier la variante.

1
root@eolebase:~# /usr/share/zephir/scripts/creation_variante
2
3
** procédure de création de variante ** 
4
5
Attention, les dictionnaires ne sont pas remontés automatiquement sur Zéphir
6
7
Veuillez :
8
- les gérer via la page 'dictionnaires personnalisés' de la distribution 2.5
9
- les activer ensuite dans la variante
10
11
login pour l'application zephir : admin_zephir
12
mot de passe pour admin_zephir : 
13
14
** création d'une variante pour le module 'eolebase-2.5.2' **
15
16
entrez le nom de la nouvelle variante
17
[rien pour la liste des variantes existantes] : Eolebase-sh
18
mot de passe de la variante (ou rien) : 
19
Entrez à nouveau le mot de passe pour vérification :
20
21
22
** mise en place de la variante **
23
 - ajout de la variante dans la base zephir...
24
 - création de l'archive des patchs et dictionnaires locaux...
25
 - création de la signature md5 de l'archive...
26
 - envoi de l'archive au serveur zephir...
27
 - variante créée dans la base avec l'id 112 ...
28
 - inscription du serveur à cette variante...
29
 - vérification de l'archive et mise en place des données...
30
 - suppression de l'archive locale...
31
** installation de la variante terminée **
32
33
root@eolebase:~#

Une fois la procédure terminée, les données de la variante sont stockées sur le serveur Zéphir et le serveur est déclaré comme utilisant cette variante.

ExempleExemple de fichiers fichiers_variante

Pour installer le paquet phpsite, il faut pouvoir récupérer le répertoire /var/www/html/phpsite/conf/ et le fichier /etc/apache/conf/phpsite.conf.

Pour cela, il faut remplir le fichier /usr/share/zephir/zephir_conf/fichiers_variante de la manière suivante :

1
# section 1
2
# liste des fichiers à sauvegarder pour la variante
3
# (ne pas modifier sauf pour créer ou mettre à jour la variante)
4
/var/www/html/phpsite/conf/
5
/etc/apache/conf/phpsite.conf
6
%%
7
# section 2
8
# inscrire les noms des paquetages qui seront installés à la mise à jour du serveur
9
# (ils doivent être présents sur le serveur de mise à jour)
10
# activation des actions
11
phpsite

Remarque

Pour vérifier l'enregistrement de la variante, il faut se rendre sur la page d'État actuel du serveur sur l'application web de Zéphir, la liste des fichiers ajoutés sont visibles depuis le lien voir les fichiers personnalisés et le nom de la variante apparaît sur la page de description du serveur lorsqu'on clique sur Édition du serveur.