Documentation site aquilenet¶

Le site est propulsé par django mezzanine (python)

Site hébergé sur la vm dédiée hestia.aquilenet.fr
(le git, lui est sur gaia)

Aller sur http://aquilenet.fr et https://aquilenet.fr/jechange pour l'admin

Installation en local pour développement¶

Détail de l'installation : http://mezzanine.jupo.org/docs/overview.html#installation

Requis : python >= 2.7 pip et virtualenv

Créer un environnement virtuel¶

Installer PIP l'apt-get des programmes python

    $ sudo apt-get install python-pip

Un environnement virtuel isole les librairies qui y sont installées du système ainsi les projets partageant les mêmes librairies tournent dans le même environnement.

Installer virtualenv et virtualenvwrapper (pour plus de détails : http://apprendre-python.com/page-virtualenv-python-environnement-virtuel).

    $ sudo apt install virtualenv virtualenvwrapper

Copier ces lignes à la fin de votre .bashrc :

export WORKON_HOME=~/.virenv # Parametrage du répertoire par défaut des environnements virtuels
mkdir -p $WORKON_HOME
    export PS1='\[\033[0;37m\]\u@\h:\[\033[0;33m\]\W\[\033[0m\]\[\033[1;32m\]$(__git_ps1)\[\033[0m\] \$ ' # Pour que le nom de la branche courant dans votre prompt

Installation de mezzanine et de ses dépendances¶

    $ cd ~/.virenv # on se place dans le répertoire des environnements virtuels
    $ virtualenv webaki # créé l'environnement virtuel webaki
    $ workon  webaki # démarrer l'environnement avec la commande workon installée par virtualenvwrapper.
    (webaki)$ #  vous êtes bien dans l'environnement !
    (webaki)$ pip install mezzanine  # installe mezzanine et ses dépendances dans l'environnement webaki

Installation des modules complémentaires qui sont listés dans requirements.txt à la racine du projet

    (webaki)$ pip install django-reversion django-piwik django-simple-captcha git+https://github.com/mjtorn/mezzanine-captcha.git

Installer la version de développement du site¶

Dans le dossier de l'environnement webaki ou ailleurs, l'important est d'être connecté à l'environnement.

Il faut avoir un acces à gaia et appartenir au groupe www-data
Une fois votre compte créé et votre clef ssh opérationelle,
ajouter ceci dans votre ~/.ssh/config :

    Host gitwww
    HostName git.aquilenet.fr
    User votre-compte-sur-gaia
    Port 55555

vous pouvez maintenant cloner le projet :

    (webaki)$ git clone ssh://gitwww:/srv/git/www-git/www_aquilenet.git

Création de la base dev.db du site de développement (fichier sqlite qui est à la racinedu projet git.

    (webaki)$ cd www_aquilenet #accès dans le répertoire du projet
    (webaki)$ python manage.py migrate #migration (création des tables)

pour lancer le site de développement

    (webaki)$ python manage.py runserver #pour démarrer le site

Le site de développement est disponible à http://127.0.0.1:8000/

Importez des données dans dev.db depuis le fichier aquilenet_data_dev.json avec cette commande :

    (webaki)$ python manage.py loaddata aquilenet_data_dev.json

Déploiement vers le serveur¶

Le projet de production est www_aquilenet, le projet de développement est test_aquilenet. Il est conseillé de déployer sur le test (dev.aquilenet.fr) avant de déployer en production.

Se connecter sur le hestia.aquilenet.fr¶

ajouter ceci dans votre ~/.ssh/config :

    Host hestia_web
    Hostname hestia.aquilenet.fr
    User webmaistre
    Port 55555

se connecter :

    $ ssh hestia_web

Activer l'environnement virtuel du projet de test¶

    $ cd /srv/www/webmaistre/.virtualenvs/test_aquilenet
    $ . bin/activate

Dès lors (test_aquilenet) doit commencer votre ligne de commande.

Aller dans le répertoire du projet :

    (test_aquilenet) $ cd /srv/www/test_aquilenet

Récupérer la dernière version du dépôt¶

NOTE : le développeur a créé une nouvelle branche pour développer une évolution, il la "pousse" sur le dépôt, il prévient ses copains qui testent la branche, si tout est OK, il fusionne sa branche dans la branche master et pousse cette dernière vers le dépôt.

    (test_aquilenet) $ git pull

Mise à jour de la base¶

Si des 'models.py' de la nouvelle version ont été changés, ajoutés ou supprimés, il faut migrer ces modifications en faisant :

    (test_aquilenet) $  python manage.py migrate

Les staticfiles¶

Si des css, js ou des images d'interface (logo d'accueil) ont été changés, ajoutés ou supprimés, il faut lancer la commande :

    (test_aquilenet) $  python manage.py collectstatic

Redémarrer le processus¶

    (test_aquilenet) $ sudo supervisorctl update gunicorn_test_aquilenet

Le PID est dans gunicorn.pid, en faisant :

    $ ps -aux | grep test_aquilenet

on doit voir que le processus master a ce PID. Il ne peut y avoir qu'un seul master pour test_aquilenet. Si l'application n'a pas redémarrée (pas de changements visibles), tuer ce processus ($ kill -HUP ) et redémarrer.

Passage en production¶

Si tout ce passe bien, alors on peut faire la même chose en passant à l'environnement de production :

    $ cd /srv/www/webmaistre/.virtualenvs/www_aquilenet
    $ . bin/activate

Dès lors (www_aquilenet) doit commencer votre ligne de commande.

Aller dans le répertoire du projet :

    (www_aquilenet) $ cd /srv/www/www_aquilenet

Puis procéder comme pour le projet de test.

IDE¶

1. vim : https://github.com/bling/dotvim

2. eclipse-pydev (dépôt ubuntu)

3. pycharm : https://www.jetbrains.com/pycharm/

Présentation¶

Pré-requis :

1. connaissance de django : https://docs.djangoproject.com/fr/1.10/

2. connaissance de mezzanine http://mezzanine.jupo.org/

Des tutoriels vidéos sur http://aquilenet.fr/comment-je-change/ (il faut être connecté)

Edition du menu situé en haut à droite¶

Les liens de ce menu sont éditables dans l'admin sous la page "menu annexe en haut à droite"

Tricks¶

Reformater l'image aux préférences de sacha.
Il faut ajourer ceci a la fin de la vue code source :

<p>
<script>// <![CDATA[
document.getElementsByClassName('img-responsive')[0].style['width'] = '200px';
document.getElementsByClassName('img-responsive')[0].style['float'] = 'left';
document.getElementsByClassName('img-responsive')[0].style['margin-right'] = '5%';
// ]]></script>
</p>