2024.2.x から 2025.1.x への移行¶
概要¶
2024.2.x から 2025.1.x への移行について変更点や注意点をまとめています。
もし不明点がある場合はサポートまでお問い合わせください。
クラスターのローリングアップデートについて¶
2024.2.x から 2025.1.x へのローリングアップデートができます。
1 台 1 台ローリングアップデートを行ってください。
2024.1.x から 2025.1.x へのローリングアップデートはできません、 かならず 2024.2.x からのアップデートを行う場合、 2024.2.x を経由してから 2025.1.x へアップデートを行ってください。
レガシーストリームを廃止しました¶
シグナリング接続時に "multistream": false を指定して接続した場合バリデーションエラーになります。
2025 年 12 月リリース予定の Sora にてウェブフックやログの multistream 項目を非推奨とします。
multistream 項目の非推奨¶
2024.2.x までのログやウェブフックに multistream 項目を出力する挙動を維持するために以下の設定を追加しました。
sora.confのlegacy_multistream_logをtrueにすることで 2024.2.x までと同様ログにmultistream項目を出力しますデフォルトは
falseですlegacy_multistream_logは 2025 年 12 月リリース予定の Sora にて廃止します
sora.confのlegacy_multistream_webhookをtrueにすることで 2024.2.x までと同様ウェブフックにmultistream項目を出力しますデフォルトは
falseですsora.confのlegacy_multistream_webhookは 2025 年 12 月リリース予定の Sora にて廃止します
legacy_signaling_error の廃止¶
2024.1.x までのシグナリングエラー時のログ出力先やウェブフック connection.failed の通知タイミングを維持する legacy_signaling_error を廃止しました。
今後は以下の挙動になります。
シグナリング時のエラーが
sora.jsonlに出力しませんシグナリング時のエラーが
signaling_error.jsonlに出力します認証失敗時のエラーが
sora.jsonlに出力しません認証失敗時のエラーが
signaling_error.jsonlに出力しますイベントウェブフック connection.failed が認証失敗時には通知しません
イベントウェブフック connection.failed が認証成功後に接続に失敗した時のみ通知します
認証失敗時のエラーログの出力¶
認証失敗時のログを sora.jsonl から signaling_error.jsonl に出力します。
認証時失敗時のエラーはシグナリングエラーと同等として扱います。
sora.jsonl に ERROR で出力されるシグナリング失敗のエラーメッセージは connection.created 以降に変更します。
イベントウェブフック connection.failed の挙動¶
connection.failed はシグナリング時にエラーが発生した場合通知する仕組みでしたが、 今後は認証が成功した後に接続が失敗した場合のみ通知されます。
これにより、認証が失敗した場合には connection.failed ウェブフックは通知されません。
session.vanished ウェブフックを廃止しました¶
Sora Exporter を利用する事で、より柔軟なセッションの監視ができることから、
session.vanished ウェブフックを廃止しました。
2025 年 6 月リリースの Sora にて廃止しました。
移行に際する不明点などはサポートまでお問い合わせください。