Медиа.маги Документация
On this page

Last updated

delete

delete в цепочке download → delete → upload, удаляющий источник после того, как файл передан дальше.

1. Сводка

Удаляет файл по URL хранилища. Беритесь за него, как только потребитель ниже по потоку прочитал файл и в оригинале больше нет нужды — типично для очистки стейджинговой области после успешного перекодирования или подрезки watch-папки после приёма.

2. Когда использовать

  • Очистка промежуточного файла, как только процесс выдал готовую поставку, а источник больше не нужен.
  • Подрезка watch-папки после приёма, чтобы следующий плановый прогон не подобрал тот же вход дважды.
  • Освобождение места на стейджинговом бакете, где между прогонами накапливаются временные артефакты.
  • Удаление устаревшей копии, как только новая версия опубликована на своё назначение доставки.

3. Входы

  • Package — core.Package. Пакет, чей файл-носитель нужно удалить. Подключайте выход-пакет производителя, чьё хранилище хотите освободить.

    Совместимые узлы выше по потоку:

    • download — читает файл по URL.
    • mp4 — оборачивает дорожки в файл MP4.
    • mov — оборачивает дорожки в файл MOV (QuickTime).
    • mxf — оборачивает дорожки в файл MXF.
    • ts — оборачивает дорожки в файл MPEG-TS.
    • dash — упаковывает дорожки в манифест MPEG-DASH.
    • hls3 — упаковывает дорожки в плейлист HLS v3.
    • hls5 — упаковывает дорожки в плейлист HLS v5.

4. Выходы

  • Package — core.Package. Пакет передаётся без изменений после того, как файл-носитель удалён, поэтому остальной граф может продолжить по ссылке в памяти (например, для финальной загрузки или инспекции analyze), хотя место хранения теперь пусто.

    Совместимые узлы ниже по потоку:

    • upload — записывает пакет на целевой URL.
    • analyze — инспектирует пакет и выводит его технические свойства как метаданные-пины.

5. Параметры

Диалог «Delete Node Settings» с полями Node Label и URL.

Диалог «Настройки» — один столбец с двумя полями.

  • Node Label (string, по умолчанию пусто)

    Произвольное имя, отображаемое на плитке узла на холсте.

    • Что задаёт. Подпись над плиткой; на то, какой файл удаляется, не влияет.
    • Когда менять. Задавайте, когда в одном графе несколько узлов delete — обычно когда отдельные ветви чистят каждая свою стейджинговую область, — чтобы каждый был узнаваем с одного взгляда.

  • URL (string, обязателен, переменные допускаются)

    URL хранилища файла для удаления.

    • Что задаёт. Точную цель, которую узел удаляет. Допустимые протоколы повторяют остальной слой хранилища платформы (http, https, ftp, s3, smb).
    • Когда менять. Почти всегда. Боевые процессы оставляют поле привязанным к переменной процесса — $In совпадает с каноническим образцом, — чтобы каждая задача подставляла свою цель без правки графа. Прописывайте URL жёстко только для разовой очистки известного ассета.
    • Переменные. Поддерживаются. Привяжите к переменной процесса типа url и подставляйте значение при создании задачи.

8. Антипаттерны

  • Удаление источника до завершения кодирования. delete не ждёт несвязанных параллельных ветвей. Если перекодирование и этот узел оба зависят от одного исходного URL, ставьте удаление ниже по потоку от каждого потребителя (обычно после финальной загрузки), а не параллельно — иначе кодер может обнаружить пропавший файл посреди чтения.
  • Удаление общих ассетов, используемых параллельными ветвями. Когда несколько уровней ABR читают из одного входного пакета, единичный delete на одной ветви удаляет файл, который другим уровням ещё нужен. Ставьте удаление после схождения ветвей или защитите его decide/eval, проверяющим, что каждый потребитель закончил.
  • Удаление выхода без версионирования. Раз пропав, доставленный файл невосстановим из процесса. Если системе ниже по потоку может понадобиться откат, отправьте файл в версионируемый или архивный бакет перед удалением, а не полагайтесь на воспроизведение кодером тех же байтов при повторе.
  • Использование delete, чтобы «починить» неудачную загрузку. delete лишь удаляет настроенный URL; он не повторяет загрузку, не помечает задачу неудачной и не notify операторов. Если доставка неверна, чините шаг загрузки (или его назначение) и дайте следующему прогону перезаписать начисто.

9. Заметки

  • Диалог настроек читается как Delete Node Settings.
  • Узел рисует один подключаемый вход Package слева и один выход Package справа. Оранжевый пин внизу слева несёт канал URL и не используется в стандартных графах перекодирования.
  • Этот узел только удаляет файлы. Процессам, которым нужно переместить файл (не оставляя копии в источнике), следует использовать выделенный узел move вместо цепочки download → upload → delete.
Медиа.маги Документация