Как настроить ферму рендеринга Blender Flamenco: Manager и Worker

Чему вы научитесь в этом руководстве?

Blender Flamenco позволяет распределять задачи рендеринга между компонентами Manager и Worker. В этом руководстве мы шаг за шагом рассмотрим назначение файлов конфигурации Manager и Worker, настройку пути к общему хранилищу и типы задач, которые могут выполнять Worker. Также расскажем, что делает команда рендеринга Blender и на какие параметры стоит обратить внимание при настройке.

Manager управляет заданиями, а Worker выполняют задачи. Статусы заданий и задач отслеживаются отдельно: например, задание может получить статус завершённого, когда все его задачи выполнены успешно. Среди команд Flamenco есть рендеринг Blender, преобразование последовательности изображений в видео с помощью FFmpeg и операции управления файлами.

Что понадобится и какие файлы конфигурации используются

В официальных руководствах не указаны конкретная версия Blender, установочный пакет, требования к учётной записи или лицензионная плата. Поэтому здесь не предполагаются определённые версии ПО или требования к оборудованию. Примеры рассчитаны на среду Flamenco, в которой можно редактировать конфигурации Manager и Worker и настроить общее хранилище.

Manager считывает настройки из файла flamenco-manager.yaml. Он находится рядом с исполняемым файлом flamenco-manager. Если при первом запуске Manager этого файла нет, открывается мастер настройки. Worker считывает основные настройки из файла flamenco-worker.yaml в своей рабочей директории. Этот основной файл могут использовать несколько Worker, однако у каждого Worker свои учётные данные и база данных обновлений задач.

Настройка Manager и Worker

1. Создайте файл Manager. При первом запуске воспользуйтесь мастером настройки. Если файл нужно подготовить вручную, пример ниже показывает основные параметры:

_meta:
  version: 3
manager_name: Flamenco Manager
database: flamenco-manager.sqlite
listen: ":8080"
autodiscoverable: true
local_manager_storage_path: ./flamenco-manager-storage
shared_storage_path: /path/to/storage
shaman:
  enabled: true
  garbageCollect:
    period: 24h
    maxAge: 744h

manager_name задаёт имя Manager, а database — путь к файлу базы данных SQLite. Параметр listen определяет, на каком IP-адресе и порту Manager принимает подключения. В официальной документации указано, что этот адрес используется веб-интерфейсом, API и Shaman для передачи файлов и является единственным портом, необходимым для Manager. Параметр autodiscoverable определяет, могут ли Worker в той же сети автоматически обнаруживать Manager.

local_manager_storage_path задаёт путь к локальным файлам Manager, а shared_storage_path — к заданиям и результатам, к которым совместно обращаются Manager и Worker. Замените /path/to/storage на путь к общему хранилищу в вашей среде. Система хранения Shaman необязательна; в примере она включена, а также указаны интервалы очистки файлов.

1. Настройте подключение Worker и типы задач. В общей конфигурации Worker можно указать адрес Manager и типы задач, которые он будет принимать:

manager_url: http://flamenco.local:8080/
task_types: [blender, ffmpeg, file-management, misc]
restart_exit_code: 47

Если manager_url не указан или оставлен пустым, Worker попытается найти Manager в сети. Параметр task_types ограничивает список задач, назначаемых Worker. В примере приведены типы, используемые сценариями сборки заданий по умолчанию; если ваши сценарии сборки используют другие типы, проверьте, что они соответствуют этому параметру. Ненулевое значение restart_exit_code позволяет пометить Worker как подлежащий перезапуску.

1. Храните отдельные файлы Worker. У каждого Worker есть файл учётных данных flamenco-worker-credentials.yaml и база данных flamenco-worker.sqlite, в которой в очередь ставятся обновления задач, если Manager недоступен. Эти файлы отделены от основного файла конфигурации и не предназначены для ручного редактирования. Пути по умолчанию, указанные в руководстве: в Linux — $HOME/.local/share/flamenco, в Windows — C:\Users\UserName\AppData\Local\Blender Foundation\Flamenco, в macOS — $HOME/Library/Application Support/Flamenco.

2. Отслеживайте задание Blender. Задачи рендеринга Blender выполняются командой blender-render. Она использует исполняемый файл Blender, открываемый файл .blend и дополнительные аргументы, переданные сценарием сборки задания. Если исполняемый файл задан как blender, Worker ищет программу самостоятельно; в Windows также может использоваться ассоциация файлов .blend. Во время рендеринга Worker передаёт созданные изображения, чтобы они отображались в Manager в виде предпросмотра.

Задания и задачи отслеживаются с разными статусами. Задачи в очереди могут назначаться подходящим Worker; если все задачи выполнены успешно, задание завершается. Если задача завершается ошибкой даже после повторных попыток на разных Worker, задание может получить статус ошибки. Повторная постановка завершённого задания в очередь возвращает в очередь все его задачи, а если в задании есть незавершённые задачи, повторно ставятся в очередь только они.

Как это влияет на архитектурные, интерьерные и archviz-процессы

Архитектурные бюро и команды визуализации, использующие Blender, могут подключить несколько Worker к одному рабочему процессу и распределять между ними задачи рендеринга. Ограничение типов задач для каждого Worker помогает контролировать, какие задачи выполняют компьютеры: рендеринг Blender, управление файлами или работу с FFmpeg. Для анимации среди документированных вариантов есть команда FFmpeg, преобразующая последовательность изображений в видео.

При настройке особенно важны доступ к файлам и совместимость. Файлы .blend и результаты рендеринга должны находиться в общем хранилище, доступном Manager и Worker. Кроме того, настройки task_types должны соответствовать задачам, создаваемым сценариями сборки заданий. В руководстве указано, что повторяющиеся ошибки задач могут быть связаны с тем, что задача слишком требовательна к оборудованию Worker; поэтому полезно отслеживать статусы ошибок. Поскольку в документации не приведены требования к оборудованию, совместимость с версиями Blender или стоимость лицензии, эти вопросы следует отдельно проверять для используемой среды.

Распространённые ошибки

• Неправильный путь к хранилищу: локальная директория хранения Manager и общее хранилище предназначены для разных целей. Укажите общий путь для файлов заданий и результатов рендеринга.

• Worker не получает задачи: проверьте параметры manager_url и task_types, а также типы задач, создаваемые сценариями сборки заданий.

• Совместное использование файлов, предназначенных для отдельных Worker: учётные данные и база данных обновлений задач принадлежат конкретному Worker; не путайте их с основным файлом конфигурации.

• Старая запись остаётся после сброса: чтобы сбросить Worker, остановите его, удалите соответствующие локальные файлы, а также удалите старую запись Worker в веб-интерфейсе Manager, затем перезапустите Worker.

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

Что делать дальше

Сначала проверьте базовую конфигурацию с одним Manager и одним Worker. Затем убедитесь, что файлы задания доступны из общего хранилища и Worker получает нужные типы задач. Если помимо Blender нужно преобразовать последовательность изображений в видео, изучите настройки команды frames-to-video. При использовании Linux также можно рассмотреть необязательный параметр oom_score_adjust: он доступен только в Linux, принимает значения от 0 до 1000 и появился во Flamenco v3.5.

Источник и лицензия

Это руководство адаптировано на турецкий язык на основе официальных руководств Flamenco с открытой лицензией, посвящённых конфигурации Manager и Worker, а также заданиям, задачам и командам.