Redis очереди: настройка на Ubuntu 24.04
Очередь в Redis строят на списках: продюсер кладёт задание через LPUSH, воркер забирает через BRPOP. На Ubuntu 24.04 достаточно пакета redis-server, но нужно задать лимит памяти и политику вытеснения, иначе при переполнении запись упадёт с OOM command not allowed when used memory > 'maxmemory'.
01Проверьте, что Redis установлен и запущен
На сервере с Ubuntu 24.04 Redis 7.0 ставится пакетом redis-server. Убедитесь, что служба активна и отвечает на PING. Если Redis ещё нет, установите его командой sudo apt install redis-server и вернитесь к проверке.
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.
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. Проверьте место на разделе и последние строки лога.
df -h /var/lib/redis
sudo tail -n 50 /var/log/redis/redis-server.log
04Положите задание в очередь и извлеките его
Очередь это список. Продюсер добавляет задание через LPUSH, воркер забирает через BRPOP с таймаутом. BRPOP блокируется, пока задание не появится, поэтому сначала положите его. После извлечения список пуст, это нормально.
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. При сбое задание остаётся в списке обработки, и его можно вернуть.
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.
sudo apt install php8.3-redis
sudo systemctl reload php8.3-fpm
php -m | grep redis
07Проверьте, что очередь работает
Положите контрольное задание и убедитесь, что оно в списке. Затем извлеките его и проверьте, что список опустел. Если BRPOP вернул nil, задание уже забрали или оно не добавилось.
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 Как установить Redis на сервер Ubuntu 24.04 Пошаговая установка Redis на Ubuntu 24.04: apt, проверка службы, настройка памяти и пароля, PHP-расширение, проверка redis-cli ping и разбор частых ошибок.
- Руководство · Redis Как настроить Redis на Ubuntu 24.04 и работать с ним через redis-cli Установите Redis на Ubuntu 24.04, подключитесь через redis-cli, задайте пароль и лимит памяти, проверьте работу командами ping, INFO и CONFIG GET.
- Руководство · Redis Как настроить PHP Redis на сервере Ubuntu 24.04 Установите Redis и расширение php8.3-redis на Ubuntu 24.04, настройте кэш и пароль, подключитесь из PHP и Laravel. Команды, конфиги и проверка работы.
- Руководство · Redis Redis база данных: настройка на сервере Ubuntu 24.04 Пошаговая настройка Redis на Ubuntu 24.04: проверка службы, пароль, лимит памяти, сохранение на диск, PHP-расширение и проверка работы командами.
- Руководство · Redis Настройка Redis на Ubuntu 24.04: пошаговое руководство Пошаговая настройка Redis на Ubuntu 24.04: проверка службы, правка redis.conf, пароль, лимит памяти, сохранение на диск и проверка через redis-cli.
- Руководство · Redis Redis команды: пошаговое руководство с проверкой Пошаговое руководство по работе с Redis на Ubuntu 24.04: проверка службы, основные команды redis-cli, настройка памяти, пароля и проверка результата.
Redis на своём сервере: установка и настройка: все материалы темы