FastComments On Prem vous permet de déployer notre solution de commentaires en direct, y compris tous les outils de modération et d'administration, sur votre propre matériel.

Cela signifie que vous avez le contrôle de vos données, et que le système de commentaires peut être restreint à votre réseau local (LAN) ou réseau d'entreprise.

Composants requis

Pour On-Prem, FastComments se compose simplement d'un serveur d'application et d'une base de données. Nous avons simplifié le déploiement afin que l'application puisse servir tout le trafic directement sans ajouter d'autres composants.

Le serveur d'application est fourni dans une image Docker et peut être déployé avec n'importe quelle solution de gestion de conteneurs.

La base de données, MongoDB, peut être auto-hébergée ou hébergée par un autre fournisseur comme AWS DocumentDB ou MongoDB Atlas.

FastComments est actuellement testé avec MongoDB 7, toutefois nous visons la compatibilité avec DocumentDB pour faciliter le déploiement.

Tailles des instances

Vous verrez que FastComments est assez bien optimisé et ne nécessite pas de machines puissantes pour l'application elle-même afin de maintenir des P99 faibles.

Toutes les tâches par lot et les cron jobs utilisent le streaming pour limiter l'utilisation totale de mémoire.

Les tableaux ci‑dessous pour le serveur d'application et la base de données peuvent aider au dimensionnement.

Instances du serveur d'application

Par exemple, un seul cœur servant environ 100 fils de discussion de commentaires par seconde n'utilise généralement jamais plus de 250mb RSS.

Instances du serveur de base de données

Le dimensionnement de la base de données dépend de la taille du working set, qui est la quantité de données auxquelles vous accédez à un moment donné, ainsi que des requêtes simultanées.

FastComments est assez conciliant avec Mongo : pour les requêtes chaudes il utilise des index hints, des streaming cursors, et applique des limites de concurrence dans plusieurs zones pour empêcher la surcharge des systèmes en aval.

Ce qui suit est une ligne directrice générale sur les tailles d'instances de base de données. Notez que ceci est par instance, et non les ressources totales du cluster.

Les tableaux ci‑dessus sont des estimations prudentes. Vous constaterez peut-être que les besoins réels diffèrent selon votre configuration spécifique (tailles de page, volume de commentaires, etc).

FastComments utilise des variables d'environnement pour la configuration. La liste suivante présente toutes les variables prises en charge et pertinentes pour On-Prem.

Notez que toutes les variables liées aux domaines utilisent le suffixe _HOST ou _ADDR. La différence est :

• _HOST: example.com
• _ADDR: https://example.com

Le EMAIL_CONFIG_PATH doit contenir le chemin d'un fichier JSON avec le format d'exemple suivant :

Configuration des e-mails

Copy

1

2{

3 "defaultDKIM": {

4 "domainName": "mycompany.org",

5 "keySelector": "2024",

6 "privateKey": "-----BEGIN PRIVATE KEY-----\nABCDEFG\n-----END PRIVATE KEY-----"

7 },

8 "providerTransports": {

9 "yahoo.com": "specialTransport"

10 },

11 "defaultTransport": "mailgun",

12 "transports": {

13 "mailgun": {

14 "host": "smtp.mailgun.org",

15 "port": 587,

16 "secure": false,

17 "auth": {

18 "user": "admin@somewhere.com",

19 "pass": "password"

20 },

21 "tls": {

22 "ciphers": "SSLv3"

23 }

24 },

25 "specialTransport": {

26 "host": "smtp.someplace.org",

27 "port": 587,

28 "secure": false,

29 "auth": {

30 "user": "admin@example.com",

31 "pass": "password"

32 },

33 "tls": {

34 "ciphers": "SSLv3"

35 }

36 }

37 }

38}

39

Dans l'exemple ci‑dessus, nous définissons un transport e-mail SMTP par défaut nommé mailgun. Nous définissons également un transport spécial que nous utilisons spécifiquement pour les adresses @yahoo.com. Dans certains scénarios, il est souhaitable d'utiliser un fournisseur spécifique ou une IP d'envoi pour un domaine afin d'affiner la délivrabilité. Ceci est optionnel.

DocumentDB

Lors de la connexion à DocumentDB, vous devrez spécifier MONGO_ENABLE_SSL=true MONGO_SSL_CA=/some/path.pem pour être compatible avec les paramètres par défaut.

FastComments prend en charge un mode de maintenance automatique. Si la base de données tombe en panne, il peut continuer à servir les fils de commentaires populaires.

De plus, en mode maintenance, tous les commentaires sont enregistrés dans BACKUP_DIR. Ils seront traités (contrôlés pour le spam, etc.) et sauvegardés une fois le système de nouveau en ligne.

Il le fait en déterminant, toutes les heures, les 100 fils de commentaires les plus populaires et en mettant en cache leur contenu sur disque. La détermination des 100 meilleurs fils est déjà effectuée à partir d'un état pré-calculé, donc ce n'est pas un travail périodique lourd.

Ceci est complètement optionnel, et n'est activé que si CACHE_DIR et BACKUP_DIR sont définis. Cela rend bien sûr les nœuds de l'application avec état, cependant il s'agit d'un état qui peut être perdu à tout moment sans provoquer de dysfonctionnement de l'application.

Notez qu'en mode maintenance, l'authentification correcte des fils de commentaires ne peut pas être effectuée, donc seuls les fils considérés comme étant publics en toute sécurité sont sauvegardés périodiquement.

En mode maintenance, de nombreuses fonctionnalités ne sont pas disponibles.

Les extraits de code front-end et les bibliothèques pour On-Prem sont les mêmes que pour le produit SaaS. Cependant, vous devez spécifier apiHost et le chemin de script correct :

Code des commentaires pour On Prem

Copy

1

2<script src="https://my.host.com/js/embed-v2.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5 FastCommentsUI(document.getElementById('fastcomments-widget'), {

6 tenantId: "demo",

7 apiHost: "https://my.host.com"

8 // ... peut aussi passer une charge utile SSO, etc.

9 });

10</script>

11

L'exemple ci‑dessus est très simple. Nous pourrions également utiliser les bibliothèques officielles pour React, Angular, Vue, Svelte, etc.

L'API peut être utilisée de la même manière que le produit SaaS standard : vous vous connectez au tableau de bord On-Prem pour créer des clés API et utiliser ces clés pour accéder à l'API. Les endpoints de l'API sont les mêmes on-prem que pour le produit SaaS.

Votre installation FastComments On-Prem peut servir des commentaires à plusieurs domaines internes, par exemple app.mycorp.org et hr.mycorp.org. Vous pouvez configurer ces séparément mais les héberger sur une seule installation On-Prem en créant des Règles de personnalisation distinctes pour configurer leurs comportements individuels.

Par défaut, FastComments considère que les fils de commentaires sont publics. Pour ajouter une couche de sécurité, il est recommandé de créer une règle de personnalisation avec l' Requires SSO option cochée. Cela fera en sorte que tous les endpoints liés aux commentaires exigeront une authentification SSO.