クラスター構成
EMQXにおけるクラスターとは、高いスケーラビリティとフォールトトレランスを備えたMQTTメッセージングシステムを提供するために連携するEMQXノードのグループです。クラスタリングにより、複数のノードに負荷を分散し、1つ以上のノードが障害を起こしてもシステムが継続して稼働できるようにします。
ノード名の設定
クラスター作成の前に、EMQXのノード名の概念に慣れておきましょう。EMQXノードはノード名で識別されます。ノード名は、@で区切られたノード名部分とホスト部分の2つで構成されます。例えば、emqx@s1.emqx.ioのようになります。ホスト部分はIPアドレスか完全修飾ドメイン名(FQDN)でなければなりません。例:
- サーバー
s1.emqx.ioにデプロイされたEMQXノードの場合、ノード名はemqx@s1.emqx.ioとします。 - このサーバーに静的IP(
192.168.0.10)がある場合、ノード名はemqx@192.168.0.10とします。
emqx.confでノードを設定する際は、以下のように記述します。
bash
node {
name = "emqx@s1.emqx.io"
role = core
}ここで、
nameは設定したいノード名を指します。例:emqx@localhost。roleはEMQXノードがクラスター内で果たす役割を示します。役割はコアノードとレプリカントノードの2種類があります。コアノードとレプリカントノードの詳細はEMQXクラスタリング - コアノードとレプリカントノードをご覧ください。- デフォルト値:
core - 選択可能な値:
coreまたはreplicant
- デフォルト値:
クラスターの設定
このセクションでは、EMQXクラスターの設定方法を紹介します。クラスター設定はコアノードまたはレプリカントノードのいずれかで行えます。レプリカントノードで設定する場合、一部の設定項目(例:core_nodes)は特定の前提条件下でのみ有効です。
- ノードの
node.db_backendがrlogに設定されていること(rlogをデータベースバックエンドとして使用)。 - ノードの
node.roleがreplicantに設定されていること(レプリカントノードとして機能)。 node.discovery_strategyがmanualまたはstaticに設定されていること。自動クラスターディスカバリ機構を使用する場合は設定不要です。ノードのディスカバリ戦略と対応する設定項目の詳細はクラスター作成をご覧ください。
bash
cluster {
name = emqxcl
discovery_strategy = manual
core_nodes = []
driver = tcp
ssl_options {
certfile = ""
keyfile = ""
cacertfile = ""
}
}ここで、
| 設定項目 | 説明 | デフォルト値 | 選択可能な値 |
|---|---|---|---|
name | クラスターの名前を設定します | emqxcl | |
discovery_strategy | クラスターのノードディスカバリ戦略を設定します | manual | manual, static, dns, etcd, k8s, singleton |
core_nodes | このレプリカントノードが接続するコアノードを設定します。 複数ノードはカンマ区切りで指定可能 | -- | -- |
driver | EMQXノード間通信のトランスポートプロトコルを設定します | tcp | tcp, SSL |
ssl_options | リスナーのSSL/TLS設定オプションを設定します。3つのプロパティがあります | -- | -- |
ssl_options.cacertfile | クライアント証明書の真正性を検証するためにリスナーが使用する信頼済みCA(認証局)証明書を含むPEMファイル | -- | -- |
ssl_options.certfile | リスナーのSSL/TLS証明書チェーンを含むPEMファイル。証明書がルートCAから直接発行されていない場合、中間CA証明書をリスナー証明書の後に連結してチェーンを形成してください | -- | -- |
ssl_options.keyfile | SSL/TLS証明書に対応する秘密鍵を含むPEMファイル | -- | -- |
ssl_options.fail_if_no_peer_cert | trueに設定すると、クライアントが証明書を送信しない(空の証明書を送る)場合にサーバーが失敗します。falseの場合は無効な証明書を送信した場合のみ失敗します(空の証明書は有効とみなされます) | -- | -- |
TIP
EMQXはカスタマイズニーズに対応するため、さらに多くの設定項目を提供しています。詳細はEMQX Enterprise構成マニュアルをご覧ください。
ノード間の帯域幅が制限されている場合やノード間データ転送に課金が発生する場合、クラスターRPCトラフィックを削減する方法についてはクラスターRPCトラフィックの圧縮をご参照ください。