gnickensandClaude Opus 5
0526d34e42
Sets up the project skeleton: - FastAPI app factory with lifespan, request-id middleware, and RFC 9457 problem+json error handlers - Async SQLAlchemy 2.0 over MySQL (asyncmy), with a constraint naming convention in place before the first migration and async Alembic - Keycloak as a pure resource server: OIDC discovery, cached JWKS with rotation-aware refresh, and require_roles dependencies - Devcontainer running MySQL 8.4 and Keycloak 26.7 as compose siblings, with the realm (clients, roles, test users) imported on first boot - Test suite covering the endpoints plus the token validator itself, exercised against a locally generated RSA keypair - uv packaging, ruff, mypy --strict, pre-commit, Gitea CI, prod Dockerfile Two Keycloak-in-containers traps are handled explicitly and documented in the README: the issuer/internal-URL split (the browser sees localhost:8080, the API sees keycloak:8080) and the audience mapper that stops Keycloak issuing tokens with aud=account. The devices resource is a placeholder proving the routing -> auth -> ORM -> migration path end to end; replace it with the real domain. Co-Authored-By: Claude Opus 5 <[email protected]>
49 lines
1.3 KiB
Docker
49 lines
1.3 KiB
Docker
# Production image. Development uses .devcontainer/Dockerfile instead.
|
|
|
|
FROM python:3.13-slim-bookworm AS builder
|
|
|
|
COPY --from=ghcr.io/astral-sh/uv:0.9.7 /uv /usr/local/bin/uv
|
|
|
|
ENV UV_COMPILE_BYTECODE=1 \
|
|
UV_LINK_MODE=copy \
|
|
UV_PROJECT_ENVIRONMENT=/opt/venv
|
|
|
|
WORKDIR /build
|
|
|
|
# Dependencies resolve from the lockfile alone, so this layer stays cached
|
|
# across source-only changes.
|
|
COPY pyproject.toml uv.lock ./
|
|
RUN uv sync --frozen --no-dev --no-install-project
|
|
|
|
COPY src/ ./src/
|
|
COPY README.md ./
|
|
RUN uv sync --frozen --no-dev
|
|
|
|
|
|
FROM python:3.13-slim-bookworm AS runtime
|
|
|
|
RUN groupadd --system --gid 1001 app \
|
|
&& useradd --system --uid 1001 --gid app --create-home app
|
|
|
|
ENV PATH=/opt/venv/bin:$PATH \
|
|
PYTHONUNBUFFERED=1 \
|
|
PYTHONDONTWRITEBYTECODE=1
|
|
|
|
COPY --from=builder --chown=app:app /opt/venv /opt/venv
|
|
|
|
WORKDIR /app
|
|
COPY --chown=app:app alembic.ini ./
|
|
COPY --chown=app:app migrations/ ./migrations/
|
|
|
|
USER app
|
|
EXPOSE 8000
|
|
|
|
# Migrations are deliberately NOT run here: with more than one replica they
|
|
# would race. Run `alembic upgrade head` as a separate deploy step.
|
|
CMD ["gunicorn", "v2x_server.main:app", \
|
|
"--worker-class", "uvicorn.workers.UvicornWorker", \
|
|
"--workers", "4", \
|
|
"--bind", "0.0.0.0:8000", \
|
|
"--access-logfile", "-", \
|
|
"--timeout", "60"]
|