Wave 11 — the three candidates: CLI — lawsynth simplify (egraph equality saturation extracts the lowest-cost EQUIVALENT law; proves equivalence by simulating both worlds, deviation ~0; honest 'already minimal' on sparse discovered worlds); lawsynth compose (union two worlds into a coupled system, namespacing collisions) and lawsynth edit (immutable rename/set-param/drop-law/scale-law, re-validated). SDK — lawsynth.simplify / World.simplify (stdlib expand/fold/combine + equivalence verify), lawsynth.compose, World.rename/set_parameter/drop_law/ scale_law. Two runnable examples. Deploy — a verifiable hosted-deploy story: deploy/quickstart (config-validated minimal api+gateway) + docs/self-hosting/quickstart.md (real curl/Client run loop), after fixing genuine drift in the compose files (SQLite URL the API actually accepts, correct token env, object root, health endpoints, native build step) — verified end-to-end from source. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
106 lines
4.8 KiB
Docker
106 lines
4.8 KiB
Docker
# syntax=docker/dockerfile:1.7
|
|
#
|
|
# LawSynth quickstart image — the smallest thing that actually serves a
|
|
# discovery over HTTP.
|
|
#
|
|
# Unlike the stock `deploy/docker/images/api.Dockerfile`, this image bundles the
|
|
# *compiled* `lawsynth` engine. That matters: the API's product surface imports
|
|
# `lawsynth.report` at module load, and `POST /v1/runs` runs native discovery
|
|
# in-process, so without the engine the API cannot import and every run returns
|
|
# `503 native_unavailable`. This image therefore compiles the PyO3 extension
|
|
# (`lawsynth._native`) from the Rust workspace, then installs the pure-Python
|
|
# domain core, API, and gateway on top of it.
|
|
#
|
|
# A single image runs BOTH services in the quickstart compose profile:
|
|
# * the API — `gunicorn lawsynth_api.main:application` (:8080)
|
|
# * the gateway — `gunicorn wsgi_gateway:application` (:8081)
|
|
#
|
|
# Build (from the repository root — the Rust build needs the whole workspace):
|
|
# docker build -f deploy/quickstart/Dockerfile -t lawsynth-quickstart:local .
|
|
#
|
|
# The first build compiles the numeric Rust crates and takes several minutes.
|
|
|
|
# ---- native: compile the lawsynth._native extension against CPython 3.12 ----
|
|
#
|
|
# We build in a python:3.12 base (not a rust base) so pyo3-build-config resolves
|
|
# the *same* CPython ABI the runtime stage uses; a mismatch would make the
|
|
# extension unimportable. This mirrors python/lawsynth/scripts/build-native.sh:
|
|
# a plain `cargo build -p lawsynth-python` yields exactly the cdylib maturin
|
|
# would, which we drop next to the pure-Python `lawsynth` package.
|
|
FROM python:3.12-slim-bookworm AS native
|
|
|
|
ENV RUSTUP_HOME=/usr/local/rustup \
|
|
CARGO_HOME=/usr/local/cargo \
|
|
PATH=/usr/local/cargo/bin:${PATH}
|
|
|
|
RUN apt-get update \
|
|
&& apt-get install --no-install-recommends -y \
|
|
curl build-essential pkg-config ca-certificates \
|
|
&& rm -rf /var/lib/apt/lists/* \
|
|
&& curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs \
|
|
| sh -s -- -y --default-toolchain 1.94.0 --profile minimal
|
|
|
|
WORKDIR /src
|
|
COPY . .
|
|
|
|
# `.cargo/config.toml` may pin registry mirrors that are unavailable offline;
|
|
# the Rust service images drop it too. `lawsynth-python` is a cdylib named
|
|
# `_native`, so the release artifact is target/release/lib_native.so.
|
|
RUN rm -f .cargo/config.toml \
|
|
&& cargo build -p lawsynth-python --release \
|
|
&& SUFFIX="$(python3 -c 'import sysconfig; print(sysconfig.get_config_var("EXT_SUFFIX"))')" \
|
|
&& cp target/release/lib_native.so "python/lawsynth/src/lawsynth/_native${SUFFIX}" \
|
|
&& PYTHONPATH=python/lawsynth/src python3 -c "import lawsynth; _ = lawsynth.World; print('native ok', lawsynth.__version__)"
|
|
|
|
# ---- runtime: minimal, non-root --------------------------------------------
|
|
FROM python:3.12-slim-bookworm AS runtime
|
|
|
|
# curl backs the container HEALTHCHECK.
|
|
RUN apt-get update \
|
|
&& apt-get install --no-install-recommends -y curl \
|
|
&& rm -rf /var/lib/apt/lists/* \
|
|
&& groupadd --gid 65532 lawsynth \
|
|
&& useradd --uid 65532 --gid 65532 --home-dir /var/lib/lawsynth --create-home lawsynth \
|
|
&& mkdir -p /data/objects \
|
|
&& chown -R 65532:65532 /data
|
|
|
|
# Pure-Python packages: domain core, WSGI API (with gunicorn), admission gateway.
|
|
COPY python/lawsynth-server /opt/lawsynth/python/lawsynth-server
|
|
COPY services/api /opt/lawsynth/services/api
|
|
COPY services/gateway /opt/lawsynth/services/gateway
|
|
RUN pip install --no-cache-dir \
|
|
/opt/lawsynth/python/lawsynth-server \
|
|
"/opt/lawsynth/services/api[server]" \
|
|
/opt/lawsynth/services/gateway
|
|
|
|
# The compiled `lawsynth` package (pure-Python tree + the _native.so built
|
|
# above) is provided on PYTHONPATH rather than pip-installed, so no maturin is
|
|
# needed at image-build time.
|
|
COPY --from=native /src/python/lawsynth/src /opt/lawsynth/pysrc
|
|
|
|
# Gateway WSGI shim: wrap the co-located API in the admission layer.
|
|
COPY deploy/quickstart/wsgi_gateway.py /opt/lawsynth/wsgi_gateway.py
|
|
|
|
ENV PYTHONUNBUFFERED=1 \
|
|
PYTHONDONTWRITEBYTECODE=1 \
|
|
PYTHONPATH=/opt/lawsynth:/opt/lawsynth/pysrc \
|
|
LAWSYNTH_API_ENV=production \
|
|
LAWSYNTH_DATABASE_URL=sqlite:////data/metadata.sqlite3 \
|
|
LAWSYNTH_OBJECT_ROOT=/data/objects
|
|
|
|
WORKDIR /opt/lawsynth
|
|
USER 65532:65532
|
|
EXPOSE 8080 8081
|
|
|
|
# Default to the API; the gateway service overrides the command in compose.
|
|
# GET /v1/health is unauthenticated and reports database + storage readiness.
|
|
HEALTHCHECK --interval=15s --timeout=5s --start-period=20s --retries=5 \
|
|
CMD curl -fsS http://127.0.0.1:8080/v1/health || exit 1
|
|
|
|
# One gunicorn worker: the alpha domain repositories and the in-process
|
|
# discovery/event bus are process-local (see services/api/README.md), so a
|
|
# single worker keeps runs, worlds, and their SSE stream coherent.
|
|
CMD ["gunicorn", "--bind", "0.0.0.0:8080", "--workers", "1", "--timeout", "180", \
|
|
"--graceful-timeout", "30", "--access-logfile", "-", "--error-logfile", "-", \
|
|
"lawsynth_api.main:application"]
|