Automatically build docker images for each Brian release

.github/workflows/publish_to_pypi.yml → .github/workflows/publish.yml

@@ -1,4 +1,4 @@
-name: Build and publish to TestPyPI or PyPI
+name: Build and publish
 on: [push, pull_request]
 
 jobs:
@@ -130,3 +130,61 @@ jobs:
           path: dist/
       - name: Publish distribution release 📦 to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1
+
+  build-docker:
+    name: Build docker image for release
+    runs-on: ubuntu-latest
+    environment: release
+    needs: build-linux
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+      # https://github.com/actions/checkout/
+    - name: Docker meta
+      id: meta
+      uses: docker/metadata-action@v5
+      # https://github.com/docker/metadata-action
+      with:
+        images: |
+          briansimulator/brian
+        flavor: latest=true
+        tags: |
+          # type=semver,pattern={{raw}}
+          type=ref,event=tag
+        labels: |
+          org.opencontainers.image.title="Brian Docker Image"
+          org.opencontainers.image.description="Docker image for Brian - a free, open source simulator for spiking neural networks"
+          org.opencontainers.image.url=https://hub.docker.com/r/briansimulator/brian
+          org.opencontainers.image.source=https://github.com/brian-team/brian2
+    - name: Set up QEMU
+      uses: docker/setup-qemu-action@v3
+      # https://github.com/docker/setup-qemu-action
+      with:
+        platforms: 'amd64,arm64'
+    - name: Set up Docker Buildx
+      uses: docker/setup-buildx-action@v3
+      # https://github.com/docker/setup-buildx-action
+    - name: Login to DockerHub
+      uses: docker/login-action@v3
+      # https://github.com/docker/login-action
+      with:
+        username: ${{ secrets.DOCKERHUB_USERNAME }}
+        password: ${{ secrets.DOCKERHUB_TOKEN }}
+    - name: load distribution 📦
+      uses: actions/download-artifact@v4
+      with:
+        name: packages
+        pattern: "*cp312*.whl"
+        path: dist/
+    - name: Build (and potentially push) the Docker image
+      uses: docker/build-push-action@v5
+      # https://github.com/docker/build-push-action
+      with:
+        context: .
+        file: docker/Dockerfile
+        build-args: |
+            'BASE_IMAGE_TAG=3.12-bookworm'
+        platforms: 'amd64,arm64'
+        push: github.repository == 'brian-team/brian2' && startsWith(github.ref, 'refs/tags')
+        tags: ${{ steps.meta.outputs.tags }}
+        labels: ${{ steps.meta.outputs.labels }}

README.rst

@@ -23,6 +23,9 @@ Stimberg, M, Brette, R, Goodman, DFM. “Brian 2, an Intuitive and Efficient Neu
 .. image:: https://img.shields.io/conda/vn/conda-forge/brian2.svg
         :target: https://anaconda.org/conda-forge/brian2
 
+.. image:: https://github.com/brian-team/brian2/actions/workflows/publish.yml/badge.svg
+   :target: https://github.com/brian-team/brian2/actions/workflows/publish.yml
+   :alt: Publish status on GitHub Actions
 
 .. image:: https://img.shields.io/debian/v/python3-brian/testing
    :alt: Debian package
@@ -40,6 +43,9 @@ Stimberg, M, Brette, R, Goodman, DFM. “Brian 2, an Intuitive and Efficient Neu
    :alt: AUR version   
    :target: https://aur.archlinux.org/packages/python-brian2
 
+.. image:: https://img.shields.io/docker/pulls/briansimulator/brian
+   :alt: Docker Pulls
+
 
 .. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.8099373.svg
    :target: https://doi.org/10.5281/zenodo.8099373

docker/Dockerfile

@@ -0,0 +1,62 @@
+# docker buildx build --push --platform linux/amd64,linux/arm64/v8 -o type=image -t briansimulator/brian -f docker/Dockerfile .
+# docker run -it --init --rm -p 8888:8888 briansimulator/brian
+
+ARG BASE_IMAGE_TAG=3.12-slim-bookworm
+FROM python:${BASE_IMAGE_TAG}
+
+LABEL maintainer="Ben Evans <[email protected]>" \
+    org.opencontainers.image.vendor="The Brian Development Team" \
+    org.opencontainers.image.licenses="CeCILL 2.1" \
+    org.opencontainers.image.title="Brian Docker Image" \
+    org.opencontainers.image.description="Docker image for Brian - a free, open source simulator for spiking neural networks" \
+    org.opencontainers.image.homepage="https://briansimulator.org" \
+    org.opencontainers.image.url="https://hub.docker.com/r/briansimulator/brian" \
+    org.opencontainers.image.source="https://github.com/brian-team/brian2" \
+    org.opencontainers.image.documentation="https://brian2.readthedocs.io/"
+
+# Install dependencies
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    g++ \
+    git \
+    sudo \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy wheels into the image
+COPY dist /tmp/dist
+
+# Install Brian2 and recommended packages
+ARG TARGETARCH
+RUN pip install --no-cache-dir --only-binary=:all: \
+    scipy \
+    matplotlib \
+    jupyterlab \
+    pytest \
+    pytest-xdist \
+    && if [ "${TARGETARCH}" = "arm64" ]; then WHEEL_ARCH=aarch64; else WHEEL_ARCH=x86_64; fi \
+    && pip install /tmp/dist/Brian2*_${WHEEL_ARCH}.whl brian2tools \
+    && rm -rf /tmp/dist
+
+# Create a non-root user
+ARG USER="monty" \
+    GROUP="monty" \
+    PASSWORD="monty"
+RUN groupadd ${GROUP} && \
+    useradd -ms /bin/bash -g ${GROUP} -G sudo ${USER} && \
+    echo "${USER}:${PASSWORD}" | chpasswd
+ENV HOME="/home/${USER}"
+RUN chown -R ${USER}:${USER} ${HOME}
+USER ${USER}
+
+# Copy tutorial notebooks and example scripts to home directory
+WORKDIR ${HOME}
+RUN git clone https://github.com/brian-team/brian2.git \
+    && mv brian2/examples examples \
+    && mv brian2/tutorials tutorials \
+    && chmod -R +x tutorials \
+    && chmod -R +x examples \
+    && find . -name '*.ipynb' -exec jupyter trust {} \; \
+    && rm -rf brian2
+
+EXPOSE 8888
+CMD ["jupyter", "lab", "--ip=0.0.0.0", "--no-browser"]

docker/README.md

@@ -0,0 +1,26 @@
+Instructions
+============
+
+To build the image manually for testing on a local host for the native architecture:
+
+`docker build -t briansimulator/brian -f docker/Dockerfile .`
+
+Alternatively, to test multi-architecture builds and push to docker hub, first login:
+
+`docker login`
+
+Then execute:
+
+`docker buildx build --push --platform linux/amd64,linux/arm64/v8 -o type=image -t briansimulator/brian -f docker/Dockerfile .`
+
+Finally, to run the image:
+
+`docker run -it --init -p 8888:8888 briansimulator/brian`
+
+Or if you prefer a simple `bash` terminal rather than JupyterLab:
+
+`docker run -it --init briansimulator/brian /bin/bash`
+
+Or to run the tests:
+
+`docker run -it --init --rm briansimulator/brian python -c 'import brian2; brian2.test(test_standalone="cpp_standalone")'`