Docker для начинающих: образ, контейнер и данные
Docker помогает воспроизвести окружение приложения, но не отменяет понимание его запуска. Сначала добейтесь работы сервиса обычной командой. Затем перенесите этот процесс в образ.
Различайте образ и контейнер
Образ — подготовленная файловая система и настройки запуска. Контейнер — экземпляр, созданный из образа. Пересоздание контейнера не должно уничтожать важные данные, поэтому базу и загруженные файлы нельзя считать надёжно сохранёнными только потому, что они лежат внутри него.
Понятия и практические упражнения доступны в документации Docker.
Минимальный пример для FastAPI
Для проекта с requirements.txt, содержащим FastAPI и Uvicorn, и файлом main.py:
FROM python:3.12-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY main.py .
RUN useradd --create-home appuser
USER appuser
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]
Соберите docker build -t demo-api . и запустите docker run --rm -p 127.0.0.1:8000:8000 demo-api. Привязка к 127.0.0.1 оставляет этот учебный запуск доступным с локального компьютера.
Проверьте, что попало в сборку
Создайте .dockerignore для .git, локального окружения, секретов и временных файлов. Не копируйте .env внутрь образа. Передавайте настройки при запуске предусмотренным способом.
Для разработки том может сохранять данные между пересозданиями, но сам по себе не является резервной копией. Проверьте остановку, повторный запуск и журналы. Перед рабочим развёртыванием зафиксируйте зависимости и продумайте обновление базового образа.
Следующий этап — размещение приложения на VPS, где понадобятся HTTPS, наблюдение за сервисом и восстановление.