Open WebUIコミュニティがSentinelの名前解決不具合を報告、大文字小文字の変換でRedis接続に失敗する可能性

Open WebUIコミュニティは10月4日、Kubernetes環境に0.11.4をデプロイしてRedis Sentinelを使用する際、マスターグループ名に大文字が含まれているとRedisに接続できない場合があると報告した。報告者が挙げた例はmyMasterだ。Sentinelはこのグループを見つけられるが、Open WebUIはmymasterを検索し、MasterNotFoundErrorを返すという。これは原因を調べる手がかりとなるが、現時点ではコミュニティによる再現報告であり、メンテナーの確認は得られていない。問題報告

ポイントは、同じURLフィールドが異なる意味を持つことだ。Open WebUIの公式ドキュメントでは、REDIS_SENTINEL_HOSTSを設定した場合、REDIS_URLのhostnameは一般的なネットワークホスト名ではなく、Sentinelのサービス名として解釈される。そのため、エンジニアがドキュメントに沿ってグループ名を指定しても、解析後の文字列がSentinelの設定と一致しないことがある。環境変数のドキュメント

報告では、原因としてparse_redis_url()が使用するparts.hostnameが挙げられている。Pythonの公式ドキュメントには、URL解析結果のhostnameが小文字に変換されると明記されている。これは一般的なホスト名の扱いとしては適切だが、元の大文字小文字を維持すべきサービス識別子を変えてしまう可能性がある。この事例は、URLパーサーを論理名に適用する際、正規化によってアプリケーション層の意味が変わらないか確認する必要性を示している。Pythonの解析ドキュメント

技術的な影響は、共有状態を必要とするデプロイで主に生じる。Open WebUIの拡張デプロイ用ドキュメントでは、複数のワーカープロセスや複数インスタンスの調整にRedisを使用し、Sentinelによる高可用性構成も案内している。そのため、サービス名の解決に失敗すると、こうしたアーキテクチャの正常な動作を妨げる可能性がある。ただし、これはドキュメントに基づくデプロイ上のリスクの推定であり、既存の事例から、すべての複数インスタンス環境が影響を受けると確認されたわけではない。拡張デプロイ用ドキュメント

エンジニアはまず、エラーログに記録されたグループ名とSentinel上の実際の名前を照合し、大文字小文字も含めて接続を検証するとよい。今後は、上流でサービス名の大文字小文字が保持されるか、大小文字混在の回帰テストが追加されるか、そして修正が正式リリースに含まれるかを確認したい。確認時点で、このissueはオープンのままで、ページには関連する修正PRが記載されていない。名前の変更がすべての環境でそのまま使える解決策だと考えるべきではない。issueの状況