EMQX 5.8 の互換性のない変更点

e5.8.6

• #14802 本バージョン以降、REST API またはダッシュボード経由でのプラグインインストールには明示的な許可が必要となりました。インストール前に以下の CLI コマンドで許可を取得する必要があります。

  emqx ctl plugins allow NAME-VSN

  この変更により、不正なプラグインインストールを防止しセキュリティが強化されます。API やダッシュボードでプラグインを管理しているユーザーはワークフローの調整が必要です。

e5.8.5

• #14703 force_shutdown.max_heap_size の最大許容値が 128GB に変更されました。以前に 128GB を超える値に設定していた場合、アップグレード後の設定リロードや更新時に問題が発生する可能性があります。

e5.8.4

• #14360 Prometheus メトリクスの JSON フォーマット要求時に、client トップレベルキーが単一の JSON オブジェクトではなく、常に JSON オブジェクトの配列となるよう変更されました。この変更により監視ツールのデータ処理に影響が出る場合があります。

• #14370 IoTDB データ連携設定の変更点：

  • セルフディスクリプティングテンプレートが廃止されました。EMQX は設定されたデータテンプレートのみを使用し、メッセージペイロードからテンプレートを抽出しなくなりました。

  • 各 MQTT メッセージは単一の payload のみを保持可能となり、ペイロードの配列はサポートされなくなりました。そのため、MQTT メッセージは単一またはバッチ挿入のいずれかの単位で IoTDB に原子的に処理されます。1つの MQTT メッセージから複数の IoTDB 操作を生成することはできません。

  • data type はテンプレート値ではなくプレーン値として扱われます。

  • REST API ドライバーは IoTDB 1.3.x 以降のみをサポートします。

  • Thrift ドライバーは「バッチ」モードをサポートするようになりました。

    重要：バッチモードでタイムスタンプの重複を防ぐため、MQTT メッセージのタイムスタンプ（${timestamp}）を使用するか、ペイロード内に時間フィールド（例：${payload.time}）を含めることを推奨します。

e5.8.3

• #14305 認証でのハッシュアルゴリズム MD4、MD5、RIPEMD-160 のサポートを廃止しました。これらは NIST Secure Hash Standard に準拠していません。

e5.8.2

• #14004 クラスターリンクの topics 設定において、重複するトピックフィルターが存在するとクロスクラスターのメッセージルーティングが不整合かつ不完全になる問題を修正しました。各トピックフィルターは個別に処理されるため、topics 設定内で冗長なトピックフィルター（例：t/1 と t/+）は無効とみなされます。このような設定が検出された場合、リンクは起動に失敗します。

• #14015 Kafka/Confluent/Azure Event Hub の動的トピック（プレースホルダーを含むトピック）を持つプロデューサーはディスクバッファリングをサポートしなくなりました。現在はメモリモードとハイブリッドモードのみサポートしています。

• #14106 単一の Kafka コンシューマーコネクター内で同じ Kafka トピックを複数のソースに重複して含めることを禁止するバリデーションを追加しました。トピックを重複させたい場合は、新しいコネクターとソースを作成してください。

e5.8.1

• #13792 until 値なしで作成された禁止アイテムのデフォルト有効期限が無期限（以前は最大1年）に変更されました。

• #13742 クライアントがトピック # または + をサブスクライブした際に、$ で始まるトピックの保持メッセージを受信してしまう問題を修正しました。

  この修正は MQTT-4.7.2-1 の要件を満たしています。

e5.8.0

• #13080 mqtt.retry_interval のデフォルト値を 30秒から無限大（infinity）に変更しました。

  これまでは EMQX が自動的に30秒ごとにメッセージ配信をリトライしていましたが、新しいデフォルトでは自動リトライを行いません。この変更は MQTT 仕様に準拠したもので、セッション内でのメッセージ配信リトライは一般的に推奨されていません。

  ただし、一部ユーザーがリトライ機能を利用しているため、特定のリトライ間隔を設定する機能は後方互換性のために引き続き利用可能です。

• #13190 CentOS 7 および Ubuntu 18 向けリリースのサポートを終了しました。これらの OS はサポート終了のため、EMQX はビルドを提供しません。

• #13248 builtin 耐久ストレージバックエンドを廃止し、柔軟性とスケーラビリティを向上させるために以下の2つの新バックエンドに置き換えました：

  • builtin_local：レプリケーションをサポートしない耐久ストレージバックエンドで、単一ノード展開に適しています。オープンソース版およびエンタープライズ版で利用可能ですが、マルチノードクラスターには対応していません。
  • builtin_raft：Raft コンセンサスアルゴリズムを用いて複数ノード間でデータレプリケーションを行う耐久ストレージバックエンドです。エンタープライズ版限定で提供され、高いデータ耐久性とフォールトトレランスを実現します。

  また、以下の Prometheus メトリクス名が機能をより正確に表現するために変更されました：

  • emqx_ds_egress_batches → emqx_ds_buffer_batches
  • emqx_ds_egress_batches_retry → emqx_ds_buffer_batches_retry
  • emqx_ds_egress_batches_failed → emqx_ds_buffer_batches_failed
  • emqx_ds_egress_messages → emqx_ds_buffer_messages
  • emqx_ds_egress_bytes → emqx_ds_buffer_bytes
  • emqx_ds_egress_flush_time → emqx_ds_buffer_flush_time

• #13526 オープンソース版から Core-replicant 機能を削除しました。5.8 以降、オープンソース版の全ノードは Core ロールで動作します。この変更はエンタープライズ版には影響ありません。不要となった cluster.core_nodes 設定パラメータも削除されました。

• #13372 ゲートウェイが受け入れる接続数はライセンス条件により制御されるようになり、許可された接続数の制限に準拠します。