Docker setup

.dockerignore

@@ -0,0 +1,34 @@
+# Keep the build context small and avoid baking secrets/dev artifacts into
+# image layers. The Dockerfile does `COPY . /src`, so anything not ignored
+# here ends up in the build stage.
+
+# Version control
+.git
+.jj
+
+# Local environment and secrets
+.env
+*.env
+!dev-template.env
+
+# Python virtualenv and caches
+.venv
+.*_cache
+__pycache__/
+*.egg-info/
+
+# Tooling and test artifacts
+.tox
+.coverage*
+coverage.xml
+
+# Generated/local runtime data
+run/
+
+# Docs build output
+docs/_build/
+
+# Docker files themselves don't belong in the image
+Dockerfile
+.dockerignore
+docker-compose*.yml

.github/workflows/ci.yml

@@ -40,13 +40,11 @@ jobs:
           - name: "zizmor"
             python: "3.14"
             tox: zizmor
-
     name: ${{ matrix.name }}
     runs-on: ubuntu-24.04
     permissions:
       contents: read
       id-token: write
-
     steps:
       - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
         with:
@@ -64,3 +62,39 @@ jobs:
         if: ${{ matrix.coverage }}
         with:
           use_oidc: true
+
+  publish:
+    name: "Publish image"
+    needs: main
+    if: ${{ github.event_name == 'push' }}
+    runs-on: ubuntu-24.04
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+        with:
+          persist-credentials: false
+      - uses: docker/login-action@650006c6eb7dba73a995cc03b0b2d7f5ca915bee # v4.2.0
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - uses: docker/metadata-action@80c7e94dd9b9319bd5eb7a0e0fe9291e23a2a2e9 # v6.1.0
+        id: meta
+        with:
+          images: ghcr.io/${{ github.repository }}
+          tags: |
+            type=raw,value=latest
+            type=sha,format=long
+      - uses: docker/setup-buildx-action@d7f5e7f509e45cec5c76c4d5afdd7de93d0b3df5 # v4.1.0
+      - uses: docker/build-push-action@f9f3042f7e2789586610d6e8b85c8f03e5195baf # v7.2.0
+        with:
+          context: .
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          build-args: |
+            GIT_SHA=${{ github.sha }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

Dockerfile

@@ -0,0 +1,121 @@
+FROM python:3.14.6-slim-trixie AS base
+
+# --------------------------------------------
+
+FROM base AS build
+SHELL ["sh", "-exc"]
+
+# Install uv (pinned for reproducible builds)
+COPY --from=ghcr.io/astral-sh/uv:0.11.21 /uv /usr/local/bin/uv
+
+# - Compile Python bytecode for faster app startup.
+# - Silence uv complaining about not being able to use hard links.
+# - Set the project virtualenv to /app.
+# - Pick a Python.
+# - Prevent uv from accidentally downloading isolated Python builds.
+ENV UV_COMPILE_BYTECODE=1 \
+    UV_LINK_MODE=copy \
+    UV_PROJECT_ENVIRONMENT=/app \
+    UV_PYTHON=/usr/local/bin/python \
+    UV_PYTHON_DOWNLOADS=never
+
+# Install app dependencies
+COPY pyproject.toml /_lock/
+COPY uv.lock /_lock/
+RUN --mount=type=cache,target=/root/.cache <<EOT
+cd /_lock
+uv sync \
+    --locked \
+    --no-dev \
+    --all-extras \
+    --no-install-project
+EOT
+
+# Install app
+COPY . /src
+RUN --mount=type=cache,target=/root/.cache <<EOT
+cd /src
+uv sync \
+    --locked \
+    --no-dev \
+    --all-extras \
+    --no-editable
+EOT
+
+# Collect static files
+ENV DJANGO_STATIC_ROOT=/app/static
+RUN <<EOT
+/app/bin/comics collectstatic --noinput
+/app/bin/comics compress
+EOT
+
+# --------------------------------------------
+
+FROM base AS runtime
+SHELL ["sh", "-exc"]
+
+# Runtime system dependencies.
+# psycopg (3) is installed without the bundled binary, so it needs the
+# system libpq library to talk to PostgreSQL.
+RUN <<EOT
+apt-get update -qq
+apt-get install -y --no-install-recommends libpq5
+rm -rf /var/lib/apt/lists/*
+EOT
+
+# Put installed Python packages in PATH
+ENV PATH=/app/bin:${PATH}
+
+# Make GIT_SHA from build-args available in the container's environment
+ARG GIT_SHA
+ENV GIT_SHA=${GIT_SHA}
+
+# OCI image metadata. CI's docker/metadata-action augments these with dynamic
+# values (created, version) at publish time.
+LABEL org.opencontainers.image.source="https://github.com/jodal/comics" \
+      org.opencontainers.image.url="https://github.com/jodal/comics" \
+      org.opencontainers.image.title="comics" \
+      org.opencontainers.image.description="Comics is a webcomics aggregator." \
+      org.opencontainers.image.licenses="AGPL-3.0-only" \
+      org.opencontainers.image.revision="${GIT_SHA}"
+
+# App settings
+ENV DJANGO_STATIC_ROOT=/app/static
+ENV DJANGO_MEDIA_ROOT=/media
+
+# Create app user
+RUN <<EOT
+groupadd -g 1000 app
+useradd -g 1000 -u 1000 -d /home/app -s /sbin/nologin app
+mkdir -p /home/app
+chown -R app:app /home/app
+EOT
+
+# Create app directory
+RUN <<EOT
+mkdir /app
+chown -R app:app /app
+EOT
+
+# Entrypoint
+COPY --chown=app:app ./docker-entrypoint.sh /
+ENTRYPOINT ["/docker-entrypoint.sh"]
+
+# Stop app with SIGINT (like Ctrl+C) instead of SIGTERM
+STOPSIGNAL SIGINT
+
+# Install app
+COPY --from=build --chown=app:app /app /app
+
+# Activate app user and change working directory
+# Use UID for compatibility with K8s's securityContext.runAsNonRoot
+USER 1000
+WORKDIR /app
+
+# Smoketest
+RUN <<EOT
+python -V
+python -Im site
+python -Ic 'import comics'
+python -Ic 'import psycopg'
+EOT

docker-compose.yml

@@ -0,0 +1,49 @@
+name: comics
+
+volumes:
+  postgres:
+  media:
+
+services:
+  postgres:
+    image: postgres:18
+    environment:
+      - POSTGRES_USER=comics
+      - POSTGRES_PASSWORD=comics
+      - POSTGRES_DB=comics
+    volumes:
+      - postgres:/var/lib/postgresql
+    command:
+      - postgres
+      - -cfsync=off
+      - -cfull_page_writes=off
+      - -csynchronous_commit=off
+    ports:
+      - "5432:5432"
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U comics -d comics"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+    restart: unless-stopped
+
+  web:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    image: comics:latest
+    depends_on:
+      postgres:
+        condition: service_healthy
+    env_file:
+      - path: .env
+        required: false
+    environment:
+      - DATABASE_URL=postgres://comics:comics@postgres:5432/comics
+      - PORT=8000
+    volumes:
+      - media:/media
+    command: web
+    ports:
+      - "8000:8000"
+    restart: unless-stopped

docker-entrypoint.sh

@@ -0,0 +1,25 @@
+#!/bin/bash
+set -e
+
+# Simplified entrypoints for the different services packaged in this
+# Docker image.
+
+if [ "$1" = "shell" ]; then
+    exec comics shell ${*:2}
+fi
+
+if [ "$1" = "dbshell" ]; then
+    exec comics dbshell ${*:2}
+fi
+
+if [ "$1" = "web" ]; then
+    comics migrate
+    exec gunicorn \
+        --worker-tmp-dir=/dev/shm \
+        --log-file=- \
+        --bind=0.0.0.0:${PORT:-8000} \
+        comics.wsgi \
+        ${*:2}
+fi
+
+exec "$@"