# 2021.2.x から 2022.1.x への移行 ## 概要 2021.2.x から 2022.1.x への移行について注意点をまとめています。 ## シグナリング通知メタデータ metadata_list の廃止 2022 年 6 月リリースの Sora にて `metadata_list` が `data` に変更されることに伴い、 `sora.conf` の `unuse_metadata_list` のデフォルトを `true` に変更しました。 詳細は [シグナリング通知メタデータ metadata_list の廃止](OBSOLETE.html#8a323e) をご確認ください。 ## リモート統計情報 API を廃止 `sora.conf` の `remote_stats` を廃止しました。 リモート統計情報 API は `user_agent_stats` が `true` であれば、 利用可能ですので、何か設定をしていただく必要はありません。 詳細は [廃止 リモート統計情報 API](OBSOLETE_API.html#43ecfc) をご確認ください。 ## 分割録画で通知されるウェブフックのタイプを変更しました - `"type": "archive.split"` から `"type": "split-archive.available` に変更しました。 - `"type": "archive.end"` から `"type": "split-archive.end` に変更しました。 `sora.conf` の `split_archive_legacy_prefix` を `true` にすることで `type: archive.split` と `"type": "archive.end"` がそのまま利用できます。 `split_archive_legacy_prefix` は 2023 年 6 月リリースの Sora にて廃止されますので、それまでの移行をお願いします。 ## 分割録画で出力される録画ファイル名とメタデータファイル名を変更しました - `archive-_.webm` を `split-archive-_.webm` に変更しました。 - `archive-_.json` を `split-archive-_.json` に変更しました。 `sora.conf` の `split_archive_legacy_prefix` を `true` にすることで `archive-_.webm` と `archive-_.json` がそのまま利用できます。 `split_archive_legacy_prefix` は 2023 年 6 月リリースの Sora にて廃止されますので、それまでの移行をお願いします。 ## クラスター設定名を一部変更しました ### cluster_node_name を node_name に変更しました クラスターのノード名を指定する `sora.conf` の `cluster_node_name` を `node_name` に変更しました。 ### cluster_api_url を external_api_url に変更しました クラスター利用時に外から見える API URL を指定する `sora.conf` の `cluster_api_url` を `external_api_url` に変更しました。 ### cluster_signaling_url を external_signaling_url に変更しました クラスター利用時に外から見えるシグナリング URL を指定する `sora.conf` の `cluster_signaling_url` を `external_signaling_url` に変更しました。 ## クラスター API 引数を一部変更しました ### JoinCluster API クラスターを参加させる `JoinCluster` API の `cluster_node_name` を `contact_node_name` に変更しました。戻り値も `cluster_node_name_list` から `node_name_list` に変更しました。 ### ListClusterNode API クラスターノード一覧を確認する `ListClusterNodes` API の戻り値を変更しました。 - `cluster_node_name` を `node_name` に変更しました - `cluster_api_url` を `external_api_url` に変更しました - `cluster_signaling_url` を `external_signaling_url` に変更しました - `sora_version` を `version` に変更しました ## クラスター参加への参加を自動化する機能を追加しました `sora.conf.` の `contact_node_name_list` の利用することで、クラスターへの参加を `JoinCluster` API なしで自動で行います。 詳細は [contact_node_name_list](CLUSTER.html#a3d0fd) をご確認ください。 ## クラスターノードリストの永続化用のディレクトリ data/ 以下にファイルが作られるようになりました クラスターノードリストを保存するために Sora が内部的に利用する `data/cluster-nodes.bin` というファイルが生成されるようになりました。 そのため `data/` 以下に読み込み、書き込み、および実行の権限を与えるようにしてください。 このファイルは Sora ノードをアップデートする際にコピーする必要はありません。特に利用者が意識する必要はありません。