FastComments On Prem stelt u in staat onze oplossing voor live reacties uit te rollen, inclusief alle moderatie- en beheertools, op uw eigen hardware.

Dit betekent dat u controle heeft over uw gegevens, en dat het reactiesysteem beperkt kan worden tot uw lokale LAN of bedrijfsnetwerk.

Vereiste componenten

Voor On-Prem bestaat FastComments alleen uit een applicatieserver en een database. We hebben de deployment vereenvoudigd zodat de applicatie al het verkeer direct kan afhandelen zonder extra componenten toe te voegen.

De applicatieserver wordt geleverd in een Docker image en kan worden ingezet met elke containerbeheeroplossing.

De database, MongoDB, kan zelf worden beheerd of gehost worden door een andere provider zoals AWS DocumentDB of MongoDB Atlas.

FastComments is momenteel getest met MongoDB 7, maar we streven ernaar DocumentDB-compatibel te zijn om de deployment te vereenvoudigen.

Instancegroottes

Je zult merken dat FastComments redelijk goed geoptimaliseerd is en geen grote machines voor de applicatie zelf vereist om lage P99s te behouden.

Alle batch- en cron-jobs gebruiken streaming om het totale geheugengebruik te beperken.

De onderstaande tabellen voor de applicatieserver en database kunnen helpen bij het bepalen van de juiste grootte.

Applicatieserverinstanties

Bijvoorbeeld gebruikt een enkele core die ongeveer 100 reactiedraden per seconde bedient gewoonlijk nooit meer dan 250mb RSS.

Databaseserverinstanties

Het dimensioneren van de database hangt af van de grootte van de werkset, dat is de hoeveelheid data die je op een gegeven moment benadert, evenals gelijktijdige verzoeken.

FastComments is redelijk vriendelijk voor Mongo, in die zin dat voor de hot queries het gebruikmaakt van index hints, streaming cursors, en er in verschillende gebieden concurrency limits zijn om overbelasting van downstream-systemen te voorkomen.

Hieronder staat een algemene richtlijn voor database-instantiegroottes. Let op dat dit per instantie is, niet de totale resources in het cluster.

De bovenstaande tabellen zijn conservatieve schattingen. Je kunt merken dat de daadwerkelijke vereisten verschillen op basis van je specifieke configuratie (paginagroottes, commentaargrootte, enz.).

FastComments gebruikt omgevingsvariabelen voor configuratie. De volgende lijst geeft alle ondersteunde variabelen weer die relevant zijn voor On-Prem.

Let op dat alle domeingerelateerde variabelen de achtervoegsels _HOST of _ADDR gebruiken. Het verschil is:

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

Het EMAIL_CONFIG_PATH moet een pad naar een JSON-bestand bevatten met het volgende voorbeeldformaat:

E-mailconfiguratie

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

In het bovenstaande voorbeeld definiëren we een standaard SMTP e-mailtransport genaamd mailgun. We definiëren ook een speciaal transport dat we specifiek gebruiken voor @yahoo.com-e-mails. In sommige scenario's is het wenselijk om voor een domein een specifieke provider of verzend-IP te gebruiken om de aflevering te optimaliseren. Dit is optioneel.

DocumentDB

Bij het verbinden met DocumentDB wilt u MONGO_ENABLE_SSL=true MONGO_SSL_CA=/some/path.pem opgeven om compatibel te zijn met de standaardinstellingen.

FastComments ondersteunt een automatische onderhoudsmodus. Als de database uitvalt, kan het populaire reactiedraden blijven bedienen.

Bovendien worden in de onderhoudsmodus alle opmerkingen opgeslagen in BACKUP_DIR. Ze worden verwerkt (gecontroleerd op spam, enz.) en opgeslagen zodra het systeem weer online is.

Dit gebeurt doordat elk uur de top 100 meest populaire reactiedraden wordt bepaald en hun inhoud op schijf wordt gecachet. Het bepalen van de top 100 reactiedraden wordt al gedaan op basis van vooraf berekende staat, dus het is geen zware periodieke taak.

Dit is volledig optioneel en wordt alleen ingeschakeld als CACHE_DIR en BACKUP_DIR zijn ingesteld. Dit maakt de applicatieknooppunten uiteraard stateful, maar het is staat die op elk moment verloren kan gaan zonder dat de applicatie zich verkeerd gedraagt.

Let op dat in de onderhoudsmodus een correcte authenticatie van reactiedraden niet mogelijk is, dus worden alleen reeksen die veilig als openbaar worden beschouwd periodiek geback-upt.

In de onderhoudsmodus zijn veel functies niet beschikbaar.

De front-end codefragmenten en bibliotheken voor On-Prem zijn hetzelfde als het SaaS-product. Je moet echter apiHost en het juiste scriptpad opgeven:

Reactiecode voor 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 // ... kan ook SSO-payload enz. doorgeven.

9 });

10</script>

11

Bovenstaand is een heel eenvoudig voorbeeld. We kunnen ook de officiële React-, Angular-, Vue-, Svelte- enz. bibliotheken gebruiken.

De API is op dezelfde manier toegankelijk als het reguliere SaaS-product: u logt in op het On-Prem dashboard om API-sleutels aan te maken en gebruikt die sleutels om toegang tot de API te krijgen. De API endpoints zijn on-prem hetzelfde als voor het SaaS-product.

Uw On-Prem FastComments-installatie kan reacties serveren aan meerdere interne domeinen, bijvoorbeeld app.mycorp.org en hr.mycorp.org. U kunt deze apart configureren maar host ze op één On-Prem-installatie door aparte Customization Rules aan te maken om hun individuele gedrag te configureren.

Standaard gaat FastComments ervan uit dat discussiedraden openbaar zijn. Om een extra beveiligingslaag toe te voegen, wordt aanbevolen een Aanpassingsregel te maken met de Requires SSO optie aangevinkt. Hierdoor zullen alle endpoints die met reacties te maken hebben SSO-authenticatie vereisen.