Redis в Docker: пошаговая инструкция для Ubuntu 24.04
Redis в Docker поднимают одним сервисом в compose-файле и проверяют командой redis-cli ping.
01Проверьте Docker и Compose
На сервере уже должны быть Docker Engine и плагин Compose v2. Команда docker compose version печатает версию плагина, например v2.29.7. Если Docker не установлен, его ставят из репозитория Docker пакетами docker-ce, docker-ce-cli, containerd.io, docker-buildx-plugin и docker-compose-plugin.
docker --version
docker compose version
02Создайте каталог проекта и compose-файл
Создайте каталог /var/www/example.com и файл compose.yaml в нём. Ключ version: в Compose v2 устарел и вызывает только предупреждение, поэтому его не пишут. Порт Redis публикуют только на localhost через 127.0.0.1:6379:6379, чтобы база не была доступна из интернета: опубликованные порты Docker обходят UFW.
services:
redis:
image: redis:7-alpine
container_name: example-redis
restart: unless-stopped
ports:
- "127.0.0.1:6379:6379"
volumes:
- redis-data:/data
command: redis-server --appendonly yes
volumes:
redis-data:
03Проверьте compose-файл
Команда docker compose config проверяет YAML и печатает итоговый конфиг с подставленными значениями. Ошибка yaml: line 12: did not find expected key означает проблему отступов или кавычек рядом с указанной строкой: отступы делают пробелами, не табуляцией. Если команда пишет no configuration file provided: not found, значит в текущем каталоге нет compose.yaml или docker-compose.yml.
cd /var/www/example.com
docker compose config
04Запустите Redis
Команда docker compose up -d скачивает образ redis:7-alpine и запускает контейнер в фоне. Флаг -d возвращает управление сразу после старта. Данные Redis хранятся в именованном томе redis-data, который переживает docker compose down.
cd /var/www/example.com
docker compose up -d
docker compose ps
05Проверьте ответ Redis
Команда docker compose exec redis redis-cli ping должна вернуть PONG. Если контейнер не отвечает, смотрите логи командой docker compose logs -f redis. Порт на хосте проверяют через sudo ss -ltnp: там должна быть строка 127.0.0.1:6379.
docker compose exec redis redis-cli ping
docker compose logs -f redis
sudo ss -ltnp | grep 6379
06Подключите Python-скрипт к Redis
Из контейнера того же проекта Redis доступен по имени сервиса redis на порту 6379. С хоста подключаются к 127.0.0.1:6379. Установите клиент командой pip install redis и выполните скрипт: он увеличивает счётчик и печатает результат. При недоступности Redis вызов r.incr() выбросит исключение redis.exceptions.ConnectionError, поэтому в примере оно перехвачено и выводится сообщением.
import redis
r = redis.Redis(host="127.0.0.1", port=6379, decode_responses=True)
try:
print(r.incr("visits"))
except redis.exceptions.ConnectionError as e:
print(f"Redis недоступен: {e}")
07Настройте Celery на Redis
Celery использует Redis как брокер сообщений. В celeryconfig.py укажите broker_url и result_backend с адресом redis://redis:6379/0, если задача запускается в контейнере того же compose-проекта. С хоста адрес будет redis://127.0.0.1:6379/0.
broker_url = "redis://redis:6379/0"
result_backend = "redis://redis:6379/0"
08Остановите и удалите контейнеры
Команда docker compose down останавливает и удаляет контейнеры и сеть проекта, но сохраняет том redis-data. Флаг -v удаляет и именованные тома, то есть данные Redis. Перед удалением тома убедитесь, что данные не нужны.
cd /var/www/example.com
docker compose down
Частые ошибки
-
При запуске появляется
Bind for 0.0.0.0:6379 failed: port is already allocated.Порт 6379 на хосте уже занят другим Redis или контейнером. Найдите процесс командой
sudo ss -ltnpи остановите его либо измените публикуемый порт в compose-файле. -
Команда
docker composeзавершается ошибкойpermission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock.Пользователь не в группе
dockerили не вошёл заново послеsudo usermod -aG docker $USER. Выполните команду и перезайдите на сервер: группаdockerравна правам root. -
Python-скрипт падает с трейсбеком
redis.exceptions.ConnectionError.Redis не запущен или скрипт обращается не по тому адресу. Проверьте
docker compose psиdocker compose exec redis redis-cli ping, а в коде укажитеredisдля контейнера или127.0.0.1для хоста. -
После
docker compose downданные Redis пропали.Том удалили флагом
-vили не подключили его в compose-файле. Добавьтеvolumes: - redis-data:/dataи не используйтеdown -v, если данные нужны.
Deploykin
Как это делается в Deploykin
В Deploykin Docker-контейнеры создаются, запускаются и останавливаются из панели. Там же видны их статусы и тома, терминал для этого не нужен.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Как подключиться к Redis из другого контейнера?
По имени сервиса в сети проекта: redis:6379. Из контейнера app того же compose-проекта адрес localhost не подойдёт, потому что это сам контейнер app.
Нужно ли публиковать порт 6379 наружу?
Нет, если Redis использует только приложение на том же сервере. Публикуйте его как 127.0.0.1:6379:6379, чтобы порт слушал только localhost: опубликованные порты Docker обходят UFW.
Где Redis хранит данные в контейнере?
В каталоге /data внутри контейнера. В compose-файле его подключают к именованному тому, например redis-data:/data, и тогда данные переживают docker compose down.
Почему docker compose пишет no configuration file provided: not found?
В текущем каталоге нет compose.yaml или docker-compose.yml. Перейдите в каталог проекта командой cd /var/www/example.com или укажите путь через -f.
Ещё по теме
- Руководство · 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 Docker volumes: настройка и проверка на Ubuntu 24.04 Пошаговая настройка docker volumes на Ubuntu 24.04: создание тома, подключение к контейнеру, проверка сохранности данных после перезапуска и типичные ошибки.
- Руководство · Docker Установка GitLab в Docker на Ubuntu 24.04 Установите GitLab в Docker на Ubuntu 24.04: подготовка, compose-файл, запуск, проверка и типичные ошибки с командами.
Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы