オンプレミス

FastComments On Prem により、すべてのモデレーションおよび管理ツールを含む当社のライブコメントソリューションを、 御社のハードウェア上にデプロイできます。

これは、データを御社が管理できることを意味し、コメントシステムを社内LANや企業ネットワークに限定することができます。

必要なコンポーネント

On-Prem の場合、FastComments はアプリケーションサーバーとデータベースだけで構成されています。デプロイを簡素化しており、他のコンポーネントを追加することなく、アプリケーションがすべてのトラフィックを直接処理できます。

アプリケーションサーバーは Docker イメージとして提供されており、任意のコンテナ管理ソリューションでデプロイできます。

データベースである MongoDB は、セルフホストでも、AWS DocumentDB や MongoDB Atlas などの他のプロバイダーによるホスティングでも利用できます。

FastComments は現在 MongoDB 7 でテストされていますが、デプロイを容易にするため、DocumentDB 互換性も目指しています。

インスタンスサイズ

FastComments はかなり最適化されており、低い P99 を維持するためにアプリケーション自体に大型マシンを必要としないことがわかるでしょう。

すべてのバッチジョブおよび cron ジョブは、総メモリ使用量を抑えるためにストリーミングを使用します。

以下のアプリケーションサーバーおよびデータベースの表が、サイジングの参考になります。

アプリケーションサーバーインスタンス

例えば、1 コアで毎秒約 100 のコメントスレッドを処理する場合でも、RSS は通常 250mb を超えることはほとんどありません。

データベースサーバーインスタンス

データベースのサイジングは、ワーキングセットサイズ(ある時点でアクセスするデータ量)と同時リクエスト数によって異なります。

FastComments は MongoDB に比較的優しい作りになっており、ホットなクエリではインデックスヒントやストリーミングカーソルを使用し、さまざまな箇所で同時実行数の制限を設けることで、下流システムへの過負荷を防いでいます。

以下は、データベースインスタンスサイズの一般的なガイドラインです。これはクラスター全体のリソースではなく、__1 インスタンスあたり__の値であることに注意してください。

上記の表は控えめな推定値です。実際の要件は、お客様の特定の構成(ページサイズ、コメント量など)によって異なる場合があります。

FastCommentsは設定に環境変数を利用します。以下のリストは、On-Premに関連するサポート対象のすべての変数を示したものです。

すべてのドメイン関連の変数は、_HOSTまたは_ADDRの接尾辞を使用することに注意してください。その違いは以下の通りです:

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

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

上記の例では、mailgunというデフォルトのSMTPメールトランスポートを定義しています。また、@yahoo.comのメール専用に使用される特別なトランスポートも定義しています。配信を調整するために、特定のドメインに対して特定のプロバイダーや送信IPを使用することが望ましい場合があります。これはオプションです。

DocumentDB

DocumentDBに接続する際は、デフォルト設定との互換性を保つためにMONGO_ENABLE_SSL=true MONGO_SSL_CA=/some/path.pemを指定する必要があります。

FastComments は自動のメンテナンスモードをサポートしています。データベースが停止した場合でも、人気のあるコメントスレッドの配信を継続できます。

さらに、メンテナンスモードではすべてのコメントが BACKUP_DIR に保存されます。システムが復旧した際に（スパムチェック等）処理され、保存されます。

これは、毎時、最も人気のあるコメントスレッド上位100件を判定し、その内容をディスク上にキャッシュすることで行われます。上位100件の判定は事前計算された状態から行われるため、負荷の高い定期ジョブにはなりません。

これは完全にオプションで、CACHE_DIR と BACKUP_DIR が設定されている場合にのみ有効になります。もちろんこれによりアプリケーションノードは状態を持つようになりますが、その状態はいつでも失われてもアプリケーションが誤動作することはありません。

メンテナンスモードではコメントスレッドの適切な認証が行えないことに注意してください。そのため、安全に公開と見なせるスレッドのみが定期的にバックアップされます。

メンテナンスモードでは多くの機能が利用できません。

フロントエンドのコードスニペットとライブラリは、オンプレミス向けでも SaaS 製品と同じです。ただし、apiHost と正しいスクリプトパスを指定する必要があります：

オンプレミス用コメントコード

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 ペイロードなども渡せます。

10 }];

11</script>

12

上は非常に簡単な例です。公式の React、Angular、Vue、Svelte などのライブラリも使用できます。

APIには、通常のSaaS製品と同様にアクセスできます。オンプレミスのダッシュボードにログインしてAPIキーを作成し、それらのキーを使用してAPIにアクセスします。

API エンドポイントはオンプレミスでもSaaS製品と同じです。

あなたの On-Prem FastComments インストールは、例えば app.mycorp.org や hr.mycorp.org のように、複数の内部ドメインにコメントを配信できます。これらは個別に設定できますが、単一の On-Prem 設定上でホストし、それぞれの挙動を設定するために別々の Customization Rules を作成することで実現できます。

デフォルトでは、FastComments はコメントスレッドを公開とみなします。セキュリティ層を追加するには、カスタマイズルールを作成し、 Requires SSO オプションにチェックを入れることを推奨します。これにより、コメント関連のすべてのエンドポイントが SSO 認証を必要とするようになります。