Вернёмся к 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.
Дальше — шпаргалка, частые ошибки и куда идти.