Table des matières
Ceci est une ancienne révision du document !
Résumé du projet Discourse
Quoi ?
Le but est de rendre les discussions plus agréable que les mails tout en étant plus accessible sur des points lié à la transmission de connaissance (i.e : accès aux archives) que minimaliste.
Le serveur est joignable à l'adresse https://discourse.faimaison.net/
Systèmes affectés (modifiés, supprimés, nouveaux)
- une VM sur l'infra (1 vCPUs, 4 Go de RAM, 35 Go de disque)
Installation et mise en œuvre
- Mise en place d'une VM discourse.faimaison.net (v4,v6) et des enregistrements DNS associés
- Installation sous debian buster.
- Installation standard selon la documentation : https://github.com/discourse/discourse/blob/master/docs/INSTALL-cloud.md
- Installation d'Opensmtpd et dovecot (pop3)
Vie privée
Collecte de données
Une page par défaut avec discourse existe à ce sujet : https://discourse.faimaison.net/privacy
suppression de l'utilisateur
La suppression d'un utilisateur ne peut pas se faire par l'utilisateur lui-même, cela doit passer par un administrateur pour l'instant. À l'avenir, cela pourrait se faire via un appel d'api via COIN.
Aussi, la suppression de l'utilisateur n'est pas tout à fait recommandé pour la continuité des discussions. À la plage, il s'agit d'anonymiser le compte. De cette manière, ce ne sera plus le pseudo de l'utilisateur qui apparait, mais un nom sous la forme anon12345. les échanges sont ainsi préservé sans savoir qui est exactement la personne.
Discourse : administration système
Pour l'administration au quotidien (création de catégorie, modération, etc.). Aller sur la page dédié.
Installation
gestion d'email
géré par opensmtpd et dovecot.
pop3 seulement est utilisé pour la récupération des mail
Pour qu'un groupe ou une catégorie puisse recevoir des mail, il faut éditer le fichier /etc/aliases. mettre le nom qu'on souhaite et le rediriger vers discourse (le fichier /etc/aliases contient de nombreux exemples qui parlent d'eux-même)
Mise à jour
L'interface d'administration va prévenir lorsqu'une mise à jour est disponible. Par défaut, la mise à jour de discourse va entrainer la mise à jour automatique des plugins et des thèmes/composants.
via interface web
Le tableau de bord de l'administrateur a un lien perform upgrade here qui renvoi sur une page et vérifie si des mises à jours sont disponibles.
De là, il suffit de cliquer sur le bouton update all
via ligne de commande
La mise à jour par ligne de commande est une approche alternative mais il arrive que ce soit obligatoire dans certains cas. Un message préviendra lorsque ce sera nécessaire. Dans tous les cas, pour ce faire il faut réaliser les commande suivante. Avec l'utilisateur root :
cd /var/discourse ./launcher rebuild app
Sauvegarde et restoration
Par défaut Discourse réalise ses propres sauvegarde mais les stock en locale dans le répertoire : /var/discourse/shared/standalone/backups/default
.
Le backup se présente comme une tarball. voici un exemple : faimaison-2021-04-03-033134-v20210318020143.tar.gz
Cette tarball contient :
- un dump compressé de la base de donnée.
- tous les fichiers uploadé sur l'instance.
le fichier de configuration ne fait pas parti de la tarball. Il faut le récupérer séparément.
backup pour borg
Comme la tarball compressé n'est pas adapté, borg décompresse l'ensemble dans le répertoire /opt/discourse. Borg récupère également le fichier de configuration app.yml, situé à l'endroit habituel /var/discourse/containers/app.yml
Restoration tarball standard
La restoration par la tarball se fait comme documenté en standard :
il faut d'abord changé le paramètre <paramètre> pour pouvoir uploader la tarball. Puis aller sur la page backup et faire apply.
Restoration par borg
Borg ne fera reconstitué les éléments nécessaire pour reconstruire la tarball.