Хранилища DVR

Диски и S3: подключение, инициализация, ретенция, вытеснение и диагностика.

Хранилище — это именованная цель записи архива на конкретной ноде. Типов два: локальный диск (каталог на смонтированной файловой системе) и S3 (учётная запись объектного хранилища). Камера при настройке DVR выбирает хранилище по имени, поэтому имя — часть эксплуатационной схемы, а не техническая подробность: «Постоянное имя, используемое политиками размещения DVR камер.».

Хранилища заводит суперадмин в карточке узла: Узлы → нода → Хранилища. Админ организации хранилища не настраивает — он лишь выбирает из разрешённых ему имён при создании камеры.

Два независимых шага#

Работа с диском всегда состоит из двух действий, и путать их не нужно:

1. Описание в Plane. Вы создаёте запись хранилища: имя, тип, путь, параметры. Plane сохраняет желаемое состояние и передаёт его ноде в составе конфигурации. Файловая система при этом не трогается вообще.
2. Инициализация диска. Отдельное явное действие, при котором нода создаёт в каталоге файл-маркер, а Plane привязывает идентификатор хранилища к конкретному устройству. Только после этого диск становится пригодной целью записи.

Подготовка диска на сервере#

Диск должен быть смонтирован до добавления и иметь отдельную точку монтирования — так переполнение архива не остановит систему. Файловая система: ext4 или XFS.

lsblk -o NAME,SIZE,MOUNTPOINT     # диск смонтирован?
df -h /mnt/dvr                    # сколько места

Каталог должен быть доступен для записи сервисной учётной записи ноды. Корневой раздел под архив не берите: заполнившийся / останавливает не только запись, но и саму ноду.

Добавление локального диска#

Узлы → нода → Хранилища → добавить. Откроется окно «Новое хранилище».

Путь проверяется строго. При ошибке выводится «Укажите нормализованную абсолютную директорию ниже /; ., .., // и завершающий слеш запрещены.» — то есть /mnt/dvr подходит, а /mnt/dvr/, /mnt//dvr, /mnt/dvr/.. и / — нет.

Длительность сегмента#

Архив пишется файлами-сегментами. Варианты подписаны прямо в списке: «15 мин · 96 сегментов/сутки (рекомендуется)», «30 мин · 48 сегментов/сутки», «1 час · 24 сегмента/сутки».

Это целевое значение, а не гарантия: «реконнект, разрыв потока или временной шкалы, остановка/восстановление после сбоя и защитные лимиты могут финализировать сегмент раньше». Больший сегмент уменьшает число файлов, индексов и объектов S3, но задерживает холодную копию — сегмент уезжает в S3 только после того, как он закрыт. Если холодная копия должна быть свежей, оставляйте 15 минут.

Инициализация диска#

Новый диск получает статус «Требуется инициализация» с пояснением «Размещение DVR заблокировано, пока суперадмин явно не привяжет этот идентификатор к смонтированной файловой системе.». Нажмите «Инициализировать диск».

Подтверждение говорит, что именно произойдёт: «Инициализировать «{имя}» по пути {путь}? Убедитесь, что по этому точному пути смонтирован нужный надёжный том. Plane привяжет UUID хранилища к текущему устройству и inode корня; диск не форматируется.».

Диск не форматируется и не очищается — создаётся только файл-маркер. Но том должен быть тем самым: привязка запоминает устройство и inode корня, и подмена тома потом будет обнаружена.

Промежуточные состояния, которые вы можете увидеть:

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

ls -la /mnt/dvr/
# .hastreamer-storage-identity   ← маркер: каталог принадлежит этой системе

BASE=https://cctv.example.com
NODE_ID=<UUID-ноды>
curl -sS "$BASE/api/v1/nodes/$NODE_ID/storages" -H "Authorization: Bearer $TOKEN" \
  | python3 -c 'import sys,json;[print(s["name"],s["provisioning"]["state"]) for s in json.load(sys.stdin)]'
# dvr1 ready

Добавление хранилища S3#

Тот же диалог, тип S3. Секция «Подключение S3» — «Учётные данные и адресация S3-совместимого холодного уровня, используемые нодой.».

Endpoint проверяется: «Используйте https://host[:port] или host[:port]. HTTP, пути, параметры запроса и встроенные учётные данные запрещены.». При редактировании поле секретного ключа пустое — «Настроено. Оставьте пустым, чтобы сохранить текущее write-only значение.»; ключи можно ротировать, не трогая остальное.

Хранилище S3 подключается к камере в форме камеры, блок «Холодный архив / резервная копия S3»: переключатель «Копировать в S3», выбор хранилища и bucket (3–63 символа в нижнем регистре). Срок хранения копии наследует размерность локальной политики (срок остаётся сроком, объём — объёмом) и не может быть меньше локального.

Ретенция и вытеснение#

Глубину архива задают два независимых механизма, и их часто путают.

Политика камеры — это то, что вы обещаете заказчику («две недели архива»). Порог хранилища — защита самого диска: когда заполнение достигает указанного процента, начинают вытесняться самые старые записи, независимо от того, истёк ли их срок по политике камеры.

Значение 0…100. Ставить его выше 95 % не стоит: вытеснение должно успеть освободить место до того, как файловая система упрётся в потолок.

Диагностика#

Вкладка «Хранилища» карточки узла показывает по каждому хранилищу:

• Занятость и ёмкость — «Занято ёмкости», «{n}% свободно», «Порог вытеснения: {n}%».
• Нагрузка — «IOPS записи», «IOPS чтения», «Скорость чтения», «Скорость записи», а также «I/O физического устройства» с пометкой «Общее для устройства · пути могут его разделять» (несколько хранилищ на одном физическом диске делят его пропускную способность).
• Динамика — «Скорость заполнения», «Заполняется на {значение}/день», «Чистый прирост», «Освобождено», «Стабильно — не заполняется» либо «Уменьшается на {значение}/день».
• Холодный уровень · S3 — «Известно в архиве», «Перенесено за проход», «Очередь переноса», «Зафиксировано в локальном каталоге», «Известные неполные пары», «Ошибки S3», «Холодные чтения с запуска», «Загрузки в tier с запуска».

Состояние самой записи хранилища может быть «Применено», «Ожидает применения» или «Ожидает телеметрию» — последние два означают, что нода ещё не подтвердила изменение.

Изменение и удаление#

Часть полей блокируется, как только хранилище используется:

• Путь диска — «Путь заблокирован, пока это хранилище используют камеры: {n}. Для безопасного переноса создайте новое хранилище и переназначьте камеры.».
• Endpoint, регион и адресация S3 — «заблокированы, пока этот физический namespace S3 используют камеры или задачи очистки»; ключ доступа, секретный ключ и проверку TLS можно ротировать.
• Название и тип — не меняются никогда после создания.

Удаление возможно, только если на хранилище не ссылается ни одна камера и не осталось незавершённых задач очистки архива; при попытке удалить занятое хранилище операция отклоняется. Подтверждение: «Удалить хранилище «{имя}»? Это разрешено, только если на него не ссылаются камеры; существующие файлы не удаляются.» — сами записи архива на диске при этом остаются, удаляется только описание в Plane.

Что дальше#

• Ноды и флот — карточка узла, в которой живут хранилища.
• Установка с нуля: Node — подготовка сервера и дисков.
• Архив (DVR) — политики записи камер, просмотр и экспорт.
• Ноды и хранилища в API — те же операции запросами, с полным списком ошибок.
• Диагностика неисправностей — если архив не пишется.