Модуль Redis: кэш и TTL в тестах

GenericContainer из второго урока умеет поднять что угодно, но про Redis не знает ничего: образ, открытый порт 6379, ожидание готовности — всё руками. Модуль закрывает это разом. Внутри redis.Run выставляет два обязательных решения: порт 6379/tcp открывается заранее, а готовность ждут двумя стратегиями — слушающий порт с потолком в десять секунд и строка Ready to accept connections в логах сервера. То есть к моменту, когда Run вернёт управление, redis-server уже принимает команды — соединяться с неготовым сервером не получится. Взамен вы получаете типизированный RedisContainer — с методом ConnectionString, поддержкой TLS и учтёнными флагами запуска, а не россыпью строк, которую вы собираете и синхронизируете сами в каждом пакете. Ничего магического здесь нет: внутри модуль пользуется тем же GenericContainer, но этот код написан и обкатан один раз в исходниках, а не в каждом вашем тесте. Про сами стратегии ожидания подробнее — в отдельном уроке ниже.

Вход в модуль — функция redis.Run(ctx, образ, opts ...testcontainers.ContainerCustomizer): тот же принцип кастомайзеров, что у ядра testcontainers, плюс собственные опции модуля. Образ обязателен первым аргументом, и дефолтного тега у Run нет — строку вы всегда пишете сами, а сменить тег значит поменять её: отдельной опции переключения версии образа в модуле нет. Опции With переводятся в флаги redis-server. WithSnapshotting(секунды, ключи) превращается в --save: сохранять датасет каждые N секунд при M изменениях, значения меньше единицы подтягиваются до единицы. WithLogLevel принимает LogLevelDebug, LogLevelVerbose, LogLevelNotice или LogLevelWarning и уходит в --loglevel — удобно, когда тест падает и нужен подробный лог сервера. WithConfigFile монтирует ваш файл в /usr/local/redis.conf и ставит его первым аргументом запуска: лимиты памяти, политики вытеснения — всё, что обычно живёт в конфиге. WithTLS — отдельная история: сертификаты генерируются на лету, и что меняется в адресе, проверим вопросом ниже.

RedisContainer.ConnectionString(ctx) возвращает адрес вида redis://хост:порт — схема redis, а при включённом TLS уже rediss. Адрес собирается через PortEndpoint по порту 6379/tcp, то есть из маппированного порта Docker. Выбирать порт руками не нужно и вредно: на занятой машине тест упадёт, а так Docker отдаёт свободный порт каждому контейнеру, и параллельные прогоны не дерутся. Дальше адрес отдаётся клиенту go-redis: redis.ParseURL разбирает строку в готовую структуру Options, redis.NewClient строит на ней клиент, а Ping подтверждает, что сервер жив. Тот же ParseURL используют исходники модуля — в примерах к Options просто прикрепляют TLSConfig из контейнера, когда соединение шифруется. Подключайтесь один раз в TestMain и держите клиент открытым на весь пакет: пересоздавать его на каждый тест — лишняя работа. redis тесты go проходят на честных командах, а тонкости клиента — тема отдельного курса go-redis.

Кэш-тест — это пара сценариев: мисс и хит. Кэш-мисс в go-redis — не пустая строка, а ошибка: Get по отсутствующему ключу возвращает сентинел-ошибку redis.Nil. Проверяйте её через errors.Is, а не сравнением текста ошибки: сентинел создан именно для этого. Дальше кладём значение Set с временем жизни и проверяем хит: тот же ключ возвращается с тем же значением. На честном сервере это проверяет больше, чем мок: что ключи называются с правильными префиксами, что сериализация значения туда и обратно не ломает данные, что инвалидация действительно удаляет ключ, а TTL выставляется, а не забыт. Состояние между тестами чистите: FlushAll после каждого теста стирает всё, а можно завести второй клиент с Options{DB: 1} — Redis держит несколько логических баз на одном сервере, и тесты в разных номерах не видят ключи друг друга. Выберите один способ на пакет и придерживайтесь его.

Первая грабля TTL — time.Sleep. Тест, который кладёт ключ с TTL на две секунды и спит три, замедляет весь пакет и флейкает на нагруженной машине: планировщик может отдать квант позже, и сон окажется недостаточным. Вместо сна спрашивайте сервер: команда TTL возвращает остаток жизни ключа как time.Duration — сразу после Set это почти заданное время, а к концу жизни остаток тает. Для ключа без истечения сервер отвечает -1, для отсутствующего — -2, и go-redis отдаёт их как отрицательные длительности. Если нужен именно факт истечения, ставьте TTL в доли секунды и один короткий сон в самом конце теста — но это последняя мера, а не паттерн. Вторая грабля — вечные ключи: Set с нулевым TTL не истекает никогда, и такой «кэш» живёт до конца прогона, портя соседние тесты. Помогают FlushAll и отдельная логическая DB из предыдущего раздела.