$ sudo teach IT
Модуль 3 · В работе · Урок 3.3

uv в Docker и CI

Вы увидите, как выглядит uv в Dockerfile и в GitHub Actions, и поймёте каждую строку.

Теория + практика~5 минутНовичок

Вернёмся к banner и посмотрим, как он живёт не на вашем ноутбуке, а в коробке и у робота. Запускать ничего не нужно, просто читаем.

Docker: коробка с программой

Docker упаковывает программу со всем нужным в «коробку» (образ), которая одинаково работает везде. Описание коробки — Dockerfile:

Dockerfile
FROM python:3.15-slim-trixie
COPY --from=ghcr.io/astral-sh/uv:0.13.9 /uv /uvx /bin/
COPY . /app
ENV UV_NO_DEV=1
WORKDIR /app
RUN uv sync --locked
CMD ["uv", "run", "banner"]

Разбор по строкам

  • FROM python:3.15-slim-trixie — готовая коробка с Python 3.15, как в проекте.
  • COPY --from=ghcr.io/astral-sh/uv:0.13.9 /uv /uvx /bin/ — кладём в образ uv, версия указана точно.
  • COPY . /app — копируем проект в коробку.
  • ENV UV_NO_DEV=1 — без dev-пакетов: pytest в образ не попадёт.
  • WORKDIR /app — дальше работаем в этой папке.
  • RUN uv sync --locked — ставим строго по uv.lock; устарел он — будет ошибка.
  • CMD ["uv", "run", "banner"] — запускаем ту же команду, что в терминале.

Если поменять pyproject.toml, а uv.lock не обновить:

Терминал
$ uv sync --locked
Вывод
Resolved 8 packages in 4ms
error: The lockfile at `uv.lock` needs to be updated, but `--locked` was provided.

hint: To update the lockfile, run `uv lock`.

CI: робот, который проверяет каждый push

CI (непрерывная интеграция) — робот, который после каждого git push запускает тесты. На GitHub его описывает файл:

YAML · .github/workflows/test.yml
name: Test

on: push

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
      - name: Install uv
        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
        with:
          version: "0.13.9"
      - run: uv sync --locked
      - run: uv run pytest

Разбор по строкам

  • on: push — при каждом push.
  • actions/checkout@... # v7.0.1 — взять ваш код.
  • astral-sh/setup-uv@... # v9.0.0 — официальный экшен, ставит uv. Длинный набор букв — точная версия экшена (SHA), после # — она же словами.
  • version: "0.13.9" — версия uv.
  • uv sync --locked — пакеты по uv.lock, как в Docker.
  • uv run pytest — тесты.

Те же команды, что у вас

В Docker и в CI те же команды, что у вас, а uv.lock следит, чтобы версии везде были одинаковые.

Попробуйте

  • Найдите в Dockerfile строку, из-за которой pytest не попадёт в образ.
  • Это ENV UV_NO_DEV=1: pytest лежит в dev-зависимостях.

Что запомнить

  • В Dockerfile uv копируют в образ, проект ставят uv sync --locked.
  • --locked ставит строго по uv.lock; устаревший файл — ошибка.
  • В CI uv ставит astral-sh/setup-uv, дальше — те же uv sync и uv run pytest.

Дальше — шпаргалка, частые ошибки и куда идти.

На следующий урок