Skip to content

クラスター構成 ​

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クラスターのノードディスカバリ戦略を設定しますmanualmanual, static, dns, etcd, k8s, singleton
core_nodesこのレプリカントノードが接続するコアノードを設定します。
複数ノードはカンマ区切りで指定可能
----
driverEMQXノード間通信のトランスポートプロトコルを設定しますtcptcp, SSL
ssl_optionsリスナーのSSL/TLS設定オプションを設定します。3つのプロパティがあります----
ssl_options.cacertfileクライアント証明書の真正性を検証するためにリスナーが使用する信頼済みCA(認証局)証明書を含むPEMファイル----
ssl_options.certfileリスナーのSSL/TLS証明書チェーンを含むPEMファイル。証明書がルートCAから直接発行されていない場合、中間CA証明書をリスナー証明書の後に連結してチェーンを形成してください----
ssl_options.keyfileSSL/TLS証明書に対応する秘密鍵を含むPEMファイル----
ssl_options.fail_if_no_peer_certtrueに設定すると、クライアントが証明書を送信しない(空の証明書を送る)場合にサーバーが失敗します。falseの場合は無効な証明書を送信した場合のみ失敗します(空の証明書は有効とみなされます)----

TIP

EMQXはカスタマイズニーズに対応するため、さらに多くの設定項目を提供しています。詳細はEMQX Enterprise構成マニュアルをご覧ください。

ノード間の帯域幅が制限されている場合やノード間データ転送に課金が発生する場合、クラスターRPCトラフィックを削減する方法についてはクラスターRPCトラフィックの圧縮をご参照ください。