Dockerfile

# Note: Cyrille's branch at https://github.com/favreau/Brayns is used instead of https://github.com/BlueBrain/Brayns.git
# Docker container for running the BioExplorer as a plugin within Brayns as a service
# Check https://docs.docker.com/engine/userguide/eng-image/dockerfile_best-practices/#user for best practices.
# Based on the Dockerfile of Brayns created by the viz team (basically a copy)

# This Dockerfile leverages multi-stage builds, available since Docker 17.05
# See: https://docs.docker.com/engine/userguide/eng-image/multistage-build/#use-multi-stage-builds

# Image where Brayns+BioExplorer plugin is built
FROM debian:buster-slim as builder
LABEL maintainer="cyrille.favreau@epfl.ch"
ARG DIST_PATH=/app/dist

# Install packages
RUN apt-get update \
   && apt-get -y --no-install-recommends install \
   build-essential \
   cmake \
   git \
   ninja-build \
   libarchive-dev \
   libassimp-dev \
   libboost-date-time-dev \
   libboost-filesystem-dev \
   libboost-iostreams-dev \
   libboost-program-options-dev \
   libboost-regex-dev \
   libboost-serialization-dev \
   libboost-system-dev \
   libboost-test-dev \
   libfreeimage-dev \
   libhdf5-serial-dev \
   libtbb-dev \
   libturbojpeg0-dev \
   libuv1-dev \
   libpqxx-dev \
   pkg-config \
   wget \
   ca-certificates \
   libcgal-dev \
   libtiff-dev \
   && apt-get clean \
   && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*

# --------------------------------------------------------------------------------
# Get ISPC
# https://github.com/ispc/ispc/releases/download/v1.10.0/ispc-v1.10.0b-linux.tar.gz
# --------------------------------------------------------------------------------
ARG ISPC_VERSION=1.10.0
ARG ISPC_DIR=ispc-v${ISPC_VERSION}b-linux
ARG ISPC_PATH=/app/$ISPC_DIR

RUN mkdir -p ${ISPC_PATH} \
   && wget --no-verbose https://github.com/ispc/ispc/releases/download/v${ISPC_VERSION}/${ISPC_DIR}.tar.gz \
   && tar zxvf ${ISPC_DIR}.tar.gz -C ${ISPC_PATH} --strip-components=1 \
   && rm -rf ${ISPC_PATH}/${ISPC_DIR}/examples

# Add ispc bin to the PATH
ENV PATH $PATH:${ISPC_PATH}/bin

# --------------------------------------------------------------------------------
# Install embree
# https://github.com/embree/embree/releases
# --------------------------------------------------------------------------------
ARG EMBREE_VERSION=3.5.2
ARG EMBREE_FILE=embree-${EMBREE_VERSION}.x86_64.linux.tar.gz
RUN mkdir -p ${DIST_PATH} \
   && wget --no-verbose https://github.com/embree/embree/releases/download/v${EMBREE_VERSION}/${EMBREE_FILE} \
   && tar zxvf ${EMBREE_FILE} -C ${DIST_PATH} --strip-components=1 \
   && rm -rf ${DIST_PATH}/bin ${DIST_PATH}/doc

# --------------------------------------------------------------------------------
# Install OSPRay
# https://github.com/ospray/ospray/releases
# --------------------------------------------------------------------------------
ARG OSPRAY_TAG=v1.8.5
ARG OSPRAY_SRC=/app/ospray

RUN mkdir -p ${OSPRAY_SRC} \
   && git clone https://github.com/ospray/ospray.git ${OSPRAY_SRC} \
   && cd ${OSPRAY_SRC} \
   && git checkout ${OSPRAY_TAG} \
   && mkdir -p build \
   && cd build \
   && CMAKE_PREFIX_PATH=${DIST_PATH} cmake .. -GNinja \
   -DOSPRAY_ENABLE_TUTORIALS=OFF \
   -DOSPRAY_ENABLE_APPS=OFF \
   -DCMAKE_INSTALL_PREFIX=${DIST_PATH} \
   && ninja install

# --------------------------------------------------------------------------------
# Install libwebsockets (2.0 from Debian is not reliable)
# https://github.com/warmcat/libwebsockets/releases
# --------------------------------------------------------------------------------
ARG LWS_VERSION=2.3.0
ARG LWS_SRC=/app/libwebsockets
ARG LWS_FILE=v${LWS_VERSION}.tar.gz

RUN mkdir -p ${LWS_SRC} \
   && wget --no-verbose https://github.com/warmcat/libwebsockets/archive/${LWS_FILE} \
   && tar zxvf ${LWS_FILE} -C ${LWS_SRC} --strip-components=1 \
   && cd ${LWS_SRC} \
   && mkdir -p build \
   && cd build \
   && cmake .. -GNinja \
   -DCMAKE_BUILD_TYPE=Release \
   -DLWS_STATIC_PIC=ON \
   -DLWS_WITH_SSL=OFF \
   -DLWS_WITH_ZLIB=OFF \
   -DLWS_WITH_ZIP_FOPS=OFF \
   -DLWS_WITHOUT_EXTENSIONS=ON \
   -DLWS_WITHOUT_TESTAPPS=ON \
   -DLWS_WITH_LIBUV=ON \
   -DCMAKE_INSTALL_PREFIX=${DIST_PATH} \
   && ninja install

# --------------------------------------------------------------------------------
# Install Brayns
# https://github.com/favreau/Brayns
# --------------------------------------------------------------------------------
ARG BRAYNS_SRC=/app/brayns

RUN mkdir -p ${BRAYNS_SRC} \
   && git clone https://github.com/favreau/Brayns ${BRAYNS_SRC}

WORKDIR /app

# TODO: "|| exit 0"  hack to be removed as soon as MVDTool export issue is fixed.
RUN cksum ${BRAYNS_SRC}/.gitsubprojects \
   && cd ${BRAYNS_SRC} \
   && git submodule update --init --recursive \
   && mkdir -p build \
   && cd build \
   && CMAKE_PREFIX_PATH=${DIST_PATH}:${DIST_PATH}/lib/cmake/libwebsockets \
   cmake .. -Wno-dev \
   -DBRAYNS_BBIC_ENABLED=OFF \
   -DBRAYNS_BENCHMARK_ENABLED=OFF \
   -DBRAYNS_CIRCUITEXPLORER_ENABLED=OFF \
   -DBRAYNS_CIRCUITRENDERER_ENABLED=OFF \
   -DBRAYNS_CIRCUITINFO_ENABLED=OFF \
   -DBRAYNS_CIRCUITVIEWER_ENABLED=OFF \
   -DBRAYNS_DEFLECT_ENABLED=OFF \
   -DBRAYNS_DTI_ENABLED=OFF \
   -DBRAYNS_IBL_ENABLED=OFF \
   -DBRAYNS_MULTIVIEW_ENABLED=OFF \
   -DBRAYNS_OPENDECK_ENABLED=OFF \
   -DBRAYNS_OPTIX_ENABLED=OFF \
   -DBRAYNS_UNIT_TESTING_ENABLED=OFF \
   -DBRAYNS_VIEWER_ENABLED=OFF \
   -DBRAYNS_ASSIMP_ENABLED=ON \
   -DBRAYNS_OSPRAY_ENABLED=ON \
   -DBRAYNS_NETWORKING_ENABLED=ON \
   -DCLONE_SUBPROJECTS=ON \
   -DCMAKE_BUILD_TYPE=Release \
   -DCMAKE_INSTALL_PREFIX=${DIST_PATH} || exit 0

RUN cd ${BRAYNS_SRC}/build && make -j install VERBOSE=1

# --------------------------------------------------------------------------------
# Add BioExplorer and additional plugins
# --------------------------------------------------------------------------------
ARG BIOEXPLORER_SRC=/app/bioexplorer
ADD . ${BIOEXPLORER_SRC}

RUN rm -rf ${BIOEXPLORER_SRC}/docker && mkdir -p ${BIOEXPLORER_SRC}/docker \
   && cd ${BIOEXPLORER_SRC}/docker \
   && PATH=${ISPC_PATH}/bin:${PATH} CMAKE_PREFIX_PATH=${DIST_PATH} LDFLAGS="-lCGAL" cmake .. \
   -DBIOEXPLORER_UNIT_TESTING_ENABLED=OFF -DCGAL_DO_NOT_WARN_ABOUT_CMAKE_BUILD_TYPE=TRUE \
   -DCMAKE_INSTALL_PREFIX=${DIST_PATH} -DCMAKE_BUILD_TYPE=Release \
   && make -j install VERBOSE=1

# Final image, containing only Brayns and BioExplorer and libraries required to run it
FROM debian:buster-slim
ARG DIST_PATH=/app/dist

RUN apt-get update \
   && apt-get -y --no-install-recommends install \
   libarchive13 \
   libassimp4 \
   libboost-filesystem1.67.0 \
   libboost-program-options1.67.0 \
   libboost-regex1.67.0 \
   libboost-serialization1.67.0 \
   libboost-system1.67.0 \
   libboost-iostreams1.67.0 \
   libfreeimage3 \
   libgomp1 \
   libhdf5-103 \
   libturbojpeg0 \
   libuv1 \
   libcgal13 \
   libpqxx-6.2 \
   && apt-get clean \
   && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*

# The COPY command below will:
# 1. create a container based on the `builder` image (but do not start it)
#    Equivalent to the `docker create` command
# 2. create a new image layer containing the
#    /app/dist directory of this new container
#    Equivalent to the `docker copy` command.
COPY --from=builder ${DIST_PATH} ${DIST_PATH}

# Add binaries from dist to the PATH
ENV LD_LIBRARY_PATH $LD_LIBRARY_PATH:${DIST_PATH}/lib
ENV PATH ${DIST_PATH}/bin:$PATH

# Expose a port from the container
# For more ports, use the `--expose` flag when running the container,
# see https://docs.docker.com/engine/reference/run/#expose-incoming-ports for docs.
EXPOSE 8200

# When running `docker run -ti --rm -p 8200:8200 bioexplorer`,
# this will be the cmd that will be executed (+ the CLI options from CMD).
# To ssh into the container (or override the default entry) use:
# `docker run -ti --rm --entrypoint bash -p 8200:8200 bioexplorer`
# See https://docs.docker.com/engine/reference/run/#entrypoint-default-command-to-execute-at-runtime
# for more docs
ENTRYPOINT ["braynsService"]
CMD ["--http-server", ":8200", "--plugin", "mediaMaker", "--plugin", "BioExplorer"]