10.1. Development и production образы

        base  (общее: python, venv, пользователь, переменные)
         │
         ├──► builder   (зависимости production)
         │      │
         │      ├──► test      (плюс dev-зависимости, прогон pytest)
         │      │
         │      └──► runtime   (production: только venv и код)
         │
         └──► dev       (плюс инструменты, UID разработчика)

FROM python:3.13-slim AS base
ENV PYTHONUNBUFFERED=1 PATH="/opt/venv/bin:$PATH"
WORKDIR /app

FROM base AS builder
RUN python -m venv /opt/venv
COPY requirements.txt .
RUN pip install -r requirements.txt

FROM builder AS dev
ARG UID=1000
ARG GID=1000
COPY requirements-dev.txt .
RUN pip install -r requirements-dev.txt
RUN groupadd -g ${GID} dev 2>/dev/null || true; \
    useradd -u ${UID} -g ${GID} -m dev 2>/dev/null || true
USER ${UID}:${GID}
CMD ["fastapi", "dev", "app/main.py", "--host", "0.0.0.0"]

FROM base AS runtime
RUN useradd --create-home --uid 10001 appuser
COPY --from=builder --chown=10001:10001 /opt/venv /opt/venv
COPY --chown=10001:10001 app/ ./app/
USER 10001:10001
CMD ["fastapi", "run", "app/main.py", "--port", "8000"]

# compose.yaml — база, production по умолчанию
services:
  api:
    build:
      context: .
      target: runtime
    image: myapp:local

# compose.override.yaml — разработка, подхватывается автоматически
services:
  api:
    build:
      target: dev
      args:
        UID: "${UID:-1000}"
        GID: "${GID:-1000}"
    volumes:
      - ./app:/app/app

mkdir -p /tmp/devprod/app && cd /tmp/devprod

cat > app/__init__.py <<'PY'
"""Пример разделения dev и production образов."""
PY

cat > app/main.py <<'PY'
"""Минимальное приложение, сообщающее о своём окружении."""
import os
import sys
from pathlib import Path


def report() -> None:
    print(f"  UID:      {os.getuid()}:{os.getgid()}")
    print(f"  Python:   {sys.version.split()[0]}")
    print(f"  код в образе: {(Path(__file__).stat().st_size)} байт")
    for tool in ("pytest", "ruff", "mypy", "ipython"):
        found = any((Path(p) / tool).exists() for p in os.environ["PATH"].split(":"))
        print(f"  {tool:<8} {'есть' if found else 'нет'}")


if __name__ == "__main__":
    report()
PY

cat > requirements.txt <<'EOF'
click==8.3.0
EOF

cat > requirements-dev.txt <<'EOF'
-r requirements.txt
pytest==9.1.1
ruff==0.16.0
EOF

cat > .dockerignore <<'EOF'
.git
__pycache__
*.py[cod]
.pytest_cache
Dockerfile
.dockerignore
EOF

cat > Dockerfile <<'EOF'
# syntax=docker/dockerfile:1

# ── Общая база: то, что нужно обоим образам ──
FROM python:3.13-slim AS base
ENV PYTHONUNBUFFERED=1 \
    PYTHONDONTWRITEBYTECODE=1 \
    PATH="/opt/venv/bin:$PATH"
WORKDIR /app

# ── Зависимости production ──
FROM base AS builder
RUN python -m venv /opt/venv
COPY requirements.txt .
RUN --mount=type=cache,target=/root/.cache/pip pip install -r requirements.txt

# ── Разработка: инструменты плюс UID разработчика ──
FROM builder AS dev
ARG UID=1000
ARG GID=1000
COPY requirements-dev.txt .
RUN --mount=type=cache,target=/root/.cache/pip pip install -r requirements-dev.txt
RUN groupadd -g ${GID} dev 2>/dev/null || true; \
    useradd -u ${UID} -g ${GID} -m -d /home/dev dev 2>/dev/null || true; \
    mkdir -p /home/dev && chown -R ${UID}:${GID} /home/dev /app
ENV HOME=/home/dev
USER ${UID}:${GID}
CMD ["python", "-m", "app.main"]

# ── Тесты: не попадают никуда ──
FROM dev AS test
COPY --chown=${UID}:${GID} app/ ./app/
RUN python -c "import pytest, ruff; print('инструменты на месте')"

# ── Production: последняя стадия, чтобы build без флагов давал её ──
FROM base AS runtime
RUN useradd --create-home --uid 10001 appuser
COPY --from=builder --chown=10001:10001 /opt/venv /opt/venv
COPY --chown=10001:10001 app/ ./app/
USER 10001:10001
CMD ["python", "-m", "app.main"]
EOF

echo "═══ сборка обеих стадий ═══"
docker build -q --target dev --build-arg UID="$(id -u)" --build-arg GID="$(id -g)" \
    -t devprod:dev . > /dev/null
docker build -q --target runtime -t devprod:prod . > /dev/null
echo "  собраны"

echo "═══ что внутри dev ═══"
docker run --rm devprod:dev

echo "═══ что внутри production ═══"
docker run --rm devprod:prod

═══ сборка обеих стадий ═══
  собраны
═══ что внутри dev ═══
  UID:      1000:1000
  Python:   3.13.9
  код в образе: 0 байт
  pytest   есть
  ruff     есть
  mypy     нет
  ipython  нет
═══ что внутри production ═══
  UID:      10001:10001
  Python:   3.13.9
  код в образе: 512 байт
  pytest   нет
  ruff     нет
  mypy     нет
  ipython  нет

cd /tmp/devprod
echo "═══ исполняемые файлы ═══"
for img in devprod:dev devprod:prod; do
    printf '  %-14s ' "$img"
    docker run --rm "$img" sh -c 'command -v pytest ruff 2>/dev/null | tr "\n" " "' 2>/dev/null
    echo
done

echo "═══ установленные пакеты ═══"
for img in devprod:dev devprod:prod; do
    n="$(docker run --rm "$img" pip list --format=freeze 2>/dev/null | wc -l)"
    printf '  %-14s пакетов: %-3s ' "$img" "$n"
    docker run --rm "$img" pip list --format=freeze 2>/dev/null \
        | grep -icE '^(pytest|ruff|coverage|iniconfig|pluggy)' \
        | xargs printf 'из них инструментов разработки: %s\n'
done

echo "═══ размеры ═══"
docker images --format '  {{.Repository}}:{{.Tag}}  {{.Size}}' | grep '^  devprod'

═══ исполняемые файлы ═══
  devprod:dev    /opt/venv/bin/pytest /opt/venv/bin/ruff 
  devprod:prod   
═══ установленные пакеты ═══
  devprod:dev    пакетов: 10  из них инструментов разработки: 5
  devprod:prod   пакетов: 3   из них инструментов разработки: 0
═══ размеры ═══
  devprod:dev   198MB
  devprod:prod  144MB

cd /tmp/devprod
echo "═══ сборка production с чистым кэшем ═══"
docker builder prune -af > /dev/null 2>&1
docker build --target runtime --progress plain -t devprod:prod . 2>&1 \
    | grep -cE 'requirements-dev|\[dev ' \
    | xargs printf '  упоминаний стадии dev в логе сборки: %s\n'

echo "═══ сборка dev ═══"
docker build --target dev --progress plain \
    --build-arg UID="$(id -u)" --build-arg GID="$(id -g)" -t devprod:dev . 2>&1 \
    | grep -cE 'requirements-dev' \
    | xargs printf '  установка dev-зависимостей: %s раз\n'

echo "═══ повторная сборка production ═══"
start="$(date +%s.%N)"
docker build -q --target runtime -t devprod:prod . > /dev/null
end="$(date +%s.%N)"
printf '  время: %.1f c (всё из кэша)\n' "$(awk -v a="$start" -v b="$end" 'BEGIN{print b-a}')"

═══ сборка production с чистым кэшем ═══
  упоминаний стадии dev в логе сборки: 0
═══ сборка dev ═══
  установка dev-зависимостей: 1 раз
═══ повторная сборка production ═══
  время: 0.3 c (всё из кэша)

cd /tmp/devprod
echo "═══ правим код ═══"
echo "# комментарий $(date +%s)" >> app/main.py

start="$(date +%s.%N)"
docker build -q --target runtime -t devprod:prod . > /dev/null
end="$(date +%s.%N)"
printf '  пересборка после правки кода: %.1f c\n' "$(awk -v a="$start" -v b="$end" 'BEGIN{print b-a}')"

echo "═══ правим requirements.txt ═══"
echo "# комментарий" >> requirements.txt
start="$(date +%s.%N)"
docker build -q --target runtime -t devprod:prod . > /dev/null
end="$(date +%s.%N)"
printf '  пересборка после правки зависимостей: %.1f c\n' "$(awk -v a="$start" -v b="$end" 'BEGIN{print b-a}')"
sed -i '$ d' requirements.txt

═══ правим код ═══
  пересборка после правки кода: 1.2 c
═══ правим requirements.txt ═══
  пересборка после правки зависимостей: 8.7 c

cd /tmp/devprod
cat > compose.yaml <<'EOF'
name: devprod

services:
  app:
    build:
      context: .
      target: runtime            # production по умолчанию
    image: devprod:compose
    command: ["python", "-m", "app.main"]
EOF

cat > compose.override.yaml <<'EOF'
# Разработка: подхватывается автоматически
services:
  app:
    build:
      target: dev
      args:
        UID: "${UID:-1000}"
        GID: "${GID:-1000}"
    volumes:
      - ./app:/app/app          # код приходит с host
EOF

printf 'UID=%s\nGID=%s\n' "$(id -u)" "$(id -g)" > .env

echo "═══ docker compose up (разработка) ═══"
docker compose run --rm --build -T app 2>/dev/null | head -6

echo "═══ -f compose.yaml (production) ═══"
docker compose -f compose.yaml run --rm --build -T app 2>/dev/null | head -6

═══ docker compose up (разработка) ═══
  UID:      1000:1000
  Python:   3.13.9
  код в образе: 512 байт
  pytest   есть
  ruff     есть
  mypy     нет
═══ -f compose.yaml (production) ═══
  UID:      10001:10001
  Python:   3.13.9
  код в образе: 512 байт
  pytest   нет
  ruff     нет
  mypy     нет

cd /tmp/devprod
printf '  разработка:  %s\n' \
    "$(docker compose config 2>/dev/null | grep -A5 'build:' | grep 'target:' | awk '{print $2}')"
printf '  production:  %s\n' \
    "$(docker compose -f compose.yaml config 2>/dev/null | grep -A5 'build:' | grep 'target:' | awk '{print $2}')"

  разработка:  dev
  production:  runtime

cd /tmp/devprod
docker compose up -d --build > /dev/null 2>&1 || true
echo "═══ до правки ═══"
docker compose run --rm -T app 2>/dev/null | grep Python

sed -i 's/print(f"  Python:   {sys.version.split()\[0\]}")/print(f"  Python:   {sys.version.split()[0]} (ПРАВКА НА HOST)")/' app/main.py

echo "═══ после правки, без пересборки ═══"
docker compose run --rm -T app 2>/dev/null | grep Python

echo "═══ а в production-образе — старая версия ═══"
docker compose -f compose.yaml run --rm -T app 2>/dev/null | grep Python

docker compose down > /dev/null 2>&1
cd /tmp && rm -rf /tmp/devprod

═══ до правки ═══
  Python:   3.13.9
═══ после правки, без пересборки ═══
  Python:   3.13.9 (ПРАВКА НА HOST)
═══ а в production-образе — старая версия ═══
  Python:   3.13.9

mkdir -p /tmp/dp && cd /tmp/dp
printf 'click==8.3.0\n' > requirements.txt
printf -- '-r requirements.txt\npytest==9.1.1\n' > requirements-dev.txt
cat > Dockerfile <<'EOF'
FROM python:3.13-slim AS base
ENV PATH="/opt/venv/bin:$PATH"
WORKDIR /app
FROM base AS builder
RUN python -m venv /opt/venv
COPY requirements.txt .
RUN pip install -q -r requirements.txt
FROM builder AS dev
COPY requirements-dev.txt .
RUN pip install -q -r requirements-dev.txt
CMD ["python", "-c", "print('dev')"]
FROM base AS runtime
COPY --from=builder /opt/venv /opt/venv
CMD ["python", "-c", "print('prod')"]
EOF
docker build -q --target runtime -t dp:prod . > /dev/null
docker run --rm dp:prod sh -c 'command -v pytest || echo "pytest отсутствует — верно"'
docker rmi -f dp:prod > /dev/null; cd /tmp && rm -rf /tmp/dp