# An example using multi-stage image builds to create a final image without uv.

# First, build the application in the `/app` directory.

# See `Dockerfile` for details.

FROM ghcr.io/astral-sh/uv:python3.12-trixie-slim AS builder

ENV UV_COMPILE_BYTECODE=1 UV_LINK_MODE=copy

# Omit development dependencies

ENV UV_NO_DEV=1

# Disable Python downloads, because we want to use the system interpreter

# across both images. If using a managed Python version, it needs to be

# copied from the build image into the final image; see `standalone.Dockerfile`

# for an example.

ENV UV_PYTHON_DOWNLOADS=0

WORKDIR /app

RUN --mount=type=cache,target=/root/.cache/uv \

--mount=type=bind,source=uv.lock,target=uv.lock \

--mount=type=bind,source=pyproject.toml,target=pyproject.toml \

uv sync --locked --no-install-project

COPY . /app

RUN --mount=type=cache,target=/root/.cache/uv \

uv sync --locked

# Then, use a final image without uv

FROM python:3.12-slim-trixie

# It is important to use the image that matches the builder, as the path to the

# Python executable must be the same, e.g., using `python:3.11-slim-trixie`

# will fail.

# Setup a non-root user

RUN groupadd --system --gid 999 nonroot \

&& useradd --system --gid 999 --uid 999 --create-home nonroot

# Copy the application from the builder

COPY --from=builder --chown=nonroot:nonroot /app /app

# Place executables in the environment at the front of the path

ENV PATH="/app/.venv/bin:$PATH"

# Keeps Python from buffering stdout and stderr to avoid situations where

# the application crashes without emitting any logs due to buffering.

ENV PYTHONUNBUFFERED=1

# Use the non-root user to run our application

USER nonroot

# Use `/app` as the working directory

WORKDIR /app

# Run the FastAPI application by default

CMD ["fastapi", "run", "--host", "0.0.0.0", "src/uv_docker_example"]