クラスターリンククイックスタート

このページでは、離れた2つのEMQXクラスター間でクラスターリンクを設定するためのクイックスタートガイドを提供します。

前提条件

それぞれ異なるリージョンにコンピュートリソースを用意し、各リージョンにEMQXクラスターをホスティングしていることを確認してください。例として、us-east と eu-west リージョンを使用し、クラスター名をそれぞれ cluster-us-east と cluster-eu-west とします。

要件

EMQX バージョン 5.8.0 以降
一意のクラスター名
クラスター間のネットワーク通信

クラスターリンクでは、各クラスターのMQTTリスナーが相手クラスターのネットワークから到達可能である必要があります。トラフィックの均等分散のため、これらのMQTTリスナーはロードバランサーの背後に配置することを推奨します。セキュリティ面では、パブリックインターネットを利用する場合、クラスター間通信は暗号化（TLS）および厳格なTLSまたはMQTTクライアント認証で保護してください。

本番環境に移行する前に、専用のセキュアクラスターリンクガイドに従い、各クラスターの認証、認可、および$LINK/トピックネームスペースを強化してください。

最初のクラスター（cluster-us-east）のセットアップ

最初のクラスター cluster-us-east は、以下の設定スニペットをクラスターの設定ファイルに追加してセットアップします。

bash

# クラスターリンク設定
cluster {
  # このクラスターの名前
  name = "cluster-us-east"
  links = [
    {
      # 2番目のクラスターの名前
      name = "cluster-eu-west"
      # 2番目のクラスターのMQTTリスナーのエンドポイント
      server = "emqx.us-east.myinfra.net:11883"
      clientid = "clink-us-east"
      topics = ["#"]
    }
  ]
}

# クラスターリンク接続専用リスナー
listeners {
  tcp.clink {
    bind = 11883
  }
}

この設定は以下を指定しています：

リモートクラスター名は cluster-eu-west
クラスターは emqx.us-east.myinfra.net:11883 でアクセス可能
クラスターリンクMQTT接続のクライアントIDプレフィックスは clink-us-east
すべてのメッセージ（# ワイルドカードトピックにマッチ）がローカルクラスターに転送される
ポート 11883 でクラスターリンク接続専用のリスナーが有効化されている

2番目のクラスター（cluster-eu-west）のセットアップ

2番目のクラスター cluster-eu-west は、以下の設定スニペットをクラスターの設定ファイルに追加してセットアップします。

bash

# クラスターリンク設定
cluster {
  name = "cluster-eu-west"
  links = [
    {
      name = "cluster-us-east"
      server = "emqx.eu-west.myinfra.net:11883"
      clientid = "clink-eu-west"
      topics = ["#"]
    }
  ]
}

# クラスターリンク接続専用リスナー
listeners {
  tcp.clink {
    bind = 11883
  }
}

この設定は最初のクラスターの設定と対称的です。両方の設定が適用され、クラスターが起動すると、2つのクラスター間に対称的で双方向のクラスターリンクが確立されます。非対称リンクの作成も可能であり、後述します。

クラスターリンクの検証

異なるクラスターに接続されたクライアント同士が標準のMQTTメカニズムで通信できることを確認するために、MQTTX CLIツールを使って、一方のクラスターからメッセージをパブリッシュし、もう一方でサブスクライブしてみます。

cluster-us-east でサブスクライバーを起動：

bash

mqttx sub -h emqx.us-east.myinfra.net --topic linked/# --qos 1 --verbose
[6/4/2024] [3:53:32 PM] › …  接続中...
[6/4/2024] [3:53:32 PM] › ✔  接続完了
[6/4/2024] [3:53:32 PM] › …  linked/# にサブスクライブ中...
[6/4/2024] [3:53:32 PM] › ✔  linked/# にサブスクライブ完了

cluster-eu-west からメッセージをパブリッシュ：

bash

mqttx pub -h emqx.eu-west.myinfra.net --topic linked/42 --message "Hello from the other side!"
[6/4/2024] [3:53:35 PM] › …  接続中...
[6/4/2024] [3:53:35 PM] › ✔  接続完了
[6/4/2024] [3:53:35 PM] › …  メッセージパブリッシュ中...
[6/4/2024] [3:53:35 PM] › ✔  メッセージパブリッシュ完了

サブスクライバーでメッセージを受信：

bash

[6/4/2024] [3:53:35 PM] › topic: linked/42
payload: Hello from the other side!

逆方向でも同様に実施：

cluster-eu-west でサブスクライバーを起動：

bash

mqttx sub -h emqx.eu-west.myinfra.net --topic linked/# --qos 1 --verbose
[6/4/2024] [3:54:12 PM] › …  接続中...
[6/4/2024] [3:54:12 PM] › ✔  接続完了
[6/4/2024] [3:54:12 PM] › …  linked/# にサブスクライブ中...
[6/4/2024] [3:54:12 PM] › ✔  linked/# にサブスクライブ完了

cluster-us-east からメッセージをパブリッシュ：

bash

mqttx pub -h emqx.us-east.myinfra.net --topic linked/1 --message "Hello from US!"
[6/4/2024] [3:54:15 PM] › …  接続中...
[6/4/2024] [3:54:15 PM] › ✔  接続完了
[6/4/2024] [3:54:15 PM] › …  メッセージパブリッシュ中...
[6/4/2024] [3:54:15 PM] › ✔  メッセージパブリッシュ完了

サブスクライバーでメッセージを受信：

bash

[6/4/2024] [3:54:15 PM] › topic: linked/1
payload: Hello from US!

完璧です！クラスターリンクが正常に動作しています。

TIP

クラスターリンクはクラスター間でサブスクリプション情報を伝播する非同期プロセスを含みます。通常は数ミリ秒で完了しますが、サブスクライブ直後にメッセージをパブリッシュすると、メッセージ配信にわずかな遅延が生じる場合があります。

非対称リンクのセットアップ

非対称リンクを作成するには、cluster-eu-west の設定を以下のように少し変更します。

bash

cluster {
  name = "cluster-eu-west"
  links = [
    {
      name = "cluster-us-east"
      server = "emqx.eu-west.myinfra.net:11883"
      clientid = "clink-eu-west"
      topics = []
    }
  ]
}

ご覧の通り、前回の設定とほぼ同じですが、topics フィールドが空になっています。これは cluster-eu-west が cluster-us-east からのメッセージを一切受け取らないことを意味します。これによりクラスターリンクは非対称となり、クラスター間の一方向メッセージ転送に有用です。

上記のメッセージパブリッシュおよびサブスクライブの手順を繰り返すと、cluster-us-east からパブリッシュされたメッセージが cluster-eu-west のサブスクライバーに届かないことが確認できます。

スキーマレジストリ

LLM ベースの MQTT データ処理

サブスクリプションフィルター

メッセージキュー

MQTT ストリーム

MQTT over QUIC