Dernières actualités
Réglages Lumen dans Unreal Engine : guide de l’éclairage intérieurIntel Nova Lake-S repéré dans un test avec 28 cœurs et 5,2 GHzCréer une vidéo d’architecture avec Veo 3.1 : du prompt à la mise en scènePréparer les UV de lightmap de Blender à Unreal Engine : guide pas à pasCADQuader passe en bêta : conversion des fichiers STEP et IGES en quad meshesPréparer une planche architecturale dans Rhino 8 : guide Layout, Detail et PDFCréer des visuels architecturaux avec Images 2.6 : du prompt aux retouches maîtriséesLe Théâtre Royal de Rabat achevé : un design inspiré des rives du BouregregTransférer une scène USD de Blender vers Unreal Engine : guide pas à pasInkling 2 Mini est disponible : une architecture bouclée pensée pour l’exécution locale
TutorielsBlenderFlamenco

Comment configurer Blender Flamenco ? Guide Manager, Worker et MQTT

Ce guide explique comment modifier les fichiers de configuration du Manager et des Workers dans Blender Flamenco. Il aborde également le stockage partagé, les types de tâches et les notifications MQTT facultatives.

Des stations de travail de rendu autour d’un modèle architectural communImage IA
Image d’illustration générée par IA.Image : 3dsınıfı / FCA AI

En bref

  1. Les paramètres du Manager se trouvent dans le fichier flamenco-manager.yaml, à côté de l’exécutable.
  2. La configuration principale du Worker peut être partagée ; ses identifiants et sa base de données de mises à jour des tâches lui sont propres.
  3. Utilisez shared_storage_path pour que le Manager et les Workers accèdent aux mêmes fichiers de travail.
  4. Les notifications MQTT s’activent en ajoutant une section facultative à la configuration du Manager.

Ce que vous allez apprendre

Dans ce tutoriel, vous allez configurer les éléments de base d’une ferme de rendu Blender Flamenco. Vous découvrirez où le Manager récupère ses paramètres, comment les Workers se connectent au Manager, à quoi sert le chemin de stockage partagé et comment activer les notifications MQTT. Vous apprendrez également à distinguer les identifiants propres à chaque Worker du fichier principal de paramètres, qui peut être partagé.

Le Manager Flamenco est le composant qui gère les tâches de rendu et les Workers. Ces derniers exécutent les types de tâches qui leur sont autorisés. Les fichiers de configuration sont au format YAML. Ce guide porte sur les paramètres d’une installation Flamenco existante ; il ne formule aucune supposition sur les étapes d’installation ni sur des exigences système qui ne sont pas mentionnées dans les sources.

Prérequis et emplacement des fichiers

Le fichier de configuration du Manager Flamenco s’appelle flamenco-manager.yaml et se trouve à côté de l’exécutable du Manager. S’il n’existe pas au premier démarrage, le Manager ouvre un assistant de configuration pour le créer. Si cet assistant n’est pas disponible, le fichier peut être créé manuellement.

Le Worker lit ses paramètres principaux dans le fichier flamenco-worker.yaml, situé dans son répertoire de travail. Ce fichier peut être partagé entre plusieurs Workers. En revanche, flamenco-worker-credentials.yaml, qui contient les identifiants du Worker, et flamenco-worker.sqlite, qui met en file d’attente les mises à jour des tâches, sont propres à chaque Worker et ne sont pas conçus pour être modifiés manuellement.

Avant d’appliquer les paramètres, vérifiez que vous avez accès aux fichiers de configuration du Manager et des Workers. Si vous utilisez un stockage partagé, déterminez le chemin vers lequel le Manager et les Workers devront accéder aux fichiers concernés. Les sources ne présentent aucune version particulière de Blender ou de système d’exploitation comme exigence générale. L’option oom_score_adjust de la configuration Worker est, quant à elle, disponible uniquement sous Linux.

Modifier pas à pas les paramètres du Manager et des Workers

  1. Ouvrez ou créez la configuration du Manager. Vous pouvez lancer le Manager pour que l’assistant de configuration crée le fichier, ou ajouter flamenco-manager.yaml à côté de l’exécutable. L’exemple ci-dessous comprend des paramètres de base, ainsi que des valeurs d’exemple pour le stockage partagé et le système de stockage de fichiers Shaman :

yaml
_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

listen définit l’adresse d’écoute et le port utilisés par le Manager pour son interface web, son API et l’envoi de fichiers via Shaman. shared_storage_path indique l’emplacement des fichiers de travail .blend et des rendus que le Manager et les Workers utilisent en commun. local_manager_storage_path est réservé aux fichiers dont le Manager a besoin seul, comme les journaux et les dernières images rendues. Remplacez le chemin fictif /path/to/storage de l’exemple par le chemin réel du stockage partagé.

  1. Définissez l’adresse du Manager et les types de tâches des Workers. Dans le fichier flamenco-worker.yaml du répertoire de travail de chaque Worker, vous pouvez spécifier les paramètres de connexion et les types de tâches autorisés :

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

manager_url est l’adresse du Manager auquel le Worker se connectera. Si ce paramètre est vide ou supprimé, le Worker tente de détecter automatiquement le Manager sur le réseau. La liste task_types limite les types de tâches que le Worker peut exécuter ; les types disponibles dépendent des scripts de compilation des tâches. Remplacez l’adresse de l’exemple par celle de votre Manager et n’autorisez que les types dont le Worker doit s’occuper. Lorsque restart_exit_code est différent de zéro, le Worker peut être signalé comme pouvant être redémarré.

  1. Définissez les valeurs qui varient selon le système d’exploitation. La section variables de la configuration du Manager permet de spécifier séparément les valeurs à utiliser sur différents systèmes d’exploitation. Sous le nom de variable, créez une liste values ; chaque entrée contient une plateforme et la valeur correspondante. Les plateformes données en exemple dans la source sont linux, windows, darwin et all, qui couvre toutes les plateformes. Par exemple, si la commande de lancement de Blender varie selon le système d’exploitation, vous pouvez définir dans cette section la valeur adaptée à chaque plateforme.

  2. Ajoutez des notifications MQTT si nécessaire. Le Manager peut transmettre ses événements internes à un broker MQTT. Ajoutez la section suivante à flamenco-manager.yaml, puis redémarrez le Manager pour appliquer la modification :

yaml
mqtt:
  client:
    broker: "tcp://mqttserver.local:1883"
    username: "username"
    password: "your-password-here"
    topic_prefix: flamenco

L’adresse du broker peut être au format tcp:// ou ws://. Si l’accès anonyme est utilisé, vous pouvez supprimer les clés username et password. topic_prefix définit le préfixe des noms de topics auxquels les événements sont envoyés ; avec la valeur d’exemple flamenco, les mises à jour des tâches sont envoyées au topic flamenco/jobs. Remplacez le nom d’utilisateur, le mot de passe et l’adresse du broker de l’exemple par vos véritables informations de connexion. La configuration MQTT est facultative ; si vous l’activez, vous devez redémarrer le Manager.

Erreurs fréquentes et points de vigilance

Ne confondez pas stockage partagé et stockage local. Les fichiers de travail et les rendus sont des contenus auxquels le Manager et les Workers doivent pouvoir accéder ; leur emplacement est défini par shared_storage_path. Les journaux et les dernières images rendues propres au Manager sont stockés sous local_manager_storage_path. Ces deux paramètres ont des usages différents.

Ne considérez pas les fichiers propres aux Workers comme une configuration commune. Le fichier flamenco-worker.yaml peut être partagé, mais les identifiants et la base de données des mises à jour des tâches sont propres à chaque Worker. Pour réinitialiser un Worker, il faut d’abord l’arrêter, supprimer ces fichiers et également supprimer l’ancienne entrée du Worker dans l’interface web du Manager.

Comprenez les paramètres de délai d’expiration et d’échec avant de les utiliser. task_timeout et worker_timeout dans le Manager servent à déterminer si un Worker est considéré comme défaillant ou en dépassement de délai. blocklist_threshold peut empêcher un Worker qui a échoué sur certains types de tâches d’un job de recevoir d’autres tâches du même type pour ce job. task_fail_after_softfail_count définit combien de Workers peuvent échouer sur une tâche avant que celle-ci soit considérée comme définitivement en échec. Il est important de comprendre les effets de ces paramètres pour diagnostiquer les problèmes d’une ferme de rendu.

N’ajoutez pas MQTT si vous n’en avez pas besoin. Le guide officiel de configuration recommande de laisser la section correspondante vide si vous ne connaissez pas l’utilité de MQTT. Lorsqu’il est activé, le Manager peut envoyer aux topics définis des événements liés à son cycle de vie, à l’état de la ferme, aux jobs, aux tâches, aux Workers et aux dernières images rendues.

Effets sur les workflows d’architecture, de décoration intérieure et d’archviz

Pour les équipes d’architecture et de visualisation qui effectuent des rendus Blender sur plusieurs machines, il est préférable de commencer par définir clairement le chemin de stockage partagé et les types de tâches autorisés pour les Workers. Le recours à un stockage partagé pour les fichiers de travail et les rendus permet au Manager et aux Workers d’accéder au même contenu. Le paramètre task_types aide à déterminer les types de tâches qu’un Worker peut prendre en charge.

L’option oom_score_adjust de la configuration Worker est facultative et définit, sous Linux, la manière dont les processus enfants du Worker sont évalués en cas de manque de mémoire. Selon la source, elle peut prendre une valeur comprise entre 0 et 1000. En augmentant cette valeur, l’objectif est que Blender soit arrêté avant Flamenco Worker lorsque la mémoire vient à manquer pendant le rendu. Les équipes ne devraient envisager cette option que si elles utilisent Linux et si le comportement indiqué convient à leur charge de travail. Le guide ne donne aucun conseil d’achat de matériel ni aucun prix de licence.

Étapes suivantes

Commencez par vérifier la connexion entre le Manager et les Workers, puis le chemin du stockage partagé. Déterminez ensuite les types de tâches à attribuer aux Workers et vérifiez que les adresses et les valeurs d’exemple utilisées dans la configuration correspondent à votre environnement réel. Si vous avez besoin de MQTT, ajoutez les informations d’accès au broker et redémarrez le Manager. Les clients qui écoutent les événements doivent tenir compte du préfixe de topic configuré et des noms de topics utilisés par Flamenco.

Sources et licence

Ce tutoriel a été adapté en turc à partir des guides officiels de Blender Flamenco « Manager Configuration », « Worker Configuration » et « Manager Configuration: MQTT ». Les informations fournies indiquent que les trois sources sont sous licence=libre.

Sources

3 sources
F
flamenco.blender.orgflamenco.blender.org/usage/manager-configuration
Résumé
F
flamenco.blender.orgflamenco.blender.org/usage/worker-configuration
Résumé
F
flamenco.blender.orgflamenco.blender.org/usage/manager-configuration/mqtt
Résumé

Les textes sources ne sont pas republiés ; les courtes citations sont signalées, le reste est notre propre résumé et commentaire.

L’avis de 3dsınıfı
3dL’analyse de la rédaction

Pour les petites et moyennes équipes de visualisation en Turquie, la souplesse de configuration de Flamenco peut être pratique pour organiser les machines existantes en fonction des types de tâches. Définir correctement dès le départ le chemin de stockage partagé et les autorisations des Workers peut contribuer à rendre l’exécution des rendus au sein de l’équipe plus prévisible.

Cela dit, le guide ne fournit aucune information sur le coût du matériel ni sur le prix des licences ; la décision doit donc être évaluée au regard de la charge de travail et de l’infrastructure existantes. MQTT n’est pas non plus indispensable à toutes les équipes. Une approche plus prudente consiste à commencer par vérifier la connexion Manager-Worker et l’accès aux fichiers, puis à activer MQTT si un besoin de suivi le justifie.

Questions fréquentes

Où se trouve le fichier de configuration du Manager Flamenco ?

Les paramètres du Manager sont lus dans `flamenco-manager.yaml`. Le fichier se trouve à côté de l’exécutable `flamenco-manager`.

La configuration d’un Worker Flamenco peut-elle être partagée avec d’autres Workers ?

Le fichier `flamenco-worker.yaml` du répertoire de travail du Worker peut être partagé. Les fichiers contenant les identifiants et les mises à jour des tâches sont, eux, propres à chaque Worker.

Comment activer MQTT dans Flamenco ?

Ajoutez une section de configuration `mqtt` au fichier `flamenco-manager.yaml`, puis redémarrez le Manager. L’adresse du broker peut être au format `tcp://` ou `ws://`.

Les commentaires et le forum sont en turc.Rejoindre la discussion
+

À lire aussi