Kurz gesagt
- Die Manager-Einstellungen stehen in der Datei flamenco-manager.yaml neben der ausführbaren Datei.
- Die Hauptkonfiguration des Workers kann geteilt werden; Anmeldedaten und Datenbank für Aufgabenaktualisierungen sind für jeden Worker individuell.
- Mit shared_storage_path greifen Manager und Worker auf gemeinsame Auftragsdateien zu.
- MQTT-Benachrichtigungen lassen sich über einen optionalen Abschnitt in der Manager-Konfiguration aktivieren.
Was lernen Sie in diesem Leitfaden?
In diesem Tutorial konfigurieren Sie die grundlegende Einrichtung einer Blender-Flamenco-Renderfarm. Sie erfahren, wo der Manager seine Einstellungen ausliest, wie sich Worker mit dem Manager verbinden, wozu der gemeinsame Speicherpfad dient und wie Sie MQTT-Benachrichtigungen aktivieren. Außerdem lernen Sie den Unterschied zwischen Worker-spezifischen Anmeldedaten und der gemeinsam nutzbaren Hauptkonfigurationsdatei kennen.
Der Flamenco Manager verwaltet Renderaufträge und Worker. Worker führen die Aufgabentypen aus, für die sie freigegeben sind. Die Konfigurationsdateien verwenden das YAML-Format. Dieser Leitfaden konzentriert sich auf die Einstellungen einer bestehenden Flamenco-Installation; er trifft keine Annahmen zu Installationsschritten oder Systemanforderungen, die in den Quellen nicht genannt werden.
Voraussetzungen und Speicherorte der Dateien
Die Konfigurationsdatei des Flamenco Managers heißt flamenco-manager.yaml und befindet sich neben der ausführbaren Manager-Datei. Gibt es die Datei beim ersten Start noch nicht, öffnet der Manager einen Einrichtungsassistenten, der sie erstellt. Falls der Assistent nicht verfügbar ist, kann die Konfiguration manuell erstellt werden.
Der Worker liest seine Haupteinstellungen aus der Datei flamenco-worker.yaml in seinem Arbeitsverzeichnis. Diese Datei kann von mehreren Workern gemeinsam verwendet werden. Die Datei flamenco-worker-credentials.yaml mit den Anmeldedaten des Workers sowie flamenco-worker.sqlite, in der Aufgabenaktualisierungen in eine Warteschlange gestellt werden, sind dagegen Workerspezifisch und nicht für die manuelle Bearbeitung vorgesehen.
Stellen Sie sicher, dass Sie auf die Manager- und Worker-Konfigurationsdateien zugreifen können, bevor Sie Einstellungen übernehmen. Wenn Sie gemeinsam genutzten Speicher verwenden, legen Sie fest, über welchen Pfad Manager und Worker auf die betreffenden Dateien zugreifen. Die Quellen nennen keine bestimmte Blender- oder Betriebssystemversion als allgemeine Voraussetzung. Die Option oom_score_adjust in der Worker-Konfiguration ist nur unter Linux verfügbar.
Manager- und Worker-Einstellungen Schritt für Schritt bearbeiten
Manager-Konfiguration öffnen oder erstellen. Starten Sie den Manager, damit der Einrichtungsassistent die Konfigurationsdatei erstellt, oder legen Sie
flamenco-manager.yamlneben der ausführbaren Datei an. Das folgende Beispiel enthält grundlegende Einstellungen sowie Beispielwerte für gemeinsam genutzten Speicher und das Shaman-Dateispeichersystem:
_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: 744hlisten legt die Adresse und den Port fest, über die der Manager seine Weboberfläche, API und Dateiübertragungen über Shaman bereitstellt. shared_storage_path gibt den Speicherort für Render-Ausgaben und .blend-Auftragsdateien an, den Manager und Worker gemeinsam nutzen. local_manager_storage_path ist für Dateien vorgesehen, die nur der Manager benötigt, etwa Logs und aktuelle Renderbilder. Ersetzen Sie den Platzhalter /path/to/storage im Beispiel durch den tatsächlichen Pfad zum gemeinsam genutzten Speicher.
Manager-Adresse und Aufgabentypen der Worker festlegen. In der Datei
flamenco-worker.yamlim Arbeitsverzeichnis jedes Workers lassen sich die Verbindung und die erlaubten Aufgabentypen eintragen:
manager_url: http://flamenco.local:8080/
task_types: [blender, ffmpeg, file-management, misc]
restart_exit_code: 47manager_url ist die Adresse des Managers, mit dem sich der Worker verbindet. Ist diese Einstellung leer oder nicht vorhanden, versucht der Worker, den Manager automatisch im Netzwerk zu finden. Die Liste task_types schränkt ein, welche Aufgabentypen der Worker ausführen kann; die verfügbaren Typen hängen von den Job-Compiler-Skripten ab. Ersetzen Sie die Beispieladresse durch die Adresse Ihres Managers und weisen Sie dem Worker nur die Typen zu, die er ausführen soll. Bei einem Wert ungleich null wird der Worker als neu startbar markiert.
Betriebssystemspezifische Werte festlegen. Mit dem Abschnitt
variablesin der Manager-Konfiguration lassen sich Werte für verschiedene Betriebssysteme separat angeben. Unter dem Namen einer Variablen wird eine Listevaluesangelegt. Jeder Eintrag enthält eine Plattform und den dazugehörigen Wert. Als Beispiele nennt die Quelle die Plattformenlinux,windows,darwinsowieallfür alle Plattformen. Unterscheidet sich beispielsweise der Blender-Aufruf je nach Betriebssystem, können Sie in diesem Abschnitt für jede Plattform den passenden Wert festlegen.Optionale MQTT-Benachrichtigungen hinzufügen. Der Manager kann interne Ereignisse an einen MQTT-Broker senden. Ergänzen Sie den folgenden Abschnitt in
flamenco-manager.yamlund starten Sie den Manager neu, damit die Änderung wirksam wird:
mqtt:
client:
broker: "tcp://mqttserver.local:1883"
username: "username"
password: "your-password-here"
topic_prefix: flamencoDie Broker-Adresse kann das Format tcp:// oder ws:// verwenden. Bei anonymem Zugriff können die Schlüssel username und password entfernt werden. topic_prefix legt das Präfix der Ereignis-Topics fest. Beim Beispielwert flamenco werden Job-Updates an das Topic flamenco/jobs gesendet. Ersetzen Sie den Beispiel-Benutzernamen, das Passwort und die Broker-Adresse durch die tatsächlichen Zugangsdaten. MQTT ist optional; bei Aktivierung muss der Manager neu gestartet werden.
Häufige Fehler und wichtige Hinweise
Gemeinsam genutzten und lokalen Speicher nicht verwechseln. Auftragsdateien und Render-Ausgaben müssen für Manager und Worker gemeinsam verfügbar sein; ihr Speicherort wird mit shared_storage_path festgelegt. Logs und aktuelle Renderbilder des Managers werden dagegen unter local_manager_storage_path gespeichert. Die beiden Einstellungen erfüllen unterschiedliche Zwecke.
Workerspezifische Dateien nicht mit gemeinsam genutzter Konfiguration verwechseln. Die Datei flamenco-worker.yaml kann geteilt werden; Anmeldedaten und die Datenbank für Aufgabenaktualisierungen sind jedoch für jeden Worker individuell. Wenn ein Worker zurückgesetzt werden muss, sollte er zuerst angehalten werden. Löschen Sie anschließend diese Dateien und entfernen Sie auch den alten Workereintrag in der Weboberfläche des Managers.
Timeout- und Fehlerparameter nur mit Verständnis ihrer Wirkung verwenden. task_timeout und worker_timeout im Manager bestimmen, wann ein Worker als problematisch oder als zeitüberschreitend gilt. blocklist_threshold kann verhindern, dass ein Worker, der bei bestimmten Aufgaben eines Jobs scheitert, weitere Aufgaben desselben Typs in diesem Job erhält. task_fail_after_softfail_count legt fest, wie viele Worker eine Aufgabe erfolglos abschließen dürfen, bevor sie endgültig als fehlgeschlagen gilt. Wenn Sie Probleme in der Renderfarm untersuchen, ist es wichtig zu wissen, was diese Einstellungen verändern.
MQTT nur hinzufügen, wenn es benötigt wird. Der offizielle Konfigurationsleitfaden empfiehlt, den entsprechenden Abschnitt leer zu lassen, wenn der Zweck von MQTT unklar ist. Bei aktiviertem MQTT kann der Manager Ereignisse zum Lebenszyklus, Status der Renderfarm, Aufträgen, Aufgaben, Workern und aktuellen Renderbildern an die festgelegten Topics senden.
Auswirkungen auf Architektur, Innenarchitektur und Archviz-Workflows
Architektur- und Visualisierungsteams, die Blender-Renderings auf mehreren Rechnern erstellen, sollten bei der Einrichtung der Aufgabenverteilung mit Flamenco zuerst den gemeinsamen Dateipfad und die Worker-Berechtigungen festlegen. Ein gemeinsam genutzter Speicher für Auftragsdateien und Ausgaben ist wichtig, damit Manager und Worker auf dieselben Auftragsinhalte zugreifen können. Mit task_types lässt sich festlegen, welche Aufgabentypen ein Worker übernimmt.
Die optionale Einstellung oom_score_adjust in der Worker-Konfiguration bestimmt unter Linux, wie Worker-Unterprozesse bei Speichermangel bewertet werden. Laut Quelle kann diese Einstellung einen Wert zwischen 0 und 1000 annehmen. Bei einem höheren Wert soll Blender bei erschöpftem Arbeitsspeicher während des Renderings vor dem Flamenco Worker beendet werden. Teams sollten diese Option nur dann in Betracht ziehen, wenn sie Linux verwenden und das beschriebene Verhalten zu ihrer Arbeitslast passt. Der Leitfaden enthält weder Hardware-Kaufempfehlungen noch Angaben zu Lizenzpreisen.
Nächste Schritte
Prüfen Sie zunächst die Verbindung zwischen Manager und Worker und danach den Pfad zum gemeinsam genutzten Speicher. Legen Sie anschließend fest, welche Aufgabentypen die Worker erhalten sollen, und kontrollieren Sie, ob die Adressen und Beispielwerte in der Konfiguration zu Ihrer tatsächlichen Umgebung passen. Wenn Sie MQTT benötigen, tragen Sie die Broker-Zugangsdaten ein und starten Sie den Manager neu. Clients, die Ereignisse empfangen, müssen das konfigurierte Topic-Präfix und die von Flamenco verwendeten Topic-Namen berücksichtigen.
Quelle und Lizenz
Dieses Tutorial wurde auf Grundlage der offiziellen Flamenco-Leitfäden „Manager Configuration“, „Worker Configuration“ und „Manager Configuration: MQTT“ ins Deutsche übertragen. Alle drei Quellen sind in den bereitgestellten Quellenangaben mit lisans=serbest gekennzeichnet.
Quellen
3 QuellenQuelltexte werden nicht neu veröffentlicht; kurze Zitate sind gekennzeichnet, der Rest ist eigene Zusammenfassung und Einordnung.
Für kleine und mittlere Visualisierungsteams in der Türkei kann die flexible Konfiguration von Flamenco praktisch sein, um vorhandene Rechner nach Aufgabentypen zu organisieren. Vor allem die korrekte Einrichtung des gemeinsamen Speicherpfads und der Worker-Berechtigungen von Anfang an kann dazu beitragen, Render-Aufträge im Team planbarer auszuführen.
Der Leitfaden enthält allerdings keine Angaben zu Hardwarekosten oder Lizenzpreisen. Eine Entscheidung sollte daher anhand der vorhandenen Arbeitslast und Infrastruktur getroffen werden. Auch MQTT ist nicht für jedes Team erforderlich. Ein vorsichtiges Vorgehen wäre, zunächst die grundlegende Verbindung zwischen Manager und Worker sowie den Dateizugriff zu prüfen und MQTT erst bei Bedarf zur Überwachung einzurichten.
Häufige Fragen
Wo befindet sich die Konfigurationsdatei des Flamenco Managers?
Der Manager liest seine Einstellungen aus der Datei `flamenco-manager.yaml`. Sie befindet sich neben der ausführbaren Datei `flamenco-manager`.
Kann die Flamenco-Worker-Konfiguration mit anderen Workern geteilt werden?
Die Datei `flamenco-worker.yaml` im Arbeitsverzeichnis des Workers kann geteilt werden. Dateien mit Anmeldedaten und Aufgabenaktualisierungen sind dagegen für jeden Worker individuell.
Wie wird MQTT in Flamenco aktiviert?
Fügen Sie der Datei `flamenco-manager.yaml` einen Konfigurationsabschnitt `mqtt` hinzu und starten Sie den Manager neu. Die Broker-Adresse kann das Format `tcp://` oder `ws://` verwenden.



