EnvoleBonnesPratiques » Historique » Version 15
Version 14 (Gérald Schwartzmann, 11/03/2010 11:58) → Version 15/75 (Gérald Schwartzmann, 11/03/2010 12:02)
{{include(ModeleEbauche)}}
h1. Les Bonnes Pratiques
h2. Documentations, sources et articles wiki
Voici "Les bonnes pratiques sur le nommage des applications EOLE":http://eole.orion.education.fr/wiki/index.php/DocumentationDokiel
h2. Git
h3. Placement
Les applications de Envole sont des sous-projets de "Envole":http://dev-eole.ac-dijon.fr/projects/envole .
Dans le dépôt ils apparaissent les un à côté des autres (à plat).
h3. Les Bonnes Pratiques
"Les Bonnes Pratiques":http://dev-eole.ac-dijon.fr/projects/eole-interne/wiki/GitBonnesPratiques
h3. Nommage
Le nom des sous-projets doivent être en minuscule
Exemple dans la liste des sous-projets : http://dev-eole.ac-dijon.fr/projects/envole
h3. Structure du Master
Puisque votre développement n'est pas la branche d'un projet déjà existant on réalise un master.<br />
Pour cela il faut créer selon les besoins de votre application les fichiers et répertoires suivant :
- Makefile
- debian/
- dicos/
- mysql/
- patch/
- sso/
- source_de_votre_appli_num_de_version/
- tmpls/
- etc/
Exemple : http://dev-eole.ac-dijon.fr/projects/dokuwiki/repository
h2. Les fichiers templates
Le nom d'un fichier templétisé ne doit pas porté le même nom qu'un autre pour cela il faut préfixer le nom du fichier avec le nom de l'application.
Exemple du fichier config.php qui est présent dans une bonne partie des applications :
taskfreak_config.php
h2. Dico
h3. Nommage
Les applications du socle
<pre>5x_nom_de_l_application.xml</pre>
Les applications supplémentaires au socle
<pre>6x_nom_de_l_application.xml</pre>
x étant supérieur à 0
h3. construction du fichier
{{include(ModeleFixme)}} {{fixme}}
h2. Paquetage
eole-nom_de_l_application
h2. Apache
h3. nommage du fichier de conf dans sites-enabled
Un fichier de conf apache par application :
<pre>apache-nom_de_l_application.conf</pre>
h3. contenu du fichier de conf dans sites-enabled
{{include(ModeleFixme)}}
h3. les droits dans /var/www/html/
Les droits de /var/www/html/votre_appli<br />
<pre>chmod -R 755 /var/www/html/moodle
chown -R root: /var/www/html/moodle</pre>
Pour des raisons de sécurité seuls les fichiers nécessitant d'être modifiés par l'application appartiennent à l'utilisateur avec lequel est lancé apache à savoir www-data<br />
<pre>chown -R www-data: /var/www/html/moodledata</pre>
h2. Base de données
<pre>scribe-nom_de_l_application.sql</pre>
Si la bdd nécessite une templétisation il est préférable de découper la bdd en deux fichiers MySql.<br />
L'un avec la partie à templétiser et l'autre avec le reste.<br />
Cette découpe fait gagner un temps considérable lors du reconfigure.<br />
h2. {{include(ModeleFixme)}}
Où stocker les données des applications d'Envole ?<br />
exemple Moodle<br />
les données sont pour le moment stockées dans /var/www/<br />
serait-ce mieux dans /home/<br />
sauvegarde de Bacule ?
h1. Les Bonnes Pratiques
h2. Documentations, sources et articles wiki
Voici "Les bonnes pratiques sur le nommage des applications EOLE":http://eole.orion.education.fr/wiki/index.php/DocumentationDokiel
h2. Git
h3. Placement
Les applications de Envole sont des sous-projets de "Envole":http://dev-eole.ac-dijon.fr/projects/envole .
Dans le dépôt ils apparaissent les un à côté des autres (à plat).
h3. Les Bonnes Pratiques
"Les Bonnes Pratiques":http://dev-eole.ac-dijon.fr/projects/eole-interne/wiki/GitBonnesPratiques
h3. Nommage
Le nom des sous-projets doivent être en minuscule
Exemple dans la liste des sous-projets : http://dev-eole.ac-dijon.fr/projects/envole
h3. Structure du Master
Puisque votre développement n'est pas la branche d'un projet déjà existant on réalise un master.<br />
Pour cela il faut créer selon les besoins de votre application les fichiers et répertoires suivant :
- Makefile
- debian/
- dicos/
- mysql/
- patch/
- sso/
- source_de_votre_appli_num_de_version/
- tmpls/
- etc/
Exemple : http://dev-eole.ac-dijon.fr/projects/dokuwiki/repository
h2. Les fichiers templates
Le nom d'un fichier templétisé ne doit pas porté le même nom qu'un autre pour cela il faut préfixer le nom du fichier avec le nom de l'application.
Exemple du fichier config.php qui est présent dans une bonne partie des applications :
taskfreak_config.php
h2. Dico
h3. Nommage
Les applications du socle
<pre>5x_nom_de_l_application.xml</pre>
Les applications supplémentaires au socle
<pre>6x_nom_de_l_application.xml</pre>
x étant supérieur à 0
h3. construction du fichier
{{include(ModeleFixme)}} {{fixme}}
h2. Paquetage
eole-nom_de_l_application
h2. Apache
h3. nommage du fichier de conf dans sites-enabled
Un fichier de conf apache par application :
<pre>apache-nom_de_l_application.conf</pre>
h3. contenu du fichier de conf dans sites-enabled
{{include(ModeleFixme)}}
h3. les droits dans /var/www/html/
Les droits de /var/www/html/votre_appli<br />
<pre>chmod -R 755 /var/www/html/moodle
chown -R root: /var/www/html/moodle</pre>
Pour des raisons de sécurité seuls les fichiers nécessitant d'être modifiés par l'application appartiennent à l'utilisateur avec lequel est lancé apache à savoir www-data<br />
<pre>chown -R www-data: /var/www/html/moodledata</pre>
h2. Base de données
<pre>scribe-nom_de_l_application.sql</pre>
Si la bdd nécessite une templétisation il est préférable de découper la bdd en deux fichiers MySql.<br />
L'un avec la partie à templétiser et l'autre avec le reste.<br />
Cette découpe fait gagner un temps considérable lors du reconfigure.<br />
h2. {{include(ModeleFixme)}}
Où stocker les données des applications d'Envole ?<br />
exemple Moodle<br />
les données sont pour le moment stockées dans /var/www/<br />
serait-ce mieux dans /home/<br />
sauvegarde de Bacule ?