esup-pod

Arborescence des pages

Comparaison des versions

Ancienne version 1

changes.mady.by.user Franck Charneau

Sauvegardée le

comparé à

Nouvelle version Actuel

changes.mady.by.user Olivier Bado

Sauvegardée le

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.
Commentaire: add 'charset': 'utf8mb4' on mariadb

Sommaire

Base de données MySQL/MariaDB

Installation de MariaDB

Bloc de code
$ sudo apt install mariadb-server mariadb-client
$ sudo mysql_secure_installation

 Attention il faut modifier le fichier /etc/mysql/mariadb.conf.d/50-server.cnf

Bloc de code
character-set-server  = utf8
collation-server      = utf8_general_ci

Vous devez ensuite créer une nouvelle base de données.

Bloc de code
$ sudo mysqladmin create mydatabase

Il faut ensuite donner les droits à cette base à un utilisateur renseigné dans votre fichier de settings ci-après

Bloc de code
$ sudo mysql
mysql> GRANT ALL PRIVILEGES ON mydatabase.* TO 'mydatabaseuser'@127.0.0.1 IDENTIFIED BY 'mypassword';
Query OK, 0 rows affected (0.00 sec)

mysql> exit

Depuis la version 3.3.1 il faut installer le timezone dans le moteur SQL (Mysal ou mariadb) (à faire en tant que root mysql !)

Bloc de code
$ mysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -u root -p mysql --database=mysql

Pour utiliser la base de données MySQL/MariaDB sur le serveur frontal (ou sur un serveur distant) il faut installer le moteur MySql/Python :

Bloc de code
$ sudo apt install pkg-config python3-dev default-libmysqlclient-dev
(django_pod) pod@pod:/usr/local/django_projects/podv3$ pip3 install mysqlclient

Optimisation de MariaDB

Votre configuration doit être adaptée à la taille de votre base de donnée. Pour éviter d'éventuels souci lors des mises à jour, je vous invite à vous assurer que vous avez au minimum 256M pour le paramètre "max_allowed_packet" (voir plus si votre base de données est plus importante. Il faut indiquer la taille de votre plus grosse table)

Bloc de code
title/etc/my.cnf
[mysqld]
max_allowed_packet=256M


Configuration de Pod

Si ce n’est pas encore fait, vous devez spécifier la configuration de votre base de données dans votre fichier de configuration settings_local.py :

Bloc de code
(django_pod) pod@pod:/usr/local/django_projects/podv3$ vim pod/custom/settings_local.py


Bloc de code
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'mydatabase',
        'USER': 'mydatabaseuser',
        'PASSWORD': 'mypassword',
        'HOST': '127.0.0.1',
        'PORT': '3306',
        'OPTIONS': {
            'init_command': "SET storage_engine=INNODB, sql_mode='STRICT_TRANS_TABLES', innodb_strict_mode=1",
			'charset': 'utf8mb4',
         },
    }
}

Il faut ensuite relancer le script présent à la racine afin de créer les fichiers de migration, puis de les lancer afin de créer la base de données :

Bloc de code
(django_pod) pod@Pod:~/django_projects/podv3$ make createDB


Avertissement

Ne pas oublier de créer à nouveau un superutilisateur

(django_pod) pod@Pod:~/django_projects/podv3$ python manage.py createsuperuser

Frontal Web NGINX / UWSGI et fichiers statiques

Pour plus de renseignement, d'explication que la documentation ci-dessous, voici le tutoriel que j'ai suivi pour mettre en place cette solution : doc

Installation du serveur Web NGINX et paramétrage :

Commencer par installer le serveur NGINX

Bloc de code
(django_pod) pod@Pod:~/django_projects/podv3$ sudo apt install nginx

Ensuite, modifier le fichier /etc/nginx/sites-enabled/default

Bloc de code
(django_pod) pod@Pod:~/django_projects/podv3$ sudo vim /etc/nginx/sites-enabled/default

Rechercher la ligne ci-dessous à modifier

Bloc de code
[...]
server { listen 80 default_server;
#listen [::]:80 default_server;
[...]

Installer les addons de NGINX

Bloc de code
(django_pod) pod@Pod:~/django_projects/podv3$ sudo apt install nginx-extras

Rajouter les lignes ci-dessous dans le fichier de configuration de nginx :

Bloc de code
(django_pod) pod@Pod:~/django_projects/podv3$ sudo vim /etc/nginx/nginx.conf


Bloc de code
http {
[...]
     # Pod Progress Bar : reserve 1MB under the name 'uploads' to track uploads 
 upload_progress uploadp 1m;
[...]
}

Il faut ensuite spécifier le host pour le serveur web (changer si besoin les paramètres dans le fichier pod_nginx.conf) :

Bloc de code
(django_pod) pod@Pod:~/django_projects/podv3$ cp pod_nginx.conf pod/custom/.
(django_pod) pod@Pod:~/django_projects/podv3$ vim pod/custom/pod_nginx.conf
(django_pod) pod@Pod:~/django_projects/podv3$ sudo ln -s /usr/local/django_projects/podv3/pod/custom/pod_nginx.conf /etc/nginx/sites-enabled/pod_nginx.conf
(django_pod) pod@Pod:~/django_projects/podv3$ sudo /etc/init.d/nginx restart


UWSGI

Un fichier de configuration est fourni pour faciliter l’usage d'UWSGI.

Installer le module uwsgi

Bloc de code
(django_pod) pod@Pod:~/django_projects/podv3$ sudo pip3 install uwsgi

Dupliquez le fichier modèle et éditez-le pour personnaliser les paramètres :

Bloc de code
(django_pod) pod@Pod:~/django_projects/podv3$ cp pod_uwsgi.ini pod/custom/.
(django_pod) pod@Pod:~/django_projects/podv3$ vim pod/custom/pod_uwsgi.ini
(django_pod) pod@Pod:~/django_projects/podv3$ sudo uwsgi --ini pod/custom/pod_uwsgi.ini --enable-threads --daemonize /usr/local/django_projects/podv3/pod/log/uwsgi-pod.log --uid pod --gid www-data --pidfile /tmp/pod.pid
...
[uWSGI] getting INI configuration from pod/custom/pod_uwsgi.ini
(django_pod) pod@Pod:~/django_projects/podv3$

Pour lancer le service UWSGI au démarrage de la machine :

Créer un fichier uwsgi-pod.service

Bloc de code
(django_pod) pod@Pod:~/django_projects/podv3$ sudo vim /etc/systemd/system/uwsgi-pod.service

Y ajouter :

Bloc de code
[Unit]
Description=Pod uWSGI app
After=syslog.target

[Service]
ExecStart=/usr/local/bin/uwsgi --ini /usr/local/django_projects/podv3/pod/custom/pod_uwsgi.ini \
        --enable-threads \
        --pidfile /tmp/pod.pid
ExecStop=/usr/local/bin/uwsgi --stop /tmp/pod.pid
User=pod
Group=www-data
Restart=on-failure
KillSignal=SIGQUIT
Type=notify
StandardError=syslog
NotifyAccess=all

[Install]
WantedBy=multi-user.target

Il faut ensuite activer le service

Bloc de code
(django_pod) pod@Pod:~/django_projects/podv3$ sudo systemctl enable uwsgi-pod

Pour le lancer ou l’arrêter :

Bloc de code
(django_pod) pod@Pod:~/django_projects/podv3$ sudo systemctl stop uwsgi-pod
(django_pod) pod@Pod:~/django_projects/podv3$ sudo systemctl restart uwsgi-pod


Avertissement

Attention, il faut penser à collecter les fichiers "statics" pour qu'ils soient servis par le frontal web NGINX

Bloc de code
(django_pod) pod@Pod:~/django_projects/podv3$ python manage.py collectstatic



Log Rotate

Les fichiers de log peuvent vite grossir sur un serveur en production. Aussi, je vous invite à mettre en place un système de log rotate pour les logs d'Esup-Pod :

Bloc de code
languagebash
title/etc/logrotate.d/esup-pod
/usr/local/django_projects/podv3/pod/log/*.log {
    su pod www-data
    daily
    missingok
    rotate 14
    nocompress
    delaycompress
    notifempty
    create 0640 pod www-data
    sharedscripts
    postrotate
        systemctl restart uwsgi-pod >/dev/null 2>&1
    endscript
}

Puis lancez la commande suivante pour vérifier que ça fonctionne :

sudo logrotate -d /etc/logrotate.d/esup-pod