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
====================
Documentation à destination d'un administrateur de service pad de Chalec.
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
certificats.
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
```
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
$ createuser <UTILISATEUR>
$ createdb <BDD> -O <UTILISATEUR>
$ createuser pad
$ createdb pad -O pad
$ psql <BDD>
ALTER USER <UTILISATEUR> WITH PASSWORD '<MOTDEPASSE>' ;
ALTER ROLE;
@ -38,17 +40,32 @@ Installer Etherpad-lite
Ajouter l'utilisateur 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
$ 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
=====================
@ -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,
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
==================
Commenter la BDD par défaut :
```
$ cd /homer/etherpad/etherpad-lite
```
Commenter ou supprimer la BDD par défaut :
```
/*
"dbType": "dirty",
@ -76,11 +96,11 @@ Décommentez la section postgres et compléter avec les secrets :
```
"dbType" : "postgres",
"dbSettings" : {
"user": "etherpad",
"user": "pad",
"host": "localhost",
"port": 5432,
"password": "<MOTDEPASSE>",
"database": "etherpad",
"database": "pad",
"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é
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,
```
@ -119,7 +134,7 @@ On personnalise le titre :
"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",
```
@ -165,6 +180,7 @@ Note @todo : cette partie est en travaux et le mécanisme décrit devrait évolu
systemd
Tester le démarrer du service etherpad-lite :
`$ src/bin/run.sh`