Distribution EOLE » Outils Eole » Outils pour les développeurs » eole-skeletor

h1. Premiers pas

Dans ce documents vous trouverez toutes les étapes pour utiliser le dépôt standard Eole pour le packaging.

L'idée de départ de ce dépôt est de fournir un outil qui vous permet de disposer d'un environement prêt a l'emplois

pour construire un paquet "Eole".

Il suffit de mettre les fichiers dans les bons répertoires.

h2. Le dépôt

Voici l'arboréscence type d'un dépôts "standardisé"

* */src/*

** *<appli>-<version>/*

** *plugins-<version>/nom/*

** *lang-<version>/nom/*

* */tmpl/*

* */dicos/*

* */pretemplate/*

* */posttemplate/*

* */postservice/*

* */sql/*

** *gen/*

** *updates/*

** *conf/*

*** *gen/*

*** *updates/*

*** *pwd/*

* */sso/*

** *filtres/*

** *user-info/*

* */ldap/*

** *pwd/*

* */sharenvole/*

* _Makefile_

* _eole.mk_

* _apps.mk_

Commentaires :

table{border:1px solid black}.

| */src/*                   | _Répertoire a destination des sources de l'application_                                                                                       |

| */src/<appli>-<version>/* | _Code source de l'application avec la possibilité de faire cohabiter plusieurs versions lors des mises à jour_                                |

| */src/plugins-<version>/* | _Répertoire contenant les plugins externes et ceux développés en interne pour cette version de l'application (un sous-répertoire par plugin)_ |

| */src/lang-<version>/*    | _Répertoire des traductions pour cette version (un sous-répertoire par langue)_                                                               |

| */tmpl/*                  | _Répertoire des templates eole_                                                                                                               |

| */dicos/*                 | _Répertoire des dictionnaires eole (XX_<appli>.xml)_                                                                                          |

| */pretemplate/*           | _Répertoire des scripts (shell ou python) de pretemplate_                                                                                     |

| */posttemplate/*          | _Répertoire des scripts (shell ou python) de posttemplate_                                                                                    |

| */postservice/*           | _Répertoire des scripts (shell ou python) de postservice_                                                                                     |

| */sql/*                   | _Répertoire des configurations pour la génération et la gestion des mise à jours des bases de données_                                        |

| */sql/gen/*               | _Répertoire des scripts sql a exécuter lors de la génération de la base de données_                                                           |

| */sql/updates*            | _Répertoire des scripts sql a éxécuter lors de mise à jour de la base de données_                                                             |

| */sql/conf/*              | _Répertoire des configurations pour la gestion de la bases de données_                                                                        |

| */sql/conf/gen*           | _Répertoire du fichier de configuration de génération de la base de données_                                                                  |

| */sql/conf/updates*       | _Répertoire du fichier de configuration des mise à jour de la base de données_                                                                |

| */sql/conf/passwords*     | _Répertoire du fichier de configuration pour la gestion de mots de passes d'accès à la base de données_                                       |

| */sso/*                   | _Répertoire des configurations pour la gestion du SSO_                                                                                        |

| */sso/filtres/*           | _Répertoire des filtres sso (<appli>.ini, <appli>_apps.ini)_                                                                                  |

| */sso/user-info/*         | _Répertoire du profil sso (profil_<appli>.py)_                                                                                                |

| */ldap/*                  | _Répertoire des configurations pour la gestion des mots de passe d'accès au serveur ldap_                                                     |

| */ldap/passwords/*        | _Répertoire du fichier de  configuration du mot de passe ldap (<appli>.ini)_                                                                  |

| */sharenvole/*            | _Répertoire des scripts historiques d'aide à l'installation des applictions envole (à éviter si possible)_                                    |

| Makefile                  | _Fichier de règles de "compilation"_                                                                                                          |

| eole.mk                   | _Règles standard Eole ! ne pas changer ce fichier_                                                                                            |

| apps.mk                   | _Règles pour l'installation de l'application web._                                                                                            |

h2. Etape 1 : Cloner le dépôt

@git clone http://dev-eole.ac-dijon.fr/git/eole-skeletor@

<pre>

Cloning into 'eole-skeletor'...

remote: Counting objects: 83, done.

remote: Compressing objects: 100% (71/71), done.

remote: Total 83 (delta 26), reused 0 (delta 0)

Unpacking objects: 100% (83/83), done.

</pre>

Vous disposez désormais d'un répertoire _eole-skeletor_. 

Ce répertoire contiens un exemple type de dépôt standard.

h2. Etape 2: Créer votre propre dépôt

Lancer les commandes suivantes : 

@mkdir eole-monappli@

@cd eole-monappli@

@git init .@

@cp ../eole-skeletor/*.mk ../eole-skeletor/Makefile .@

@git add .@

@git commit -am "Premier commit : Ajout des fichiers Makefile standard"@

<pre>

</pre>