Modes lecture seule dans Discourse

Documentation Gestion de site
, ,
1

:bookmark: Ce guide explique les différents modes lecture seule disponibles dans Discourse, comment les activer et les désactiver, et les scénarios dans lesquels vous pourriez vouloir utiliser chaque mode.

:person_raising_hand: Niveau d’utilisateur requis : Administrateur

La gestion d’une communauté en ligne dynamique sur Discourse nécessite parfois aux administrateurs de limiter temporairement les activités des utilisateurs. Ces situations peuvent aller de la maintenance du serveur, à la facilitation des sauvegardes, ou à la transition de serveurs. Pendant ces périodes, il est crucial de restreindre les activités du forum sans pour autant fermer complètement l’accès aux utilisateurs.

Discourse propose différents Modes Lecture Seule que les administrateurs peuvent activer pour figer temporairement différents types d’interactions au sein d’un site.

Ce guide explore ces modes, en se concentrant spécifiquement sur la manière de les activer et de les désactiver, y compris la gestion des situations où certains modes se recoupent.

Comprendre les Modes Lecture Seule

Discourse prend en charge deux niveaux différents de modes Lecture Seule, adaptés à divers besoins administratifs. Il s’agit de :

  1. Mode Lecture Seule Complet

    • Restreint toutes les opérations d’écriture dans le forum, empêchant tout utilisateur de créer ou de modifier du contenu, comme poster, commenter ou aimer.
    • Permet au forum d’être essentiellement “gelé” dans son état actuel, de sorte que les utilisateurs puissent toujours lire et naviguer dans le contenu existant sans impacter la base de données.
    • Désactive la modification des paramètres du site d’administration ou des personnalisations du site afin que l’état actuel de la base de données soit préservé.
    • Désactive les nouvelles connexions au forum.

  2. Mode Écriture Seule pour le Personnel

    • Restreint les utilisateurs standards des opérations d’écriture dans le forum, comme poster, commenter ou aimer. Les utilisateurs standards sont limités aux opérations de lecture seule et ne pourront pas se connecter à leur compte une fois ce mode activé.
    • Permet aux activités des administrateurs et des modérateurs de se poursuivre normalement. Les administrateurs peuvent modifier les paramètres du site, et les utilisateurs du personnel peuvent effectuer des opérations d’écriture comme poster, aimer ou modifier des profils.

Ces modes garantissent la flexibilité dans la gestion de l’opérabilité du forum pendant les périodes administratives critiques.

Comment Activer/Désactiver les Modes Lecture Seule

:warning: Les administrateurs doivent gérer avec soin la transition entre les différents modes lecture seule. Avant d’activer un mode lecture seule, assurez-vous que tout mode précédemment activé est désactivé.

Mode Lecture Seule Complet

Via la Console Rails

Si vous avez accès à votre installation Discourse, utilisez l’interface de ligne de commande Discourse rails pour exécuter la commande suivante après être entré dans votre conteneur Docker avec ./launcher enter app puis dans la console rails avec rails c :

Discourse.enable_readonly_mode(Discourse::USER_READONLY_MODE_KEY)

Via le Panneau d’Administration

Si vous avez un accès administratif via l’interface web, vous pouvez naviguer vers Admin > Sauvegardes > Activer le Mode Lecture Seule pour activer le mode lecture seule.

image
image1971×298 22.3 KB

Pour désactiver le Mode Lecture Seule, exécutez la commande rails suivante :

Discourse.disable_readonly_mode(Discourse::USER_READONLY_MODE_KEY)

Ou, utilisez le panneau d’administration en naviguant vers Admin > Sauvegardes > Désactiver le Mode Lecture Seule.

image
image1956×381 30.5 KB

Mode Écriture Seule pour le Personnel

:discourse: Le mode Écriture Seule pour le Personnel ne peut être activé / désactivé que depuis la console rails de Discourse. Si votre site est hébergé par Discourse, veuillez contacter team@discourse.org si vous souhaitez activer ou désactiver l’un de ces modes.

Pour activer le Mode Écriture Seule pour le Personnel, utilisez la commande suivante dans la console rails :

Discourse.enable_readonly_mode(Discourse::STAFF_WRITES_ONLY_MODE_KEY)

Pour désactiver :

Discourse.disable_readonly_mode(Discourse::STAFF_WRITES_ONLY_MODE_KEY)

Meilleures Pratiques

  • Communication en temps voulu : Informez votre communauté des périodes de lecture seule prévues à l’avance pour définir des attentes appropriées.
  • Tests : Avant de mettre en œuvre ces modes pendant des opérations critiques, effectuez des tests pendant les périodes de faible trafic pour comprendre leur impact.
  • Documentation : Tenez des registres détaillés des moments et des raisons pour lesquels chaque mode a été activé ou désactivé afin d’aider à la planification opérationnelle future.

FAQ

  • Combien de temps faut-il pour activer/désactiver le Mode Lecture Seule ?

    • Le changement est immédiat. Cependant, l’expérience utilisateur peut varier légèrement en fonction de ses actions pendant la période de transition.

  • Au secours ! Je suis bloqué hors de mon site à cause du mode lecture seule - que puis-je faire pour accéder à nouveau à mon site ?

  • J’ai remarqué qu’il y a d’autres modes READ-ONLY listés dans discourse/lib/discourse.rb, que font ces modes ?

    • READONLY_MODE_KEY est principalement utilisé pour le processus de sauvegarde et de restauration et est déclenché par l’application elle-même. Ce mode peut également être activé ou désactivé depuis l’interface de ligne de commande Discourse avec discourse enable_readonly et discourse disable_readonly. Cependant, cette clé ne survivra pas à un redémarrage du conteneur.
    • USER_READONLY_MODE_KEY est utilisé lorsqu’un administrateur clique sur le bouton lecture seule dans l’interface d’administration. La particularité de cette clé est que nous ne la définissons pas comme une clé expirant, car la lecture seule activée par un utilisateur doit survivre aux redémarrages du conteneur. Les autres clés sont définies avec une durée de vie de 60 secondes et nous avons un thread pour prolonger l’expiration toutes les 30 secondes afin de garantir qu’une application ne soit jamais bloquée en mode lecture seule.
    • PG_READONLY_MODE_KEY et PG_FORCE_READONLY_MODE_KEY sont utilisés pour le basculement PG. Le premier est défini comme une clé expirant tandis que le second n’expire pas.
9 « J'aime »
2

Je ne vois pas de différence ! Ces descriptions pourraient-elles être ajustées en conséquence, s’il y a effectivement une différence ?

1 « J'aime »
3

J’ai mis à jour le guide pour apporter des précisions supplémentaires à ce sujet. N’hésitez pas à nous faire savoir si vous avez encore des questions sur les modes lecture seule. :slightly_smiling_face:

1 « J'aime »
4

Mais que fait discourse enable_readonly ?

Il utilise READONLY_MODE_KEY, qui définit ce ttl à 60, donc il se désactive à un moment donné. Maintenant, je vois que

Y a-t-il une raison pour que ce soit le comportement par défaut de cette commande ? Il m’a fallu près d’une décennie pour apprendre que cette commande est totalement différente du mode lecture seule de l’interface web, même après m’être fait avoir plusieurs fois. Et je me souviens maintenant que quelqu’un a essayé de me parler de ces clés une fois et que je n’ai pas réussi à comprendre leur importance.

IMHO, une chose beaucoup plus sensée pour discourse enable_readonly serait de faire un Discourse.enable_readonly_mode(Discourse::STAFF_WRITES_ONLY_MODE_KEY). J’aurais aimé le remarquer il y a de nombreuses années !

Pourrais-je soumettre une PR quelque chose comme ceci :

  desc "enable_readonly", "Activer le mode lecture seule, autorisant les écritures du personnel"
  def staff_writes_only
    load_rails

    Discourse.enable_readonly_mode(Discourse::STAFF_WRITES_ONLY_MODE_KEY)
    puts 'Le site est maintenant en mode lecture seule avec les écritures du personnel autorisées.'
  end
6

Je ne suis pas très familier avec cela, mais je pense que ce serait déroutant que enable_readonly_mode mette le site en mode staff_writes_only_mode. Ce sont des modes différents. Lors de certaines opérations, vous ne voudriez pas que le personnel soit autorisé à écrire dans la base de données (lors d’une restauration, par exemple, ils seront supprimés).

Peut-être pouvons-nous faire quelques autres choses ici :

  1. clarifier que le mode lecture seule définit un TTL dans la description de cette tâche
  2. ajouter une tâche qui invoque keep_readonly_mode afin qu’elle puisse être étendue à plus de 60 minutes
  3. ajouter les tâches enable_staff_writes_only et disable_staff_writes_only
2 « J'aime »
7

Je serais d’accord, mais ce serait beaucoup moins déroutant que “mettre le mode lecture seule pendant un certain temps”.

Je suis à peu près sûr que le script de restauration met lui-même le mode lecture seule, donc il n’est pas affecté par cette commande.

Je préférerais qu’il proclame qu’il est défini pour X minutes lorsqu’il est défini. Il n’est pas si facile de trouver la description.

Peut-être. Je ne suis pas sûr de qui l’utiliserait.

Ce serait génial !

De plus, nous devons être clairs sur le fait que nous ne confondons pas les tâches rake avec les commandes disponibles via la commande discourse.

2 « J'aime »
8

C’est logique. Y a-t-il une chance que vous puissiez soumettre cela sous forme de PR ? Idem pour les commandes enable_staff_writes_only et disable_staff_writes_only, si possible. Merci !

3 « J'aime »
9

Je me demande quelles horloges s’arrêtent après le passage en lecture seule ? Les augmentations de sujets se produiront-elles après le passage en lecture seule ?

10

il semble également que les mises à jour ne fonctionnent pas si le mode lecture seule est activé par l’interface utilisateur web