Ajout des noms d'utilisateurs de BDD dans la doc

This commit is contained in:
Bastien Lacoste 2022-05-16 23:41:17 +02:00 committed by croax
parent d56ba2c2a6
commit e45f003e6c
1 changed files with 35 additions and 19 deletions

View File

@ -1,11 +1,13 @@
Introduction Introduction
==================== ====================
Documentation à destination d'un administrateur de service pad de Chalec. Documentation à destination d'un administrateur de service pad de Chalec.
L'objectif est d'installer un service basé sur le logiciel etherpad-lite. L'objectif est d'installer un service basé sur le logiciel etherpad-lite.
Il sera placé en amont, un service nginx qui gèrera le traffic TLS et ses Il sera placé en amont, un service nginx qui gèrera le traffic TLS et ses
certificats. certificats.
Base de données (BDD) Base de données (BDD)
========= =========
@ -21,11 +23,11 @@ On vérifie que l'on peut se connecter en IP avec vérification du mot de passe
host all all 127.0.0.0/24 md5 host all all 127.0.0.0/24 md5
``` ```
On crée l'utilisateur <UTILISATEUR> avec le mot de passe <MOTDEPASSE>, et la base <BDD> : On crée l'utilisateur "pad" avec le mot de passe <MOTDEPASSE>, et la base "pad" associée à l'utilisateur :
``` ```
# su - postgres # su - postgres
$ createuser <UTILISATEUR> $ createuser pad
$ createdb <BDD> -O <UTILISATEUR> $ createdb pad -O pad
$ psql <BDD> $ psql <BDD>
ALTER USER <UTILISATEUR> WITH PASSWORD '<MOTDEPASSE>' ; ALTER USER <UTILISATEUR> WITH PASSWORD '<MOTDEPASSE>' ;
ALTER ROLE; ALTER ROLE;
@ -38,17 +40,32 @@ Installer Etherpad-lite
Ajouter l'utilisateur etherpad : Ajouter l'utilisateur etherpad :
``` ```
# adduser etherpad # adduser etherpad
# su - etherpad && cd
``` ```
Suivre les recommandations etherpad-lite pour installer sur Debian : On se connecte avec l'utilisateur etherpad
``` ```
# curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash - # su - etherpad
```
Suivre les recommandations de la documentation officielle d'etherpad-lite pour installer sur Debian.
```
$ cd /home/etherpad
$ curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash -
# apt install -y nodejs # apt install -y nodejs
$ git clone --branch master https://github.com/ether/etherpad-lite.git $ git clone --branch master https://github.com/ether/etherpad-lite.git
$ cd etherpad-lite
``` ```
Récupérer les ressoures du pad Chalec
=======================
Cloner le dépot Pad de chalec avec l'utilisateur etherpad
```
$ git clone https://git.a-lec.org/a-lec/commissions/chalec/pad
```
Configuration Etherpad-lite Configuration Etherpad-lite
===================== =====================
@ -59,10 +76,13 @@ celui-ci. Il faudra néanmoins mettre en place les secrets décrits ci-dessous.
Dans le cas contraire, si vous souhaitez conserver votre fichier initial, Dans le cas contraire, si vous souhaitez conserver votre fichier initial,
veuillez suivre pas à pas cette section. veuillez suivre pas à pas cette section.
Les instruction suivantes s'appliquent au fichier settings.json qui se trouve dans le home du user etherpad, dossier etherpad-lite.
Secrets ```
================== $ cd /homer/etherpad/etherpad-lite
Commenter la BDD par défaut : ```
Commenter ou supprimer la BDD par défaut :
``` ```
/* /*
"dbType": "dirty", "dbType": "dirty",
@ -76,11 +96,11 @@ Décommentez la section postgres et compléter avec les secrets :
``` ```
"dbType" : "postgres", "dbType" : "postgres",
"dbSettings" : { "dbSettings" : {
"user": "etherpad", "user": "pad",
"host": "localhost", "host": "localhost",
"port": 5432, "port": 5432,
"password": "<MOTDEPASSE>", "password": "<MOTDEPASSE>",
"database": "etherpad", "database": "pad",
"charset": "utf8mb4" "charset": "utf8mb4"
}, },
``` ```
@ -102,14 +122,9 @@ Dans l'objet json "users", configurer l'admin :
}, },
``` ```
Personnalisation de l'instance
==================
Pour la réalisation des tests et la mise en place du pad, il est fortement conseillé Pour la réalisation des tests et la mise en place du pad, il est fortement conseillé
de régler le paramètre "minify" à false. Dans le cas contraire, le temps de chargement de régler le paramètre "minify" à false. Dans le cas contraire, le temps de chargement
du premier pad peut-être très long. du premier pad peut-être très long. Penser à reactiver ce paramètre si besoin pour réduire le traffic web.
``` ```
"minify": false, "minify": false,
``` ```
@ -119,7 +134,7 @@ On personnalise le titre :
"title": "Pad Chalec", "title": "Pad Chalec",
``` ```
Placer la favicon dans le dossier parent et la référencer : Placer la favicon dans le dossier parent (/home/etherpad) et la référencer :
``` ```
"favicon": "../pad.chalec.org.svg", "favicon": "../pad.chalec.org.svg",
``` ```
@ -165,6 +180,7 @@ Note @todo : cette partie est en travaux et le mécanisme décrit devrait évolu
systemd systemd
Tester le démarrer du service etherpad-lite : Tester le démarrer du service etherpad-lite :
`$ src/bin/run.sh` `$ src/bin/run.sh`