Redis в учебном стенде будет стоять в том же файле описания, что и база: так он стоит и в настоящих проектах. Ты положишь в него ключи, посмотришь, как они исчезают по сроку, а потом намеренно переполнишь память — сначала с настройкой по умолчанию, при которой кеш начинает отвечать ошибками, затем с правильной, при которой он молча избавляется от старого.
Все команды набираются в каталоге ~/infra/db.
Шаг 1. Добавить службу
Открой compose.yaml и допиши службу cache сразу под службой db, перед строкой volumes: в самом низу. Отступ — как у db, два пробела.
cache: image: redis:8-alpine command: redis-server --maxmemory 4mb
command заменяет команду запуска из образа. --maxmemory 4mb — предел памяти. Четыре мегабайта смешно мало для работы, зато переполнить их можно за секунду. Порт наружу не публикуем: приложению Redis доступен по имени cache внутри сети Compose, а нам — через docker compose exec.
Шаг 2. Поднять
Флаг -d возвращает терминал сразу. Compose увидит, что база уже работает, и поднимет только новую службу.
docker compose up -d ✔ Container db-db-1 Running ✔ Container db-cache-1 Started
Шаг 3. Жив ли Redis
PING — первая команда при любой поломке, как pg_isready у базы.
docker compose exec cache redis-cli ping PONG
PONG — жив. Ошибка Could not connect to Redis значит, что процесс внутри не поднялся; причина будет в docker compose logs cache.
Шаг 4. Ключ со сроком жизни
Зайди в клиент — без слов после redis-cli он открывается в интерактивном режиме, с приглашением.
docker compose exec cache redis-cli 127.0.0.1:6379>
Положи значение на шестьдесят секунд и сразу прочитай его:
127.0.0.1:6379> SET user:1 anna EX 60 OK 127.0.0.1:6379> GET user:1 "anna" 127.0.0.1:6379> TTL user:1 (integer) 52
TTL показывает, сколько секунд осталось. У тебя число будет своим — смотря как быстро ты набирал.
Шаг 5. Ключ исчез сам
Подожди минуту и повтори GET:
127.0.0.1:6379> GET user:1 (nil) 127.0.0.1:6379> TTL user:1 (integer) -2
(nil) — ключа нет, это промах кеша. TTL равен −2, когда ключа не существует, и −1, когда ключ есть, но срока у него нет: такой ключ будет лежать вечно.
Шаг 6. Какая политика сейчас
Узнай, что Redis будет делать при переполнении.
127.0.0.1:6379> CONFIG GET maxmemory-policy 1) "maxmemory-policy" 2) "noeviction"
noeviction — значение по умолчанию: ничего не удалять, а на запись отвечать ошибкой. Выйди из клиента командой exit.
Шаг 7. Переполнить память
В образе есть redis-benchmark — программа для замера скорости, которая заодно отлично заполняет память. Флаг -t set — проверять только запись, -r 99999 — брать случайные ключи из ста тысяч, чтобы они не повторялись, -q — печатать только итог.
docker compose exec cache redis-benchmark -t set -r 99999 -q Error from server: OOM command not allowed when used memory > 'maxmemory'.
Вот как выглядит переполненный кеш с настройкой по умолчанию. Ровно эту ошибку получит приложение на каждую попытку что-нибудь записать — и если оно не готово к ней, пользователь увидит страницу с ошибкой.
Шаг 8. Посмотреть на память
Команда INFO memory печатает много строк; фильтр grep human оставит только те, где размер записан понятными единицами.
docker compose exec cache redis-cli info memory | grep human used_memory_human:3.98M used_memory_rss_human:23.80M used_memory_peak_human:4.00M total_system_memory_human:3.81G used_memory_lua_human:32.00K used_memory_vm_total_human:66.00K used_memory_scripts_human:192B maxmemory_human:4.00M
Из восьми строк нужны первая и последняя. Занято почти столько, сколько разрешено. used_memory_human — сколько занято сейчас, maxmemory_human — предел. Когда первое прижимается ко второму, это сигнал, который в мониторинге выводят на график.
Шаг 9. Сменить политику на ходу
Политику можно поменять без перезапуска. Зайди в клиент и выполни:
127.0.0.1:6379> CONFIG SET maxmemory-policy allkeys-lru OK
Изменение действует сразу, но живёт только до перезапуска контейнера. Так делают в аварию, чтобы быстро снять ошибки, — и потом обязательно переносят в описание.
Шаг 10. Записать политику в описание
Вернись в compose.yaml и допиши политику в строку command:
command: redis-server --maxmemory 4mb --maxmemory-policy allkeys-lruПересоздай службу, чтобы новая команда запуска вступила в силу:
docker compose up -d cache ✔ Container db-cache-1 Started
Контейнер пересоздан, а значит, память пуста: всё, что лежало в кеше, пропало. Для кеша это нормально — именно поэтому в нём не хранят ничего, что нельзя взять заново из базы.
Шаг 11. Переполнить ещё раз
Та же команда, что в шаге 7:
docker compose exec cache redis-benchmark -t set -r 99999 -q SET: 246913.58 requests per second, p50=0.095 msec
Ошибок нет. Redis больше не отказывает в записи, а освобождает место сам. Число запросов в секунду у тебя будет своим.
Шаг 12. Убедиться, что ключи вытесняются
Счётчик вытесненных ключей — в разделе INFO stats.
docker compose exec cache redis-cli info stats | grep evict evicted_keys:47738 evicted_clients:0 evicted_scripts:0 total_eviction_exceeded_time:0 current_eviction_exceeded_time:0
Смотри на первую строку: evicted_keys — сколько ключей вытеснено. Почти пятьдесят тысяч ключей удалены, чтобы освободить место новым. На настоящем кеше небольшое вытеснение — норма, а постоянно растущее — повод дать Redis больше памяти.
Если что-то пошло не так
Если в шаге 7 ошибки не появилось, значит, политика уже не noeviction — например, ты перепутал порядок шагов. Проверь шагом 6 и при необходимости верни значение командой CONFIG SET maxmemory-policy noeviction.
Если после шага 10 политика всё ещё старая, Compose не пересоздал контейнер: проверь отступы в command и что ты сохранил файл. Команда docker compose config покажет описание так, как его понял Compose.
Что дальше
База и кеш стоят рядом. Последняя тема раздела — третий частый сосед базы, очередь сообщений, и что DevOps видит, когда она ломается.