Commit 7e09ab3a authored by berumuron's avatar berumuron
Browse files

doc: Improve deployment docs

- explain how to serve on root domain
- put conf files in "available" directories and create symbolic links in
  "enabled" directories
parent 5782349e
......@@ -153,7 +153,7 @@ Si vous souhaitez vous connecter par LDAP, vous n'avez pas besoin de créer
d'utilisateur. Vous pouvez préciser la variable d'environnement
`REFLETS_DATABASE` indiquant un chemin particulier pour votre base de données.
Créez ensuite un fichier de configuration Nginx (ex. `/etc/nginx/sites-enabled/reflets.conf`) :
Créez ensuite un fichier de configuration Nginx (ex. `/etc/nginx/sites-available/reflets.conf`) :
```nginx
server {
......@@ -174,10 +174,21 @@ server {
```
Cette configuration dit à Nginx de transférer toutes les requêtes arrivant à
`http://mon-domaine.net/reflets` sur une socket Unix, `/tmp/reflets.sock`. Il
faut donc maintenant configurer uWSGI qui va mettre cette socket en place.
`http://mon-domaine.net/reflets` sur une socket Unix, `/tmp/reflets.sock`. Si
vous souhaitez servir Reflets à la racine (i.e. `http://mon-domaine.net/`),
remplacez simplement `location /reflets` par `location /`.
Créez un fichier de configuration (ex. `/etc/uwsgi/apps-enabled/reflets.ini`) :
Activez ensuite le fichier de configuration avec la commande suivante :
```console
$ ln -s /etc/nginx/sites-available/reflets.conf /etc/nginx/sites-enabled/reflets.conf
```
Celle-ci crée un lien symbolique vers votre fichier dans le répertoire
`/etc/nginx/sites-enabled`.
Il faut maintenant configurer uWSGI qui va mettre la socket en place. Créez un
fichier de configuration (ex. `/etc/uwsgi/apps-available/reflets.ini`) :
```ini
[uwsgi]
......@@ -207,17 +218,25 @@ Vous devez adapter ce fichier, en particulier les variables d'environnement :
Vous devrez également adapter les chemins de `chdir` et de `home` (c'est cette
dernière qui va permettre de trouver les dépendances installées dans
l'environnement Python).
l'environnement Python). Si vous souhaitez servir Reflets à la racine du nom de
domaine, remplacez la directive `mount` par `mount = /=src:create_app()`.
Vous noterez le chemin vers la socket qui doit évidemment être le même que
celui définit dans la configuration Nginx.
Vous noterez enfin le chemin vers la socket qui doit évidemment être le même
que celui définit dans la configuration Nginx.
Bien sûr, sentez-vous libre d'adapter cette configuration à votre situation et
de compléter les fichiers de configuration avec les options pertinentes (nous
ne souhaitons pas être exhaustifs pour des raisons de clareté).
Une fois ces fichiers écrits, il faut redémarrer les services. Si vous utilisez
systemd, vous devrez lancer en `root` :
Activez ensuite le fichier de configuration avec la commande suivante (même
principe que pour Nginx) :
```console
$ ln -s /etc/uwsgi/apps-available/reflets.ini /etc/uwsgi/apps-enabled/reflets.ini
```
Une fois ces deux fichiers activés, il faut redémarrer les services. Si vous
utilisez systemd, vous devrez lancer en `root` :
```console
# # Vérifiez d'abord que vous n'avez pas fait d'erreur dans la configuration Nginx
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment