Przejdź do treści

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.4 lub nowszej.

Uruchamianie

Wszystkie testy integracyjne:

./gradlew cleanIntegrationTest integrationTest

Jedna specyfikacja:

./gradlew integrationTest --tests logintegra.CheckpointConfirmationTokenSpec

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 @Rollback cofa 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 w cleanup(). Wzorem jest GaplessCounterRepositoryServiceSpec.

Ostatnia zmiana: 2026-10-16 · Dariusz Bakowski
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e