Как сохранить состояние в Docker Container

Сохранение состояния в Docker Container

В Docker, контейнеры по своей природе являются эфемерными (ephemeral) — они создаются и уничтожаются, а их внутреннее состояние (файлы, данные) исчезает после остановки. Сохранение состояния требует специальных подходов.

Основные методы сохранения состояния

1. Использование Docker Volumes (Тома) Это основной и наиболее рекомендуемый способ. Тома — это механизм для сохранения данных независимо от жизненного цикла контейнера.

• Тома управляются Docker: данные хранятся в области, управляемой демоном Docker (обычно /var/lib/docker/volumes).
• Отделены от контейнера: можно удалить контейнер, но сохранить данные в томе и подключить их к новому контейнеру.
• Пример создания и использования тома:

# Создать именованный том
docker volume create myapp-data

# Запустить контейнер, подключив том
docker run -d \
  --name my-app \
  -v myapp-data:/app/data \
  my-app-image

# Даже если контейнер `my-app` удалить, данные в `myapp-data` сохранятся.
# Новый контейнер сможет получить эти данные:
docker run -d \
  --name my-app-new \
  -v myapp-data:/app/data \
  my-app-image

2. Использование Bind Mounts (Привязка директорий) Прямое подключение определенной директории или файла из хостовой системы (host machine) внутрь контейнера.

• Прямой доступ к файлам хоста: изменения в контейнере сразу отражаются на хосте.
• Проще для разработки: удобно для монтирования исходного кода.
• Пример:

# Примонтировать локальную директорию проекта в контейнер
docker run -d \
  -v /home/user/project:/app \
  my-app-image

# Все изменения в файлах внутри `/app` будут сохранены в `/home/user/project` на хосте.

3. Использование tmpfs Mounts (для временных данных) Для хранения данных только в памяти хоста (не сохраняется после остановки контейнера). Используется для временных, чувствительных к скорости данных.

docker run -d \
  --tmpfs /app/temp-cache \
  my-app-image

Ключевые различия и рекомендации

• Volumes vs Bind Mounts: Тома лучше для production, так как полностью управляются Docker и могут использоваться с Docker Compose, Swarm. Bind mounts удобны для разработки.
• Сохранять конфигурацию отдельно: Критичные конфигурационные файлы также следует хранить в томах или передавать через environment variables (-e), чтобы не "зашивать" их в образ.
• Паттерн для stateful-приложений (базы данных, хранилища):

    1. Создайте именованный том для данных (`docker volume create db-data`).
    2. Подключите его к контейнеру в соответствующую директорию (`-v db-data:/var/lib/postgresql/data`).
    3. Используйте тот же том при обновлении или пересоздании контейнера.

Пример Dockerfile с учетом сохранения состояния

Образ должен быть подготовлен для работы с внешними томами.

FROM alpine:latest
WORKDIR /app
# Предполагаем, что состояние будет храниться в /app/data
# Директория данных может быть пустой в образе, заполнится из тома
RUN mkdir -p /app/data
COPY app-entrypoint.sh /entrypoint.sh
ENTRYPOINT ["/entrypoint.sh"]

Оркестрация с Docker Compose

В Docker Compose тома описываются явно и легко переиспользуются.

version: '3.8'
services:
  database:
    image: postgres:13
    volumes:
      - postgres-data:/var/lib/postgresql/data  # Именованный том
    environment:
      POSTGRES_PASSWORD: example-pass

volumes:
  postgres-data:  # Определение тома. Docker Compose создаст его автоматически.

Вывод

Для сохранения состояния в Docker Container необходимо отделить данные от контейнера с помощью механизмов персистентного хранения:

• Docker Volumes — основной метод для production.
• Bind Mounts — для разработки и интеграции с файловой системой хоста.
• tmpfs Mounts — для временных данных в памяти.

Критически важно не хранить состояние в writable layer контейнера (в его внутренней файловой системе), так как это приводит к потере данных и проблемам с масштабированием. Правильное использование томов позволяет создавать stateful-сервисы (базы данных, кэши), которые устойчивы к рестартам и обновлениям контейнеров.