chore: Add docker build step

Author: lewisjared

.dockerignore

@@ -0,0 +1,17 @@
+.git
+.github
+.omc
+.venv
+.ruff_cache
+.pytest_cache
+.ipynb_checkpoints
+__pycache__
+*.py[cod]
+*.egg-info
+build
+dist
+climate_ref_client
+notebooks/output
+notebooks/data
+tests/test-data/sample-data
+.DS_Store

.github/workflows/docker.yaml

@@ -0,0 +1,60 @@
+name: Build and publish Docker image
+
+on:
+  push:
+    branches: [main]
+    tags: ["v*"]
+  pull_request:
+    paths:
+      - Dockerfile
+      - .dockerignore
+      - .binder/requirements.txt
+      - .github/workflows/docker.yaml
+  workflow_dispatch:
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - uses: actions/checkout@v6.0.2
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to GHCR
+        if: github.event_name != 'pull_request'
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract image metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=ref,event=branch
+            type=ref,event=pr
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=sha,format=short
+            type=raw,value=latest,enable={{is_default_branch}}
+
+      - name: Build and push
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: ${{ github.event_name != 'pull_request' }}
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

Dockerfile

@@ -0,0 +1,44 @@
+# Pre-built JupyterLab image for the Climate REF training notebooks.
+#
+# Mirrors the Binder/repo2docker setup in .binder/ so users can pull a ready
+# environment instead of waiting for Binder to build from scratch.
+#
+# Build:
+#   docker build -t ghcr.io/climate-ref/climate-ref-tutorials:dev .
+# Run:
+#   docker run --rm -p 8888:8888 ghcr.io/climate-ref/climate-ref-tutorials:dev
+
+FROM quay.io/jupyter/minimal-notebook:python-3.12
+
+LABEL org.opencontainers.image.source="https://github.com/Climate-REF/climate-ref-tutorials"
+LABEL org.opencontainers.image.description="JupyterLab environment for the Climate REF training notebooks"
+LABEL org.opencontainers.image.licenses="Apache-2.0"
+
+# Cartopy needs GEOS + PROJ system libraries (matches .binder/apt.txt).
+USER root
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends \
+        libgeos-dev \
+        libproj-dev \
+        proj-bin \
+        proj-data \
+    && apt-get clean \
+    && rm -rf /var/lib/apt/lists/*
+
+USER ${NB_UID}
+WORKDIR /home/${NB_USER}/work
+
+# Install pinned Python deps first so this layer caches across source edits.
+COPY --chown=${NB_UID}:${NB_GID} .binder/requirements.txt /tmp/requirements.txt
+RUN pip install --no-cache-dir uv \
+    && pip install --no-cache-dir -r /tmp/requirements.txt
+
+# Copy the rest of the repo and install the helper package + generated client.
+COPY --chown=${NB_UID}:${NB_GID} . .
+RUN pip install --no-cache-dir --no-deps . \
+    && bash scripts/generate_client.sh \
+    && python -c "from ref_tutorials import fetch_sample_data; fetch_sample_data()" \
+    && python -c "import matplotlib.pyplot as plt; plt.figure(); plt.text(0, 0, 'warm fonts'); plt.close('all')"
+
+# Use the non-interactive Agg backend by default (matches .binder/start).
+ENV MPLBACKEND=Agg

README.md

@@ -16,6 +16,18 @@ Binder builds the environment and opens JupyterLab; no local setup is required.
 
 This may take several minutes
 
+## Run with Docker (pre-built image)
+
+A pre-built JupyterLab image is published to the GitHub Container Registry
+on every push to `main` and on every release tag.
+No local Python setup is required.
+
+```bash
+docker run --rm -p 8888:8888 ghcr.io/climate-ref/climate-ref-tutorials:latest
+```
+
+Open the JupyterLab URL printed in the terminal (includes the access token).
+
 ## Run locally
 
 Requires [uv](https://docs.astral.sh/uv/), a Python Package Manager to create a local virtual environment.