MigrationAppliEnvole4 » Historique » Version 11
Version 10 (Lionel Morin, 02/07/2013 10:16) → Version 11/95 (Lionel Morin, 03/07/2013 16:06)
h1. Migration d'une application Envole vers la version EOLE 2.4 (ébauche)
Pour faciliter le travail de packaging, il est nécessaire de [[eole-skeletor:Doc-geting-started| "skeletoriser"]] le dépot 2.3 pour le [[eole:EoleDebianPackaging24| transformer en dépot 2.4]].
Ensuite, une nouvelle organisation globale des dépots git pour Envole est mise en place et sera commune pour 2.3 et 2.4:
|_.Sources originales |_.Sources modifiées pour Envole |_.Ajouts EOLE |_.Packaging |
|/2=.upstream |/2=.=> sources patchées |/2=.=> master |=> packaging 2.3|
| => packaging 2.4|
* la branche _*upstream*_ ne contient que les sources originales de l'application
* la branche _*sources patchéees*_ contient les sources patchées pour envole (il y a ici possibilité de générer un paquet envole-<nom_appli>)
* la branche _*master*_ est commune en 2.3 et 2.4 (sous réserve de rester compatible) et comporte, en plus des sources, tous les ajouts EOLE (templates, dicos, scripts, sql, password...)
* les branches de *_packaging_*, une par version
h2. Modification des dicos
Normalement il n'y a rien à changer.
h2. Modification des templates
Certaines variables souvent utilisées dans Envole ont changé de nom.
|_.Nom en 2.3 |_.Nouveau nom en 2.4 |
|adresse_ip_annuaire |container_ip_annuaire |
|adresse_ip_fichier |container_ip_fichier |
|adresse_ip_mail |container_ip_mail |
|adresse_ip_mysql |container_ip_mysql |
|adresse_ip_web |container_ip_web |
*=> Ces variables peuvent être rajoutées en 2.4 pour une rétro-compatibilité*
h2. Modification des scripts shell
h3. CreoleGet
<pre>
.ParseDico
echo $mavariable
</pre>
est remplacé par :
<pre>
echo $(CreoleGet mavariable)
</pre>
ATTENTION : à ce jour, pour accéder à une variable esclave, il faut connaître la variable maître :
<pre>
echo $(CreoleGet lamaster.lesclave)
</pre>
*=> Il est possible de tester la présence de ParseDico avant de le lancer (en shell type -p)*
Code à confirmer :
<pre>
if type -p ParseDico &> /dev/null; then
.ParseDico
else
# initialisation des variables utilisées
adresse_ip_br0=$(CreoleGet adresse_ip_br0)
fi
echo $adresse_ip_br0
</pre>
h3. CreoleRun
<pre>
./usr/share/eole/FonctionsEoleNg
RunCmd "ma -commande" conteneur
</pre>
est remplacé par :
<pre>
CreoleRun "ma -commande" conteneur
</pre>
*=> Il est possible d'émuler la commande RunCmd en 2.4*
h2. Problèmes spécifiques
h3. Problème de connexion aux bases MySQL #5633
Pour y remédier temporairement, on peut mettre "localhost" à la place de "127.0.0.1" (penser à la fois aux fichiers sql et aux fichiers de config php).
Pour faciliter le travail de packaging, il est nécessaire de [[eole-skeletor:Doc-geting-started| "skeletoriser"]] le dépot 2.3 pour le [[eole:EoleDebianPackaging24| transformer en dépot 2.4]].
Ensuite, une nouvelle organisation globale des dépots git pour Envole est mise en place et sera commune pour 2.3 et 2.4:
|_.Sources originales |_.Sources modifiées pour Envole |_.Ajouts EOLE |_.Packaging |
|/2=.upstream |/2=.=> sources patchées |/2=.=> master |=> packaging 2.3|
| => packaging 2.4|
* la branche _*upstream*_ ne contient que les sources originales de l'application
* la branche _*sources patchéees*_ contient les sources patchées pour envole (il y a ici possibilité de générer un paquet envole-<nom_appli>)
* la branche _*master*_ est commune en 2.3 et 2.4 (sous réserve de rester compatible) et comporte, en plus des sources, tous les ajouts EOLE (templates, dicos, scripts, sql, password...)
* les branches de *_packaging_*, une par version
h2. Modification des dicos
Normalement il n'y a rien à changer.
h2. Modification des templates
Certaines variables souvent utilisées dans Envole ont changé de nom.
|_.Nom en 2.3 |_.Nouveau nom en 2.4 |
|adresse_ip_annuaire |container_ip_annuaire |
|adresse_ip_fichier |container_ip_fichier |
|adresse_ip_mail |container_ip_mail |
|adresse_ip_mysql |container_ip_mysql |
|adresse_ip_web |container_ip_web |
*=> Ces variables peuvent être rajoutées en 2.4 pour une rétro-compatibilité*
h2. Modification des scripts shell
h3. CreoleGet
<pre>
.ParseDico
echo $mavariable
</pre>
est remplacé par :
<pre>
echo $(CreoleGet mavariable)
</pre>
ATTENTION : à ce jour, pour accéder à une variable esclave, il faut connaître la variable maître :
<pre>
echo $(CreoleGet lamaster.lesclave)
</pre>
*=> Il est possible de tester la présence de ParseDico avant de le lancer (en shell type -p)*
Code à confirmer :
<pre>
if type -p ParseDico &> /dev/null; then
.ParseDico
else
# initialisation des variables utilisées
adresse_ip_br0=$(CreoleGet adresse_ip_br0)
fi
echo $adresse_ip_br0
</pre>
h3. CreoleRun
<pre>
./usr/share/eole/FonctionsEoleNg
RunCmd "ma -commande" conteneur
</pre>
est remplacé par :
<pre>
CreoleRun "ma -commande" conteneur
</pre>
*=> Il est possible d'émuler la commande RunCmd en 2.4*
h2. Problèmes spécifiques
h3. Problème de connexion aux bases MySQL #5633
Pour y remédier temporairement, on peut mettre "localhost" à la place de "127.0.0.1" (penser à la fois aux fichiers sql et aux fichiers de config php).