Cómo configurar una granja de render de Blender Flamenco: Manager y Worker

¿Qué aprenderás en esta guía?

Blender Flamenco ofrece un flujo de trabajo para distribuir trabajos de render entre los componentes Manager y Worker. En esta guía veremos paso a paso para qué sirven los archivos de configuración de Manager y Worker, cómo definir la ruta de almacenamiento compartido y qué tipos de trabajos pueden recibir los Worker. También explicaremos qué hace el comando de render de Blender y qué aspectos conviene revisar durante la configuración.

Manager administra los trabajos y los Worker ejecutan las tareas. El estado de los trabajos y el de las tareas se supervisan por separado; por ejemplo, un trabajo puede marcarse como completado cuando sus tareas finalizan correctamente. Entre los comandos de Flamenco se encuentran el render de Blender, la conversión de una secuencia de imágenes a video con FFmpeg y las operaciones de gestión de archivos.

Requisitos y archivos de configuración

Las guías oficiales no especifican una versión concreta de Blender, un paquete de instalación, requisitos de cuenta ni tarifas de licencia. Por tanto, aquí no se presupone ninguna versión de software ni requisito de hardware en particular. Los ejemplos parten de que se dispone de un entorno Flamenco en el que se pueden editar las configuraciones de Manager y Worker y establecer un espacio de almacenamiento compartido.

Manager lee sus ajustes del archivo flamenco-manager.yaml, ubicado junto al ejecutable flamenco-manager. Si el archivo no existe al iniciar Manager por primera vez, se abre el asistente de configuración. Worker, por su parte, lee sus ajustes principales del archivo flamenco-worker.yaml, situado en el directorio desde el que se ejecuta. Este archivo principal se puede compartir entre varios Worker; sin embargo, las credenciales y la base de datos de actualizaciones de tareas son independientes para cada uno.

Configurar Manager y Worker

1. Crea el archivo de Manager. En el primer inicio, utiliza el asistente de configuración. Si necesitas preparar el archivo manualmente, el siguiente ejemplo muestra los ajustes básicos:

_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 define el nombre de Manager y database, la ruta del archivo de la base de datos SQLite. El ajuste listen especifica en qué IP y puerto aceptará conexiones Manager. La documentación oficial indica que esta dirección se utiliza para la interfaz web, la API y el envío de archivos mediante Shaman, y que es el único puerto necesario para Manager. autodiscoverable determina si los Worker de la misma red pueden encontrar Manager automáticamente.

local_manager_storage_path se utiliza para los archivos locales de Manager, mientras que shared_storage_path se emplea para los trabajos y resultados a los que acceden tanto Manager como Worker. En un entorno real, sustituye /path/to/storage por la ubicación compartida que vayas a utilizar. El sistema de almacenamiento Shaman es opcional; en el ejemplo está habilitado y se muestran los intervalos de limpieza de archivos.

1. Define la conexión y el alcance de las tareas de Worker. En el archivo de configuración compartido de Worker puedes indicar la dirección de Manager y los tipos de tareas que aceptará:

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

Si manager_url se deja vacío o se elimina, Worker intentará encontrar Manager en la red. task_types limita las tareas que se pueden asignar a Worker. La lista del ejemplo incluye los tipos que utilizan los scripts predeterminados de compilación de trabajos; si tus propios scripts generan otros tipos, comprueba que sean compatibles con estos ajustes. Un valor distinto de cero en restart_exit_code permite marcar Worker para que se pueda reiniciar.

1. Mantén separados los archivos específicos de cada Worker. Cada Worker tiene un archivo de credenciales llamado flamenco-worker-credentials.yaml y una base de datos flamenco-worker.sqlite que pone en cola las actualizaciones de tareas cuando no se puede acceder a Manager. Estos archivos son independientes de la configuración principal y no están pensados para editarse manualmente. Las ubicaciones predeterminadas indicadas en la guía son $HOME/.local/share/flamenco en Linux, C:\Users\UserName\AppData\Local\Blender Foundation\Flamenco en Windows y $HOME/Library/Application Support/Flamenco en macOS.

2. Sigue un trabajo de Blender. Las tareas de render de Blender se ejecutan con el comando blender-render. Este utiliza el ejecutable de Blender, el archivo .blend que se abrirá y los argumentos adicionales del script de compilación de trabajos. Si el ejecutable se especifica como blender, Worker buscará el programa; en Windows también puede recurrir a la asociación de archivos .blend. Las imágenes generadas durante el render se envían para que puedan mostrarse como vista previa en Manager.

Los trabajos y las tareas tienen estados diferentes. Las tareas en cola se pueden asignar a los Worker disponibles; cuando todas finalizan correctamente, el trabajo se completa. Si una tarea sigue fallando después de volver a intentarse en distintos Worker, el trabajo puede pasar al estado de fallo. Al volver a poner en cola un trabajo completado, se vuelven a poner en cola todas sus tareas; si el trabajo tiene tareas incompletas, solo se vuelven a poner en cola esas tareas.

Efectos en los flujos de trabajo de arquitectura, interiores y archviz

Los estudios de arquitectura y equipos de visualización que utilizan Blender pueden distribuir tareas de render al incorporar varios Worker al mismo flujo de trabajo. Limitar los tipos de tareas de cada Worker ayuda a organizar qué trabajos realizará cada máquina, como el render de Blender, la gestión de archivos o FFmpeg. Para las animaciones, entre las opciones documentadas también está el comando de FFmpeg, que convierte una secuencia de imágenes en video.

El acceso a los archivos y la compatibilidad son aspectos especialmente importantes durante la configuración. Los archivos .blend y los resultados del render deben estar en un almacenamiento compartido accesible para Manager y Worker. Además, los ajustes de task_types deben coincidir con las tareas que generan los scripts de compilación de trabajos. La guía señala que los fallos recurrentes de tareas pueden estar relacionados con que el trabajo resulte demasiado exigente para el hardware de un Worker; por ello, conviene hacer seguimiento de los estados de error. Como la documentación no proporciona requisitos de hardware, compatibilidad con versiones de Blender ni costes de licencia, estos aspectos deben verificarse por separado para el entorno utilizado.

Errores frecuentes

• Usar una ruta de almacenamiento incorrecta: el directorio de almacenamiento local de Manager y el espacio compartido no tienen la misma función. Define la ubicación compartida para los archivos de trabajo y los resultados del render.

• Que Worker no reciba tareas: comprueba los ajustes manager_url y task_types, así como los tipos de tareas que generan los scripts de compilación de trabajos.

• Compartir archivos específicos de Worker: las credenciales y la base de datos de actualizaciones de tareas son propias de cada Worker; no deben confundirse con el archivo de configuración principal.

• Dejar un registro antiguo al restablecer: para restablecer un Worker, apágalo, elimina los archivos locales correspondientes y borra también el registro antiguo de Worker en la interfaz web de Manager. Después, vuelve a iniciar Worker.

• Añadir innecesariamente ajustes opcionales: la configuración de MQTT no es obligatoria. Si no sabes para qué sirve, se recomienda no añadir esta sección a la configuración.

Próximos pasos

Empieza comprobando la configuración básica con Manager y un único Worker. Después, verifica que se pueda acceder a los archivos de trabajo desde el almacenamiento compartido y que Worker reciba los tipos de tareas previstos. Si necesitas convertir una secuencia de imágenes en video además de renderizar con Blender, revisa los ajustes del comando frames-to-video. En Linux también puedes considerar el ajuste opcional oom_score_adjust; esta opción es exclusiva de Linux, acepta valores de 0 a 1000 y se añadió en Flamenco v3.5.

Fuentes y licencia

Este tutorial se ha adaptado al turco a partir de las guías oficiales de Flamenco, de licencia abierta, sobre la configuración de Manager y Worker, y sobre trabajos, tareas y comandos.