Docker volumes: настройка и проверка на Ubuntu 24.04
Тома Docker хранят данные контейнера на хосте и переживают перезапуск и удаление контейнера. Настройка занимает несколько команд: создать том, подключить его в compose-файле, запустить сервис и убедиться, что файлы остались на месте после docker compose down.
01Установите Docker и плагин Compose
На Ubuntu 24.04 Docker ставят из официального репозитория. Пакет docker-compose-plugin даёт команду docker compose через пробел, старый docker-compose не нужен. После установки проверьте версии.
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 на сервере, добавляйте только доверенных пользователей.
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, снаружи он недоступен.
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 запрещена.
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.
cd /var/www/example.com
docker compose up -d
docker compose ps
06Запишите файл в том
Положите тестовый файл внутрь контейнера в смонтированный каталог. Он окажется в именованном томе, а не в слое контейнера. Команда docker compose exec app sh открывает shell внутри работающего сервиса.
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, том удалится вместе с данными.
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 docker images: работа с образами Docker на Ubuntu 24.04 Как работать с docker images на Ubuntu 24.04: проверить демон, скачать образ через docker pull, посмотреть список, запустить контейнер и проверить результат.
- Руководство · Docker Установка Docker и Docker Compose на Ubuntu 24.04 Пошаговая установка Docker и Docker Compose на Ubuntu 24.04: команды, настройка compose.yaml, проверка работы и разбор частых ошибок.
- Руководство · Docker Как запустить Docker container на Ubuntu 24.04: пошаговая инструкция Запустите контейнер через docker compose up -d, проверьте статус, посмотрите логи, войдите в контейнер через exec и остановите проект. Команды и проверка.
- Руководство · Docker Установка Portainer на Ubuntu 24.04: пошаговая настройка Установите Portainer в Docker Compose на Ubuntu 24.04: проверка Docker, compose-файл, запуск, доступ к панели и проверка через curl и docker compose ps.
- Руководство · Docker Установка GitLab в Docker на Ubuntu 24.04 Установите GitLab в Docker на Ubuntu 24.04: подготовка, compose-файл, запуск, проверка и типичные ошибки с командами.
- Руководство · Docker Установка Docker Engine на Ubuntu 24.04 Установите Docker Engine и Compose v2 на Ubuntu 24.04 из официального репозитория: команды, настройка без sudo, проверка контейнером hello-world.
Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы