Локална инсталација

FastComments On Prem вам омогућава да размествујете наше решење за коментаре уживо, укључујући све алате за модерацију и административне алате, на свом хардверу.

Ово значи да имате контролу над својим подацима, и систем коментарисања може бити ограничен на вашу локалну LAN или корпоративну мрежу.

Потребне компоненте

За On-Prem, FastComments се састоји само од апликационог сервера и базе података. Поједноставили смо примену тако да апликација може да опслужује сав саобраћај директно, без додавања других компоненти.

Апликациони сервер се испоручује као Docker слика и може се применити са било којим решењем за управљање контејнерима.

База података, MongoDB, може бити самостално покренута или хостована од стране другог провајдера као што су AWS DocumentDB или MongoDB Atlas.

FastComments се тренутно тестира са MongoDB 7, међутим тежимо ка DocumentDB компатибилности како бисмо олакшали примену.

Величине инстанци

Уочићете да је FastComments прилично добро оптимизован и не захтева велике машине за саму апликацију како би одржао ниске P99 вредности.

Сви batch и cron послови користе streaming како би ограничили укупну потрошњу меморије.

Табеле испод за апликациони сервер и базу података могу помоћи при одређивању величине.

Инстанце апликационог сервера

На пример, једно језгро које опслужује око 100 коментарских ништи у секунди обично никада не користи више од 250mb RSS.

Инстанце сервера базе података

Одређивање величине базе података зависи од величине радног скупа, односно количине података којима приступате у датом тренутку, као и од конкурентних захтева.

FastComments је прилично благ према Mongo-у, у томе што за hot упите користи index hints, streaming курсоре, и има лимите конкурентности у различитим областима како би спречио преоптерећење низводних система.

Испод је општа смерница за величине инстанци базе података. Имајте у виду да се ово односи на по инстанци, а не на укупне ресурсе у кластеру.

Горње табеле су конзервативне процене. Могуће је да се стварни захтеви разликују у зависности од ваше специфичне конфигурације (величина страница, обим коментара, итд).

FastComments користи променљиве окружења за конфигурацију. Следећа листа наводи све подржане променљиве које су релевантне за On-Prem.

Имајте у виду да све променљиве везане за домене користе суфиксе _HOST или _ADDR. Разлика је:

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

Путanja у EMAIL_CONFIG_PATH треба да садржи путању до JSON фајла са следећим примером формата:

Конфигурација е-поште

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

У горњем примеру дефинишемо подразумевани SMTP имејл транспорт под називом mailgun. Такође дефинишемо посебан транспорт који користимо специфично за имејлове са @yahoo.com. У неким сценаријима је пожељно користити специфичног провајдера или IP за слање за одређени домен како би се подесила испорука. Ово је опционално.

DocumentDB

Када се повезујете на DocumentDB, желећете да наведете MONGO_ENABLE_SSL=true MONGO_SSL_CA=/some/path.pem да бисте били компатибилни са подразумеваним подешавањима.

FastComments подржава аутоматски режим одржавања. Ако база података падне, апликација може наставити да пружа популарне нитове коментара.

Поред тога, у режиму одржавања сви коментари се чувају у BACKUP_DIR. Они ће бити обрађени (проверани на спам итд.) и сачувани када систем поново буде доступан.

То ради тако што, сваки сат, одређује 100 најпопуларнијих нити коментара и кешира њихов садржај на диск. Одређивање 100 најпопуларнијих нити већ се врши из претходно израчунатог стања, па то није тежак периодични задатак.

Ово је потпуно опционo и омогућава се само ако су подешени CACHE_DIR и BACKUP_DIR. Ово, наравно, чини нодове апликације стањним, међутим то је стање које може бити изгубљено у било ком тренутку без изазивања неправилног понашања апликације.

Имајте у виду да у режиму одржавања није могуће правилно аутентификовати нитове коментара, тако да се периодично праве резервне копије само оних нити које се безбедно сматрају јавним.

У режиму одржавања многе функције нису доступне.

Фронт-енд фрагменти кода и библиотеке за On-Prem су исти као код SaaS производа. Међутим, морате навести apiHost и исправну путању скрипте:

Код коментара за On Prem

Copy

1

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

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

4<script>

5 window.fcConfigs = [{

6 target: '#fastcomments-widget',

7 tenantId: "demo",

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

9 // ... такође се може проследити SSO payload итд.

10 }];

11</script>

12

Горњи пример је веома једноставан. Такође можемо користити званичне React, Angular, Vue, Svelte и друге библиотеке.

Приступ API-ју је могућ на исти начин као и код редовног SaaS производа: пријавите се у On-Prem контролни панел да бисте креирали API кључеве и користили те кључеве за приступ API-ју. API endpoints су исти on-prem као и за SaaS производ.

Ваша On-Prem FastComments инсталација може да служи коментаре за више унутрашњих домена, на пример app.mycorp.org и hr.mycorp.org.
Можете да их конфигуришете
посебно али их хостовати на једном On-Prem setup-у креирањем појединачних Customization Rules како бисте конфигурисали њихова појединачна понашања.

По подразумевању, FastComments претпоставља да су нитови коментара јавни. Да бисте додали ниво заштите, препоручује се креирање Customization Rule са Requires SSO опцијом означеном. Ово ће узроковати да сви endpoints везани за коментаре захтевају SSO аутентификацију.