Reuse: переиспользование контейнеров

Считать выгоды удобно на брокере. Один подъём: pull образа, создание, старт, прогрев диспетчеров тем — суммарно близко к минуте на слабой машине. Двадцать тестов с индивидуальными контейнерами — двадцать таких подъёмов, и сборка растягивается на полчаса, хотя каждый тест работает секунды. Схема с переиспользованием платит за старт один раз: первый вызов с именем и Reuse создаёт контейнер, остальные находят его и получают тот же адрес. Сценарий «testcontainers reuse» держится на простом контракте: вызов с тем же именем возвращает существующий контейнер, а не ошибку конфликта. Экономия живёт не только в CI: при локальной итерации контейнер переживает прогон, и повторный go test стартует мгновенно, без pull и прогрева. Ускорение тестов go чаще всего начинается именно здесь — с удаления повторных подъёмов, а не с тонкой настройки самого кода: десятки секунд на тест нельзя выгадать ни одной микрооптимизацией в самом тесте. Цена вопроса симметрична: пока контейнер общий, готовность придётся проверять на каждом вызове, но сверка порта — миллисекунды против минут на полный подъём с загрузкой образа. Останется следить, чтобы общий сервис не превратился в общую помойку, — этому посвящён хвост урока.

Условие одно, но жёсткое: имя обязательно. Reuse без имени GenericContainer отсекает ещё до обращения к провайдеру — возвращается ErrReuseEmptyName, потому что искать без имени нечего. Поле при этом живёт в обёртке запроса рядом со Started: декларация описывает «что запустить», обёртка — как ведёт себя тест, и переиспользование относится ко второй категории. Поиск идёт по точному совпадению имени среди всех контейнеров машины, включая остановленные: брокер, остановленный прошлой сессией, будет найден и поднят заново. Если контейнера нет, выполняется обычный create; гонка, когда два вызова одновременно создают один контейнер, обрабатывается ожиданием его появления — конфликт имени в этой ситуации не роняет тест. Дальше провайдер смотрит состояние найденного: работающий контейнер не перезапускается, но хуки старта и wait-стратегия исполняются заново; остановленный поднимается, как будто его никто не гасил; контейнер в паузе средствами Docker переиспользованию не поддаётся — вернётся ошибка о невозможности старта паузы. Для нового API Run и модулей есть опция WithReuseByName: один вызов ставит и имя, и флаг; документация помечает её экспериментальной и предупреждает, что реализация может смениться на неименную. Практичное следствие: декларация переиспользуемого контейнера должна быть одинаковой во всех вызовах — различия в полях к живому контейнеру не применяются, и тест будет работать с тем, что задал создатель.

Паттерн «один дорогой контейнер на пакет» опирается на TestMain — точку входа тестового пакета: до m.Run контейнер создаётся, после — убирается. Каждый тест получает адрес из пакетной переменной и не тратит ни строки на подъём. Уборка переезжает с теста на пакет: Terminate после m.Run срабатывает всегда — и на провале assert'ов, и на панике внутри теста, потому что фреймворк доводит прогон до возврата в TestMain. Регистрировать Terminate в t.Cleanup каждого теста при общем контейнере — ошибка: первый завершившийся тест снесёт брокер соседям, и те начнут пересоздание с полного подъёма на ровном месте. Провалиться пакет должен целиком и сразу: ошибка подъёма в TestMain валит прогон с одной внятной причиной вместо двадцати одинаковых красных строк. Пакетные фикстуры — тема урока про TestMain и testify, здесь важен принцип: создаёт один раз, убирает один раз, тесты только пользуются. Имя при этом стоит выбирать пакетно-уникальным: префикс с сервисом и названием пакета убережёт от коллизии, когда два разных пакета одной машины захотят одного брокера.

Общий контейнер — общие данные: строки, вставленные прошлым тестом, ждут следующий. Ответ — чистка между тестами, дешевле которой только ничего: вместо пересоздания контейнера тест выполняет внутри него одну команду. Для Postgres это TRUNCATE списком таблиц с RESTART IDENTITY CASCADE — сброс автоинкрементов и зависимых ссылок одним заходом; для Redis — FLUSHALL, стирающий все ключи мгновенно; для брокера — выделенный топик или группа на тест, чтобы сообщения не переливались между сценариями. Вызов исполняется через Exec по живому контейнеру из TestMain, занимает миллисекунды и не трогает ни сеть, ни образ, ни wait-стратегию. Хелпер чистки удобно ставить в t.Cleanup теста: уборка выполнится и при провале assert'ов, и следующий тест получит предсказуемо пустую базу. Дисциплина симметрична подъёму: раз контейнер заводится один раз на пакет, чистится он много раз — по разу на тест. Клиентские запросы к базе из Go — в курсе pgx, здесь достаточно Exec с консольной утилитой внутри контейнера.

Экономия секунд оборачивается флейками, когда тест опирается на состояние, о котором ничего не знает. Порядок исполнения тестов Go не фиксирует: завтра ConsumerReads отработает первым, и ProducerWrites увидит не пустой топик, а вчерашние сообщения. Автоинкременты уехали от прошлых вставок, и тест, сверяющий id с единицей, краснеет через раз. Общий кэш отдаёт попадание там, где тест ждал промах; соединения, оставленные соседом в пуле, могут упереться в лимит брокера. Симптом один: тест зелёный отдельно и падает в пакете — верный признак протечки состояния, а не бага в продакшен-коде. Рецепт из таблицы выше: тестам с жёсткими предположениями о пустом старте — индивидуальный контейнер, общему пакету — дисциплина чистки после каждого теста. Правило отбора простое: тест обязан декларировать нужное ему состояние сам и не полагаться на то, что «контейнер же свежий». Если нужная декларация невозможна без полного пересоздания — переиспользование здесь не инструмент ускорения, а источник нестабильности, и честнее заплатить подъёмом. Отдельный случай — отладка: упавший тест на переиспользуемом контейнере оставляет своё состояние внутри, и заглянуть в него через docker exec бывает полезнее любого лога — побочный бонус общей базы.