К содержимому

Docker volumes: настройка и проверка на Ubuntu 24.04

Тома Docker хранят данные контейнера на хосте и переживают перезапуск и удаление контейнера. Настройка занимает несколько команд: создать том, подключить его в compose-файле, запустить сервис и убедиться, что файлы остались на месте после docker compose down.

Руководство Docker 3 мин чтения

01Установите Docker и плагин Compose

На Ubuntu 24.04 Docker ставят из официального репозитория. Пакет docker-compose-plugin даёт команду docker compose через пробел, старый docker-compose не нужен. После установки проверьте версии.

bash
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
docker --version
docker compose version

02Разрешите запуск docker без sudo

По умолчанию сокет /var/run/docker.sock доступен только root. Добавьте пользователя в группу docker и войдите заново, иначе команды вернут permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock. Группа docker даёт права root на сервере, добавляйте только доверенных пользователей.

bash
sudo usermod -aG docker $USER
newgrp docker
docker ps

03Создайте каталог проекта и compose-файл

Создайте каталог /var/www/example.com и файл compose.yaml. В нём опишите сервис app на образе nginx:1.24 с именованным томом appdata, который монтируется в /usr/share/nginx/html. Порт публикуется только на localhost: 127.0.0.1:8080:80, снаружи он недоступен.

yaml
services:
  app:
    image: nginx:1.24
    ports:
      - "127.0.0.1:8080:80"
    volumes:
      - appdata:/usr/share/nginx/html

volumes:
  appdata:

04Проверьте compose-файл

Команда docker compose config читает compose.yaml, проверяет YAML и печатает итоговый конфиг. Если отступы или кавычки сломаны, вы увидите ошибку вида yaml: line 12: did not find expected key. Отступы делайте пробелами, табуляция в YAML запрещена.

bash
cd /var/www/example.com
docker compose config

05Запустите сервис

Запустите контейнер в фоне командой docker compose up -d. Docker создаст том example.com_appdata и сеть example.com_default. Если порт 8080 на хосте уже занят, появится Bind for 0.0.0.0:8080 failed: port is already allocated. Кто держит порт, покажет sudo ss -ltnp.

bash
cd /var/www/example.com
docker compose up -d
docker compose ps

06Запишите файл в том

Положите тестовый файл внутрь контейнера в смонтированный каталог. Он окажется в именованном томе, а не в слое контейнера. Команда docker compose exec app sh открывает shell внутри работающего сервиса.

bash
docker compose exec app sh -c 'echo hello > /usr/share/nginx/html/index.html'
curl http://127.0.0.1:8080/

07Проверьте, что том пережил перезапуск

Остановите проект командой docker compose down: контейнер и сеть удаляются, а именованный том остаётся. Запустите снова и запросите файл: curl вернёт hello. Если выполнить docker compose down -v, том удалится вместе с данными.

bash
docker compose down
docker compose up -d
curl http://127.0.0.1:8080/

Частые ошибки

  • При запуске появляется Bind for 0.0.0.0:8080 failed: port is already allocated. Порт 8080 на хосте уже занят nginx самого сервера или другим контейнером.

    Найдите процесс командой sudo ss -ltnp и остановите его либо поменяйте левую часть публикации, например на 127.0.0.1:8081:80.

  • Команда docker compose up -d возвращает permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock.

    Пользователь не в группе docker или не перелогинился после sudo usermod -aG docker $USER. Войдите заново или выполните newgrp docker.

  • В каталоге проекта команда compose пишет no configuration file provided: not found.

    В текущем каталоге нет compose.yaml или docker-compose.yml. Перейдите в каталог проекта или укажите путь через -f /var/www/example.com/compose.yaml.

  • Контейнер падает с кодом выхода 137, данные в томе не обновляются.

    Код 137 значит, что процесс убит сигналом SIGKILL, чаще всего из-за нехватки памяти. Проверьте docker compose logs app и лимиты памяти на сервере.

Deploykin

Как это делается в Deploykin

В Deploykin Docker-контейнеры создаются, запускаются и останавливаются из панели. Там же видны их статусы и тома, терминал для этого не нужен.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Чем именованный том отличается от bind mount?

Именованный том Docker хранит в своём каталоге и им управляет, а bind mount монтирует каталог хоста и сохраняет UID и GID файлов. Для баз данных и данных приложения обычно берут том, для конфигов удобнее bind mount.

Удаляются ли данные при docker compose down?

Нет, именованные тома переживают docker compose down. Удаляет их только docker compose down -v.

Где Docker хранит тома на Ubuntu 24.04?

По умолчанию в каталоге /var/lib/docker/volumes. Имя тома складывается из имени проекта и имени тома, например example.com_appdata.

Как посмотреть список томов?

Команда docker volume ls показывает все тома, а docker volume inspect example.com_appdata выводит точку монтирования и параметры.

Ещё по теме

Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.