Création de patch Creole

Si le fait de renseigner correctement les options de configuration n'offre pas une souplesse suffisante, il faut envisager des adaptations complémentaires.

Les modules EOLE sont livrés avec un ensemble de templates de fichiers de configuration qui seront copiés vers leur emplacement de destination à chaque instance/reconfigure.

Il est possible de personnaliser ces fichiers de configuration à l'aide d'un patch.

L'outil gen_patch vous permet de générer facilement un nouveau patch. Pour ce faire il suffit de copier le fichier de configuration depuis /usr/share/eole/creole/distrib/ vers /usr/share/eole/creole/modif/, de le modifier et de lancer la commande gen_patch.

Exemple

Copie du fichier du template d'origine :

root@scribe:~# cp /usr/share/eole/creole/distrib/php.ini /usr/share/eole/creole/modif/

Changement des paramètres :

root@scribe:~# vim /usr/share/eole/creole/modif/php.ini

Exécution de la commande gen_patch :

root@scribe:~# gen_patch

** Génération des patches à partir de modif **

Génération du patch php.ini.patch

** Fin de la génération des patch **

root@scribe:~#

Une fois le patch créé, il faut lancer la commande reconfigure pour que les nouvelles options soient prises en compte.

La commande diagnose renvoie un diagnostic sur les patch :

[…]

*** Patches

. patches => Ok

[…]

Attention

Le nom du patch doit impérativement être celui du nom du fichier template à modifier suivi de l'extension .pacth.

Exemple : smb.conf.patch

Remarque

Sont concernés par la procédure de patch uniquement les fichiers déjà présents dans le répertoire des templates et référencés dans les dictionnaires fournis par l'équipe EOLE.

Pour les autres fichiers, l'utilisation de dictionnaires locaux et de templates personnalisés est recommandée.

Le répertoire /usr/share/eole/creole/ contient les répertoires suivants :

  • ./distrib/ : templates originaux fournis principalement par le paquet conf d'un module ;
  • ./modif/ : endroit où doivent être copiés et modifiés les templates souhaités ;
  • ./patch/ : fichiers patch générés à partir des différences entre les deux répertoires précédents.

Le répertoire /var/lib/creole/ comprend les templates finaux, c'est à dire les templates initiaux avec éventuellement des patchs.

Truc & astuce

Pour désactiver un patch, il suffit de supprimer ou de déplacer le fichier patch.

Truc & astuce

Les adaptations que vous pouvez réaliser sur l'un de vos serveurs EOLE sont susceptible d'intéresser d'autres utilisateurs. Elles peuvent faire l'objet d'une intégration dans le projet EOLE par l'équipe de développement.

Les avantages sont multiples :

  • pérennité de vos modifications ;

  • diffusion sur l'ensemble de vos serveurs ;

  • optimisé par l'équipe ;

  • diffuser à tous les utilisateurs.

Aussi n'hésitez pas à proposer votre travail. Pour se faire vous pouvez vous référer à la documentation pour apprendre comment contribuer.