Provision
—— XP

Практика: Redis в Compose

практика~20 минут+450 XP

Redis в учебном стенде будет стоять в том же файле описания, что и база: так он стоит и в настоящих проектах. Ты положишь в него ключи, посмотришь, как они исчезают по сроку, а потом намеренно переполнишь память — сначала с настройкой по умолчанию, при которой кеш начинает отвечать ошибками, затем с правильной, при которой он молча избавляется от старого.

Все команды набираются в каталоге ~/infra/db.

Шаг 1. Добавить службу

Открой compose.yaml и допиши службу cache сразу под службой db, перед строкой volumes: в самом низу. Отступ — как у db, два пробела.

~/infra/db/compose.yaml, добавить
  cache:
    image: redis:8-alpine
    command: redis-server --maxmemory 4mb

command заменяет команду запуска из образа. --maxmemory 4mb — предел памяти. Четыре мегабайта смешно мало для работы, зато переполнить их можно за секунду. Порт наружу не публикуем: приложению Redis доступен по имени cache внутри сети Compose, а нам — через docker compose exec.

Шаг 2. Поднять

Флаг -d возвращает терминал сразу. Compose увидит, что база уже работает, и поднимет только новую службу.

ubuntu@stand:~$
docker compose up -d
 ✔ Container db-db-1     Running
 ✔ Container db-cache-1  Started

Шаг 3. Жив ли Redis

PING — первая команда при любой поломке, как pg_isready у базы.

ubuntu@stand:~$
docker compose exec cache redis-cli ping
PONG

PONG — жив. Ошибка Could not connect to Redis значит, что процесс внутри не поднялся; причина будет в docker compose logs cache.

Шаг 4. Ключ со сроком жизни

Зайди в клиент — без слов после redis-cli он открывается в интерактивном режиме, с приглашением.

ubuntu@stand:~$
docker compose exec cache redis-cli
127.0.0.1:6379>

Положи значение на шестьдесят секунд и сразу прочитай его:

ubuntu@stand:~$
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:

ubuntu@stand:~$
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 будет делать при переполнении.

ubuntu@stand:~$
127.0.0.1:6379> CONFIG GET maxmemory-policy
1) "maxmemory-policy"
2) "noeviction"

noeviction — значение по умолчанию: ничего не удалять, а на запись отвечать ошибкой. Выйди из клиента командой exit.

Шаг 7. Переполнить память

В образе есть redis-benchmark — программа для замера скорости, которая заодно отлично заполняет память. Флаг -t set — проверять только запись, -r 99999 — брать случайные ключи из ста тысяч, чтобы они не повторялись, -q — печатать только итог.

ubuntu@stand:~$
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 оставит только те, где размер записан понятными единицами.

ubuntu@stand:~$
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. Сменить политику на ходу

Политику можно поменять без перезапуска. Зайди в клиент и выполни:

ubuntu@stand:~$
127.0.0.1:6379> CONFIG SET maxmemory-policy allkeys-lru
OK

Изменение действует сразу, но живёт только до перезапуска контейнера. Так делают в аварию, чтобы быстро снять ошибки, — и потом обязательно переносят в описание.

Шаг 10. Записать политику в описание

Вернись в compose.yaml и допиши политику в строку command:

~/infra/db/compose.yaml, служба cache
    command: redis-server --maxmemory 4mb --maxmemory-policy allkeys-lru

Пересоздай службу, чтобы новая команда запуска вступила в силу:

ubuntu@stand:~$
docker compose up -d cache
 ✔ Container db-cache-1  Started

Контейнер пересоздан, а значит, память пуста: всё, что лежало в кеше, пропало. Для кеша это нормально — именно поэтому в нём не хранят ничего, что нельзя взять заново из базы.

Шаг 11. Переполнить ещё раз

Та же команда, что в шаге 7:

ubuntu@stand:~$
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.

ubuntu@stand:~$
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 видит, когда она ломается.

Практика 06+450 XP

Поднять Redis с пределом памяти, проверять его тремя командами и выбирать политику вытеснения под кеш.

  • Redis отвечает
  • Предел памяти задан
  • Политика подходит для кеша
  • Политика записана в описание
  • Вытеснение увидено
Команда сдачи — выполни на своей машине
команда
cd ~/infra/db 2>/dev/null || echo NODB; echo PING=$(docker compose exec -T cache redis-cli ping); docker compose exec -T cache redis-cli config get maxmemory-policy; echo MAXMEM=$(docker compose exec -T cache redis-cli config get maxmemory | tail -1); echo INFILE=$(grep -c allkeys-lru compose.yaml); docker compose exec -T cache redis-cli info stats | grep evicted_keys

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.