Skip to content

Каталог VOD

Раздел VOD — кластерный каталог ассетов: файлы, которые лежат на стримерах и играются по запросу. В отличие от стримов, у ассета нет источника и размещения лейаутером; он просто лежит там, куда его залили, и раздаётся оттуда.

Вкладок четыре: Каталог, Загрузки, Стореджи и Upload-токены. Эта страница про каталог; заливка и хранилища — на странице Загрузка VOD.

Чтобы каталогу было где жить, у стримера должен быть хотя бы один VOD-root — он задаётся в настройках стримера.

Ассет, ключ и файлы

Единица каталога — ассет. У ассета есть:

  • Ключ — путь-подобное имя, по которому ассет находят: movies/2026/blade.mp4. Ключи образуют папки, и каталог показывает их деревом.
  • Asset id — неизменный идентификатор. Ключ можно переименовать, asset id — нет, поэтому ссылки по нему переживают переименование.
  • Ревизия — растёт при каждом изменении состава файлов.
  • Файлы — один ассет может состоять из нескольких файлов: например, видео и отдельные звуковые дорожки.

Каталог VOD: дерево ключей и колонки уровня

Колонки списка: Имя, Статус, Файлы, Размер, Asset id, Обновлён. Статус — играется или не играется: ассет, из которого не удалось прочитать медиаинформацию, отдаётся только как raw-файл.

Дерево показывает не больше 1000 папок на уровень — при более длинном списке подписано Показаны первые 1000 папок — уточните фильтром. Поле Фильтр этого уровня… фильтрует текущий уровень, кнопка Показать ещё догружает ассеты.

Где ассет лежит

Блок Placement показывает, на каких стореджах ассет находится и в какой ревизии там лежит:

  • origin — первичное размещение, туда ассет залили.
  • replica — копия на другом стередже.

Рядом бывает пометка сторедж недоступен. Она означает ровно то, что подписано в подсказке: плейбек 503; удаление работает, очистка отложена. То есть каталог остаётся управляемым, даже когда машина с файлами лежит.

Файлы ассета

Таблица файлов: Файл, Media info, Hash, Действия. Файл, из которого медиаинформация не прочиталась, помечен media error и доступен как raw-файл.

Карточка ассета: placement, ревизия и файлы со ссылками воспроизведения

Кнопки HLS, DASH и RAW копируют ссылку на воспроизведение соответствующего вида, Скопировать hash — контрольную сумму файла.

Переименование ключа

Переименовать ключ меняет только метаданные: файлы остаются на месте; ссылки по AssetId продолжают работать. Переименование папки меняет префиксы всех вложенных ключей разом. Если новый ключ занят, операция отклоняется — Такой ключ уже занят.

Удаление

Удалять можно на трёх уровнях:

  • Удалить файл — из ассета убирается один файл, ревизия ассета увеличится. Если он был последним, ассет удаляется вместе с ним.
  • Удалить ассет — с подтверждением, в котором указано число файлов.
  • Удалить папку — все ассеты под этим префиксом. Консоль сначала собирает список (Сбор ассетов: N), затем ставит их в очередь и показывает ход: Удаление ассетов: N/N, с ошибкой: N, Удалено ассетов: N.

Удаление всегда работает по каталогу, а не по диску: сообщение Удалено из каталога — очистка на ноде отложена означает, что запись убрана сразу, а файлы стример уберёт, когда сможет. Именно поэтому удаление доступно и при недоступном стередже.

Что дальше

  • Загрузка VOD — как заливать файлы, где смотреть стореджи и как выдать портальный upload-токен.