# 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](<https://docs.logintegra.com/apollo-backend/dane-testowe-build-test-data/index.md>).

## 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](<https://docs.logintegra.com/apollo-backend/dane-testowe-build-test-data/index.md>).
- 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`.
