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

Redis в Docker: пошаговая инструкция для Ubuntu 24.04

Redis в Docker поднимают одним сервисом в compose-файле и проверяют командой redis-cli ping.

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

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.

bash
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.

yaml
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.

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

04Запустите Redis

Команда docker compose up -d скачивает образ redis:7-alpine и запускает контейнер в фоне. Флаг -d возвращает управление сразу после старта. Данные Redis хранятся в именованном томе redis-data, который переживает docker compose down.

bash
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.

bash
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, поэтому в примере оно перехвачено и выводится сообщением.

text
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.

text
broker_url = "redis://redis:6379/0"
result_backend = "redis://redis:6379/0"

08Остановите и удалите контейнеры

Команда docker compose down останавливает и удаляет контейнеры и сеть проекта, но сохраняет том redis-data. Флаг -v удаляет и именованные тома, то есть данные Redis. Перед удалением тома убедитесь, что данные не нужны.

bash
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 Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы

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