Configurer une ferme de rendu Blender Flamenco : Manager et Worker

Ce que vous apprendrez dans ce guide

Blender Flamenco propose un workflow permettant de répartir les tâches de rendu entre les composants Manager et Worker. Dans ce guide, nous expliquons pas à pas le rôle des fichiers de configuration de Manager et Worker, comment définir le chemin de stockage partagé et quels types de tâches les Worker peuvent recevoir. Nous abordons également le fonctionnement de la commande de rendu Blender et les points à vérifier lors de la configuration.

Manager gère les travaux, tandis que les Worker exécutent les tâches. L’état des travaux et celui des tâches sont suivis séparément ; par exemple, un travail peut être marqué comme terminé une fois toutes ses tâches exécutées avec succès. Parmi les commandes de Flamenco figurent le rendu Blender, la conversion d’une séquence d’images en vidéo avec FFmpeg et les opérations de gestion de fichiers.

Prérequis et fichiers de configuration

Les guides officiels ne précisent ni version de Blender particulière, ni package d’installation, ni exigence de compte, ni frais de licence. Nous ne supposons donc ici aucune version logicielle ou configuration matérielle spécifique. Les exemples partent du principe que vous disposez d’un environnement Flamenco permettant de modifier les configurations de Manager et Worker et de définir un espace de stockage partagé.

Manager lit ses réglages dans le fichier flamenco-manager.yaml, situé à côté de l’exécutable flamenco-manager. Lors du premier lancement de Manager, si ce fichier est absent, l’assistant de configuration s’ouvre. Worker lit ses principaux réglages dans le fichier flamenco-worker.yaml situé dans son répertoire de travail. Ce fichier principal peut être partagé par plusieurs Worker ; toutefois, les identifiants et la base de données des mises à jour des tâches sont propres à chaque Worker.

Configurer Manager et Worker

1. Créez le fichier de Manager. Utilisez l’assistant de configuration lors du premier démarrage. Si vous devez créer le fichier manuellement, l’exemple ci-dessous présente les réglages de base :

_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 définit le nom de Manager, tandis que database indique le chemin du fichier de base de données SQLite. Le réglage listen détermine l’adresse IP et le port sur lesquels Manager accepte les connexions. La documentation officielle précise que cette adresse sert à l’interface web, à l’API et au transfert de fichiers via Shaman, et qu’il s’agit du seul port nécessaire à Manager. autodiscoverable indique si les Worker du même réseau peuvent détecter automatiquement Manager.

local_manager_storage_path sert aux fichiers locaux de Manager, tandis que shared_storage_path désigne l’emplacement partagé auquel Manager et Worker accèdent pour les travaux et les fichiers de sortie. Dans un environnement réel, remplacez /path/to/storage par le chemin du stockage partagé utilisé. Le système de stockage Shaman est facultatif ; l’exemple l’active et indique des délais de nettoyage des fichiers.

1. Définissez la connexion du Worker et les types de tâches qu’il peut prendre en charge. Dans le fichier de configuration partagé du Worker, vous pouvez indiquer l’adresse de Manager et les types de tâches acceptés :

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

Si manager_url est vide ou supprimé, Worker essaie de détecter Manager sur le réseau. task_types limite les tâches qui peuvent lui être attribuées. La liste de l’exemple contient les types utilisés par les scripts de compilation de travaux par défaut ; si vos scripts produisent d’autres types, vérifiez la compatibilité de ce réglage. Une valeur de restart_exit_code différente de zéro permet de signaler que Worker peut être redémarré.

1. Conservez les fichiers propres à chaque Worker. Chaque Worker possède un fichier d’identifiants nommé flamenco-worker-credentials.yaml ainsi qu’une base de données flamenco-worker.sqlite, qui met en file d’attente les mises à jour des tâches lorsque Manager est inaccessible. Ces fichiers sont distincts du fichier de configuration principal et ne sont pas conçus pour être modifiés manuellement. Les emplacements par défaut indiqués dans le guide sont $HOME/.local/share/flamenco sous Linux, C:\Users\UserName\AppData\Local\Blender Foundation\Flamenco sous Windows et $HOME/Library/Application Support/Flamenco sous macOS.

2. Suivez un travail Blender. Les tâches de rendu Blender sont exécutées à l’aide de la commande blender-render. Elle utilise l’exécutable Blender, le fichier .blend à ouvrir et les arguments supplémentaires transmis par le script de compilation du travail. Si l’exécutable est défini comme blender, Worker recherche le programme ; sous Windows, il peut également s’appuyer sur l’association de fichiers .blend. Pendant le rendu, Worker transmet les images produites afin qu’elles puissent être affichées en aperçu côté Manager.

Les travaux et les tâches ont des états distincts. Les tâches en attente peuvent être attribuées aux Worker disponibles ; si elles réussissent toutes, le travail est terminé. Si une tâche échoue même après plusieurs tentatives sur différents Worker, le travail peut passer à l’état d’échec. Remettre en file d’attente un travail terminé replace toutes ses tâches dans la file ; pour un travail contenant des tâches inachevées, seules ces tâches sont remises en attente.

Conséquences pour les workflows d’architecture, d’intérieur et d’archviz

Les agences d’architecture et les équipes de visualisation qui utilisent Blender peuvent répartir les tâches de rendu en intégrant plusieurs Worker au même workflow. Limiter les types de tâches de chaque Worker permet de déterminer quels travaux les machines prennent en charge : rendu Blender, gestion de fichiers ou FFmpeg, par exemple. Pour les animations, la commande FFmpeg qui convertit une séquence d’images en vidéo fait également partie des options documentées.

L’accès aux fichiers et la compatibilité sont particulièrement importants lors de la configuration. Les fichiers .blend et les rendus doivent se trouver sur un stockage partagé accessible à Manager et aux Worker. De plus, les réglages de task_types doivent correspondre aux tâches générées par les scripts de compilation des travaux. Le guide indique que des échecs de tâches répétés peuvent être liés à un travail trop exigeant pour le matériel d’un Worker ; il est donc utile de surveiller l’état des travaux en échec. Comme la documentation ne précise ni les exigences matérielles, ni la compatibilité des versions de Blender, ni les coûts de licence, ces éléments doivent être vérifiés séparément pour l’environnement utilisé.

Erreurs fréquentes

• Utiliser un chemin de stockage incorrect : le répertoire de stockage local de Manager et l’espace de stockage partagé n’ont pas la même fonction. Définissez l’emplacement commun pour les fichiers de travail et les rendus.

• Un Worker ne reçoit aucune tâche : vérifiez les réglages manager_url et task_types, ainsi que les types de tâches générés par les scripts de compilation des travaux.

• Partager des fichiers propres à un Worker : les identifiants et la base de données des mises à jour des tâches sont propres à chaque Worker ; ne les confondez pas avec le fichier de configuration principal.

• Oublier une ancienne entrée lors d’une réinitialisation : pour réinitialiser un Worker, arrêtez-le, supprimez les fichiers locaux concernés et retirez également l’ancienne entrée du Worker dans l’interface web de Manager ; redémarrez ensuite Worker.

• Ajouter inutilement des réglages facultatifs : la configuration MQTT n’est pas obligatoire. Il est recommandé de ne pas ajouter cette section à la configuration si son utilité n’est pas connue.

Étapes suivantes

Commencez par vérifier la configuration de base avec Manager et un seul Worker. Confirmez ensuite que les fichiers de travail sont accessibles depuis le stockage partagé et que Worker reçoit les types de tâches attendus. Si vous devez convertir une séquence d’images en vidéo, en plus du rendu Blender, examinez les réglages de la commande frames-to-video. Sous Linux, vous pouvez également envisager le réglage facultatif oom_score_adjust : cette option est propre à Linux, accepte des valeurs comprises entre 0 et 1000 et a été ajoutée dans Flamenco v3.5.

Sources et licence

Ce tutoriel a été adapté en turc à partir des guides officiels de Flamenco, publiés sous une licence ouverte, sur la configuration de Manager et de Worker ainsi que sur les travaux, les tâches et les commandes.