blender-docker/README.md

Blender Docker

This repository is an automated blender docker image file generated, it's usefully with blender addon unit test. To build a new specific image, you need to update the build.json file with the new version witched ; or

Adding an Addon

Mount a new volume with your addon inside a folder (ex /blender-plugin/plugin-archive.zip), when you run your docker container add this volume and execute a script to add-it with the blender installed.

Python function to install an addon with Blender. The file his named install.py

import bpy
def b3d_install_addon():
    bpy.ops.preferences.addon_install(filepath='./plugin-archive.zip')
    bpy.ops.preferences.addon_enable(module='plugin-name')

if __name__ == '__main__':
    b3d_install_addon()

Call this function with blender inside this container

#!/bin/sh
/opt/blender/blender --background --python "install.py"

Check Image build

docker run --rm stilobique/blender:5.1.2 --version

# Taille de l'image
docker image inspect stilobique/blender:5.1.2 \
    --format='{{.Size}}' | numfmt --to=iec

# Dépendances manquantes
docker run --rm --entrypoint /bin/bash stilobique/blender:5.1.2 -c \
    'ldd /usr/local/bin/blender | grep "not found" || echo "All deps OK"'

# Test fonctionnel
docker run --rm stilobique/blender:5.1.2 \
    -b --python-expr "import bpy; print('OK:', bpy.app.version_string)"