Blender-Flamenco-Renderfarm einrichten: Manager und Worker konfigurieren

Was erfahren Sie in diesem Leitfaden?

Blender Flamenco bietet einen Workflow, um Renderjobs auf die Komponenten Manager und Worker zu verteilen. In diesem Leitfaden erklären wir Schritt für Schritt, wozu die Konfigurationsdateien von Manager und Worker dienen, wie sich ein gemeinsamer Speicherpfad festlegen lässt und welche Arten von Aufgaben Worker übernehmen können. Außerdem gehen wir darauf ein, was der Blender-Renderbefehl macht und welche Punkte bei der Konfiguration zu prüfen sind.

Der Manager verwaltet die Jobs, während die Worker die Aufgaben ausführen. Job- und Aufgabenstatus werden getrennt erfasst. Ein Job kann beispielsweise als abgeschlossen gelten, wenn alle zugehörigen Aufgaben erfolgreich beendet wurden. Zu den Flamenco-Befehlen gehören Blender-Rendering, das Umwandeln einer Bildsequenz in ein Video mit FFmpeg und Dateiverwaltung.

Voraussetzungen und Konfigurationsdateien

Die offiziellen Anleitungen nennen weder eine bestimmte Blender-Version noch ein Installationspaket, Kontoanforderungen oder Lizenzgebühren. Daher wird hier keine bestimmte Softwareversion oder Hardwarevoraussetzung angenommen. Die Beispiele setzen eine Flamenco-Umgebung voraus, in der sich die Manager- und Worker-Konfiguration bearbeiten und gemeinsamer Speicher einrichten lässt.

Der Manager bezieht seine Einstellungen aus der Datei flamenco-manager.yaml. Sie befindet sich neben der ausführbaren Datei flamenco-manager. Wird der Manager zum ersten Mal gestartet und existiert diese Datei noch nicht, öffnet sich der Konfigurationsassistent. Der Worker liest seine Haupteinstellungen aus der Datei flamenco-worker.yaml im Verzeichnis, aus dem er gestartet wird. Diese Hauptdatei kann von mehreren Workern gemeinsam genutzt werden; die Zugangsdaten und die Datenbank für Aufgabenaktualisierungen sind jedoch für jeden Worker separat.

Manager und Worker konfigurieren

1. Manager-Datei erstellen. Nutzen Sie beim ersten Start den Konfigurationsassistenten. Falls Sie die Datei manuell anlegen müssen, zeigt das folgende Beispiel die grundlegenden Einstellungen:

_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 legt den Namen des Managers fest, database den Dateipfad zur SQLite-Datenbank. Die Einstellung listen definiert, über welche IP-Adresse und welchen Port der Manager Verbindungen annimmt. Laut offizieller Dokumentation wird diese Adresse für die Weboberfläche, die API und die Dateiübertragung über Shaman verwendet; sie ist der einzige Port, den der Manager benötigt. Mit autodiscoverable legen Sie fest, ob Worker im selben Netzwerk den Manager automatisch finden können.

Für lokale Manager-Dateien wird local_manager_storage_path verwendet, für Jobs und Ausgaben, auf die Manager und Worker gemeinsam zugreifen, hingegen shared_storage_path. Ersetzen Sie den Beispielpfad /path/to/storage durch den gemeinsam genutzten Speicherort Ihrer Umgebung. Das Shaman-Speichersystem ist optional. Im Beispiel ist es aktiviert und es sind Zeiträume für die Dateibereinigung angegeben.

1. Worker-Verbindung und Aufgabenumfang festlegen. In der gemeinsamen Worker-Konfigurationsdatei können Sie die Manager-Adresse und die zulässigen Aufgabentypen definieren:

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

Ist manager_url leer oder nicht vorhanden, versucht der Worker, den Manager im Netzwerk zu finden. Mit task_types begrenzen Sie, welche Aufgaben dem Worker zugewiesen werden dürfen. Die Liste im Beispiel enthält die Typen, die von den standardmäßigen Job-Compiler-Skripten verwendet werden. Erzeugen Ihre eigenen Job-Compiler-Skripte andere Typen, prüfen Sie, ob diese Einstellung dazu passt. Ein Wert ungleich null für restart_exit_code kennzeichnet den Worker als neu startbar.

1. Worker-spezifische Dateien aufbewahren. Jeder Worker verfügt über eine Zugangsdatendatei namens flamenco-worker-credentials.yaml und eine Datenbank flamenco-worker.sqlite, in der Aufgabenaktualisierungen in die Warteschlange gestellt werden, wenn der Manager nicht erreichbar ist. Diese Dateien sind von der Hauptkonfigurationsdatei getrennt und nicht für die manuelle Bearbeitung vorgesehen. Die Standardpfade laut Anleitung sind unter Linux $HOME/.local/share/flamenco, unter Windows C:\Users\UserName\AppData\Local\Blender Foundation\Flamenco und unter macOS $HOME/Library/Application Support/Flamenco.

2. Einen Blender-Job verfolgen. Blender-Renderaufgaben werden mit dem Befehl blender-render ausgeführt. Der Befehl verwendet die Blender-Programmdatei, die zu öffnende .blend-Datei und zusätzliche Argumente aus dem Job-Compiler-Skript. Ist die ausführbare Datei als blender angegeben, sucht der Worker das Programm. Unter Windows kann er auch die Dateizuordnung für .blend nutzen. Die während des Renderings erzeugten Bilder werden vom Worker so übermittelt, dass sie im Manager als Vorschau angezeigt werden können.

Jobs und Aufgaben werden mit unterschiedlichen Statuswerten verfolgt. Aufgaben in der Warteschlange können geeigneten Workern zugewiesen werden. Sind alle Aufgaben erfolgreich, wird der Job abgeschlossen. Scheitert eine Aufgabe auch nach mehreren Versuchen auf verschiedenen Workern, kann der Job den Status „fehlgeschlagen“ erhalten. Wird ein abgeschlossener Job erneut in die Warteschlange gestellt, werden alle Aufgaben neu eingereiht. Bei einem Job mit noch nicht abgeschlossenen Aufgaben werden hingegen nur diese Aufgaben erneut eingereiht.

Auswirkungen auf Architektur-, Innenraum- und Archviz-Workflows

Architekturbüros und Visualisierungsteams, die Blender verwenden, können mehrere Worker in denselben Workflow einbinden und Renderaufgaben verteilen. Durch eine Einschränkung der Aufgabentypen jedes Workers lässt sich steuern, welche Aufgaben die Rechner übernehmen – etwa Blender-Rendering, Dateiverwaltung oder FFmpeg. Für Animationen zählt auch der FFmpeg-Befehl zum Umwandeln einer Bildsequenz in ein Video zu den dokumentierten Optionen.

Beim Einrichten sind Dateizugriff und Kompatibilität besonders wichtig. .blend-Dateien und Renderausgaben müssen in einem gemeinsamen Speicher liegen, auf den Manager und Worker zugreifen können. Außerdem müssen die Einstellungen für task_types zu den von den Job-Compiler-Skripten erzeugten Aufgaben passen. Laut Anleitung können wiederholte Aufgabenfehler darauf hindeuten, dass ein Job die Hardware eines Workers zu stark beansprucht. Daher ist es hilfreich, den Fehlerstatus von Jobs im Blick zu behalten. Da die Dokumentation keine Hardwareanforderungen, Blender-Versionskompatibilität oder Lizenzkosten nennt, sollten diese Punkte für die jeweilige Umgebung separat geprüft werden.

Häufige Fehler

• Falschen Speicherpfad verwenden: Das lokale Speicherverzeichnis des Managers und der gemeinsame Speicher haben unterschiedliche Zwecke. Legen Sie für Jobdateien und Renderausgaben den gemeinsamen Speicherort fest.

• Worker erhält keine Aufgaben: Prüfen Sie manager_url und task_types sowie die von den Job-Compiler-Skripten erzeugten Aufgabentypen.

• Worker-spezifische Dateien gemeinsam nutzen: Zugangsdaten und die Datenbank für Aufgabenaktualisierungen sind an den jeweiligen Worker gebunden und dürfen nicht mit der Hauptkonfigurationsdatei verwechselt werden.

• Beim Zurücksetzen einen alten Eintrag stehen lassen: Muss ein Worker zurückgesetzt werden, fahren Sie ihn herunter, löschen Sie die zugehörigen lokalen Dateien und entfernen Sie den alten Workereintrag in der Manager-Weboberfläche. Starten Sie anschließend den Worker neu.

• Optionale Einstellungen unnötig hinzufügen: Eine MQTT-Konfiguration ist nicht erforderlich. Wenn Sie nicht wissen, wofür sie verwendet wird, sollten Sie diesen Abschnitt nicht in die Konfiguration aufnehmen.

Nächste Schritte

Prüfen Sie zunächst die Grundkonfiguration mit einem Manager und einem einzelnen Worker. Stellen Sie anschließend sicher, dass die Jobdateien über den gemeinsamen Speicher erreichbar sind und der Worker die erwarteten Aufgabentypen erhält. Wenn Sie außerhalb von Blender eine Bildsequenz in ein Video umwandeln müssen, sehen Sie sich die Einstellungen des Befehls frames-to-video an. Unter Linux lässt sich auch die optionale Einstellung oom_score_adjust berücksichtigen. Diese Option ist Linux-spezifisch, akzeptiert Werte von 0 bis 1000 und wurde in Flamenco v3.5 hinzugefügt.

Quelle und Lizenz

Dieses Tutorial wurde anhand der offiziell veröffentlichten, offen lizenzierten Anleitungen zu Flamenco-Manager-Konfiguration, Worker-Konfiguration sowie Jobs, Aufgaben und Befehlen ins Türkische übertragen und lokalisiert.