Testy integracyjne z Testcontainers¶
Strona opisuje, jak uruchamiać i pisać testy integracyjne apollo-backend, które korzystają z biblioteki Testcontainers.
Jest dla programistów, którzy uruchamiają testy lokalnie, dodają nowe specyfikacje albo zmieniają infrastrukturę testów.
Tworzenie danych w testach opisuje strona Dane testowe z build-test-data.
Po co Testcontainers¶
Testy integracyjne uruchamiają cały kontekst Grails, więc potrzebują Postgresa, Redisa i RabbitMQ. Testcontainers startuje te usługi w kontenerach Dockera na czas testów i usuwa je po zakończeniu.
Wymagania¶
- Działający Docker.
- Testcontainers w wersji
1.21.4lub nowszej.
Uruchamianie¶
Wszystkie testy integracyjne:
Jedna specyfikacja:
Pisanie specyfikacji¶
@Integration
@Rollback
class MySpec extends IntegrationSpec {
SomeRepositoryService someRepositoryService
void 'robi coś na prawdziwej bazie'() {
given:
Checkpoint checkpoint = Checkpoint.build()
expect:
someRepositoryService.find(checkpoint) != null
}
}
Zasady dla nowych specyfikacji:
- Specyfikacja dziedziczy po
IntegrationSpec, bo bez tego kontenery nie wystartują. - Adnotacja
@Rollbackcofa zmiany po każdym teście, a baza jest współdzielona przez wszystkie specyfikacje. - Dane tworzymy przez
Encja.build(), zgodnie ze stroną o danych testowych. - Test współbieżności nie może używać
@Rollback, bo wątki muszą widzieć zatwierdzone dane. Taki test sam tworzy dane z unikalną nazwą i sprząta wcleanup(). Wzorem jestGaplessCounterRepositoryServiceSpec.
Ostatnia zmiana: 2026-10-16 · Dariusz Bakowski
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e