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

Redis очереди: настройка на Ubuntu 24.04

Очередь в Redis строят на списках: продюсер кладёт задание через LPUSH, воркер забирает через BRPOP. На Ubuntu 24.04 достаточно пакета redis-server, но нужно задать лимит памяти и политику вытеснения, иначе при переполнении запись упадёт с OOM command not allowed when used memory > 'maxmemory'.

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

01Проверьте, что Redis установлен и запущен

На сервере с Ubuntu 24.04 Redis 7.0 ставится пакетом redis-server. Убедитесь, что служба активна и отвечает на PING. Если Redis ещё нет, установите его командой sudo apt install redis-server и вернитесь к проверке.

bash
redis-cli ping
sudo systemctl status redis-server

02Задайте лимит памяти и политику вытеснения

По умолчанию maxmemory 0, памяти Redis не ограничена, а политика noeviction запрещает вытеснять ключи. Для очереди это опасно: при исчерпании памяти запись получит OOM command not allowed when used memory > 'maxmemory'. Задайте лимит на ходу и запишите его в /etc/redis/redis.conf командой CONFIG REWRITE.

bash
redis-cli CONFIG SET maxmemory 256mb
redis-cli CONFIG SET maxmemory-policy noeviction
redis-cli CONFIG REWRITE
redis-cli CONFIG GET maxmemory

03Включите сохранение на диск и проверьте снимок

Redis сохраняет снимки RDB в /var/lib/redis/dump.rdb по правилу save 3600 1 300 100 60 10000. Если снимок не записался, запись отклоняется ошибкой MISCONF. Проверьте место на разделе и последние строки лога.

bash
df -h /var/lib/redis
sudo tail -n 50 /var/log/redis/redis-server.log

04Положите задание в очередь и извлеките его

Очередь это список. Продюсер добавляет задание через LPUSH, воркер забирает через BRPOP с таймаутом. BRPOP блокируется, пока задание не появится, поэтому сначала положите его. После извлечения список пуст, это нормально.

bash
redis-cli LPUSH queue:test '{"task":"send_email","id":1}'
redis-cli LRANGE queue:test 0 -1
redis-cli BRPOP queue:test 5

05Сделайте извлечение надёжным

BRPOP удаляет задание из списка сразу. Если воркер упадёт во время работы, задание потеряется. Надёжный шаблон: BRPOPLPUSH перекладывает задание в список обработки, воркер выполняет его и удаляет через LREM. При сбое задание остаётся в списке обработки, и его можно вернуть.

bash
redis-cli LPUSH queue:test '{"task":"send_email","id":2}'
redis-cli BRPOPLPUSH queue:test queue:processing 5
redis-cli LRANGE queue:processing 0 -1
redis-cli LREM queue:processing 1 '{"task":"send_email","id":2}'

06Подключите приложение

Для PHP установите расширение php8.3-redis и перезагрузите FPM. Laravel берёт адрес и порт из .env: REDIS_HOST=127.0.0.1, REDIS_PORT=6379. Для очередей задайте QUEUE_CONNECTION=redis. В Go используйте клиент github.com/redis/go-redis/v9 и команды LPush и BRPop.

bash
sudo apt install php8.3-redis
sudo systemctl reload php8.3-fpm
php -m | grep redis

07Проверьте, что очередь работает

Положите контрольное задание и убедитесь, что оно в списке. Затем извлеките его и проверьте, что список опустел. Если BRPOP вернул nil, задание уже забрали или оно не добавилось.

bash
redis-cli LPUSH queue:check 'test'
redis-cli LRANGE queue:check 0 -1
redis-cli BRPOP queue:check 5
redis-cli LLEN queue:check

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

  • После BRPOP список пуст, и проверка LRANGE ничего не показывает.

    Кладите новое задание через LPUSH перед каждой проверкой. BRPOP удаляет элемент из списка, поэтому проверять наличие нужно до извлечения.

  • При переполнении памяти запись падает с OOM command not allowed when used memory > 'maxmemory'.

    Для очереди поднимите maxmemory или оставьте maxmemory-policy noeviction, чтобы задания не вытеснялись. Для кэша ставят allkeys-lru, но не для очереди.

  • Воркер упал, и задание пропало из очереди.

    Используйте BRPOPLPUSH в список обработки и удаляйте задание через LREM только после успешного выполнения. При сбое задание останется в списке обработки.

  • Laravel выдаёт Class "Redis" not found.

    Установите php8.3-redis и перезагрузите php8.3-fpm. Либо переключите REDIS_CLIENT на predis и поставьте пакет через Composer.

Deploykin

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

В Deploykin Redis ставится на сервер в один клик и настраивается формой: пароль, лимит памяти, политика вытеснения, AOF. Доступ для серверов кластера включается одним переключателем, bind и файрвол панель настроит сама.

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

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

Чем отличается BRPOP от BRPOPLPUSH для очереди?

BRPOP сразу удаляет задание из списка, и при сбое воркера оно теряется. BRPOPLPUSH перекладывает задание в список обработки, откуда его удаляют после успешного выполнения.

Какую политику вытеснения ставить для очереди?

noeviction: задания не должны вытесняться. Следите за maxmemory и добавляйте память, иначе запись получит ошибку OOM.

Почему redis-cli BRPOP queue:test 5 возвращает nil?

В списке нет заданий. BRPOP ждёт 5 секунд и возвращает nil. Сначала положите задание через LPUSH.

Нужно ли перезапускать Redis после CONFIG SET?

Нет, настройка применяется сразу. Чтобы сохранить её в /etc/redis/redis.conf, выполните redis-cli CONFIG REWRITE.

Ещё по теме

Redis на своём сервере: установка и настройка: все материалы темы

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