.NET Conf

Testcontainers dla .NET to przełomowe rozwiązanie w testowaniu integracyjnym aplikacji .NET, pozwalające programistom uruchamiać rzeczywiste usługi w kontenerach Docker podczas testów. Biblioteka korzysta z .NET Docker remote API i umożliwia łatwe tworzenie środowisk testowych odzwierciedlających produkcję – całkowicie eliminując potrzebę mockowania lub uruchamiania usług w pamięci. Automatyczne zarządzanie cyklem życia kontenerów – inicjalizacja, konfiguracja, uruchomienie, a następnie ich automatyczne usuwanie po teście – istotnie upraszcza testowanie i zwiększa wiarygodność wyników.

Spis treści [odkryj]

Fundamenty i filozofia Testcontainers dla .NET

Testcontainers dla .NET to część globalnego ekosystemu Testcontainers, początkowo stworzonego dla Javy, a obecnie dostępnego także dla Go, Node.js, Python, Rust i .NET. Filozofia tego narzędzia polega na testowaniu integracyjnym z użyciem rzeczywistych usług zamiast ich symulacji, pozwalając uzyskać maksymalnie wiarygodne wyniki i pewność działania w produkcji.

Testcontainers rozwiązuje typowe wyzwania związane z klasycznym testowaniem integracyjnym, takie jak:

  • konieczność samodzielnej konfiguracji i utrzymywania testowej infrastruktury,
  • problemy z izolacją i konflikty danych przy równoległym wykonywaniu testów,
  • skomplikowane procedury przygotowania i czyszczenia środowiska,
  • ograniczenia stosowania rozwiązań in-memory, które bywają niezgodne z produkcyjnymi usługami.

Wykorzystanie konteneryzacji Docker do uruchamiania rzeczywistych usług w pełnej izolacji pozwala każdemu testowi działać na osobnym zestawie kontenerów, eliminując konflikty danych. Cały cykl życia kontenerów jest automatycznie obsługiwany przez bibliotekę – od startu do usunięcia.

Implementacja .NET została zbudowana w oparciu o .NET Docker remote API, zapewniając pełną integrację ze środowiskiem .NET i kompatybilność z .NET Framework, .NET Core oraz .NET 5+.

Architektura i mechanizmy działania

Architektura Testcontainers opiera się na kilku głównych komponentach. Poniżej znajdziesz kluczowe z nich:

  • ContainerBuilder oraz wyspecjalizowane buildery – służą do programowej konfiguracji i tworzenia kontenerów Docker z określonymi parametrami, jak obraz, zmienne środowiskowe, porty czy woluminy,
  • Wzorzec builder pattern – umożliwia elastyczną konfigurację kontenerów,
  • Wait strategies – mechanizmy sprawdzające gotowość kontenera (port, HTTP, polecenie),
  • Zarządzanie cyklem życia kontenerów – automatyczny start i usuwanie przy pomocy shutdown hooks oraz kontenera Ryuk,
  • Integracja z frameworkami testowymi (xUnit, NUnit, MSTest) – wykorzystanie np. interfejsu IAsyncLifetime do asynchronicznego zarządzania cyklem życia kontenerów.

Przykładowa konfiguracja kontenera SQL Server:

MsSqlContainer dbContainer = new MsSqlBuilder().WithImage("mcr.microsoft.com/mssql/server:2022-latest").WithPassword("Strong_password_123!").Build()

Dzięki temu można elastycznie tworzyć i testować z rzeczywistymi usługami bez ręcznego przygotowania i czyszczenia środowiska.

Instalacja i konfiguracja podstawowa

Instalacja Testcontainers dla .NET polega na dodaniu pakietu NuGet do projektu testowego. Pakiet bazowy dodasz poleceniem:

dotnet add package Testcontainers --version 4.6.0

Oprócz pakietu bazowego dostępne są wyspecjalizowane biblioteki dla konkretnych usług, takich jak PostgreSQL, MsSQL, Redis czy MongoDb. Przykład dla PostgreSQL:

dotnet add package Testcontainers.PostgreSql

Do pracy wymagany jest działający Docker daemon (uruchomiony lokalnie lub zdalnie), np. przez Docker Desktop bądź Docker Engine na Linuksie. Testcontainers automatycznie wykrywa i łączy się ze środowiskiem Docker.

Rekomendowana struktura projektu to:

  • projekt główny z logiką aplikacji,
  • projekt testowy z testami integracyjnymi.

Przykładowa inicjalizacja za pomocą narzędzi .NET CLI:


dotnet new sln -o TestcontainersDemo
dotnet new classlib -o CustomerService
dotnet new xunit -o CustomerService.Tests

W projekcie testowym dodaj również odpowiednie zależności, np. Npgsql dla PostgreSQL:

dotnet add ./CustomerService.Tests.csproj package Npgsql

Testcontainers automatycznie generuje connection stringi, jednak aplikacja powinna umożliwiać dynamiczne przekazywanie tych parametrów, np. poprzez dependency injection.

Podstawowe wzorce użycia i strategie testowania

Wybór wzorca użycia Testcontainers zależy od oczekiwanej izolacji i wydajności testów:

  • Izolacja na poziomie testu – każdy test uruchamia własny zestaw kontenerów, co daje pełną izolację,
  • Izolacja na poziomie klasy testowej – kontenery dzielone przez całą klasę testową, kompromis między izolacją a wydajnością,
  • Izolacja kolekcji testów – kontenery współdzielone przez wiele klas testowych, gwarantując najwyższą wydajność kosztem izolacji.

Wybór strategii zależy od niezależności testów i wymagań projektu – im większa współdzieloność, tym szybsze testy, ale mniejsza czystość środowiska.

Praca z bazami danych i systemami przechowywania danych

Najczęstsze zastosowanie Testcontainers to testy z bazami danych. Biblioteka obsługuje zarówno relacyjne bazy danych, jak i cache, czy bazy NoSQL:

  • Microsoft SQL Server – konfiguracja przez MsSqlBuilder,
  • PostgreSQL – korzystanie z PostgreSqlBuilder z lekkimi obrazami typu postgres:15-alpine,
  • Automatyczne generowanie connection stringów dostępnych przez GetConnectionString().

Inicjalizacja schematów i danych testowych może być realizowana za pomocą skryptów startowych, migracji Entity Framework, ADO.NET lub DbUp.

Możliwe jest jednoczesne uruchamianie wielu kontenerów, co pozwala odwzorować złożone środowisko produkcyjne.

Testowanie usług HTTP i mikrousług

Testcontainers sprawdza się doskonale przy testowaniu mikrousług i integracji z usługami HTTP. Możesz:

  • testować rzeczywiste implementacje usług HTTP (lub narzędzia jak WireMock) w kontenerach,
  • tworzyć środowiska z wieloma mikrousługami poprzez docker-compose i sieci Docker,
  • testować api gateway i load balancerów (np. nginx, HAProxy),
  • zarządzać danymi testowymi przez specjalne endpointy lub predefiniowane obrazy z danymi.

Optymalizacja wydajności i zarządzanie zasobami

Wydajność testów z użyciem Testcontainers można znacznie poprawić stosując następujące techniki:

  • stosowanie lekkich obrazów Docker (np. Alpine),
  • ponowne używanie kontenerów w trybie reuse,
  • równoległe uruchamianie kontenerów,
  • cache’owanie obrazów w pipeline’ach CI/CD,
  • dostosowywanie strategii oczekiwania i timeoutów,
  • monitorowanie zasobów poprzez limity pamięci i CPU.

Integracja z systemami CI/CD

Testcontainers świetnie współpracuje z popularnymi systemami CI/CD. Oto, jak wygląda jego integracja z poszczególnymi platformami:

  • GitHub Actions – obsługa Docker i gotowe obrazy z .NET SDK,
  • GitLab CI – wymaga Docker-in-Docker (DinD) lub Testcontainers Cloud,
  • Azure DevOps – dostępność Docker na agentach hosted,
  • Jenkins – integracja przez Docker plugin,
  • Testcontainers Cloud – możliwość uruchamiania testów w chmurze bez dostępu do lokalnego daemon Docker.

Należy wdrażać cache obrazów, publikować raporty testowe jako artefakty oraz monitorować limity i timeouty dla zoptymalizowanego pipeline’u.

Zaawansowane scenariusze i wzorce architektoniczne

Testcontainers obsługuje również wysoce zaawansowane scenariusze:

  • testowanie architektury event-driven (RabbitMQ, Kafka, Azure Service Bus),
  • testy distributed cache z wymuszoną awarią (Redis, Memcached),
  • testy środowisk multi-tenant przez wiele baz lub schematów,
  • testy observability, distributed tracing (Jaeger, Zipkin),
  • testy bezpieczeństwa (Keycloak, CA, LDAP),
  • testy wydajności przez uruchamianie generatorów ruchu jako kontenerów.

Rozwiązywanie problemów i najlepsze praktyki

Aby minimalizować ryzyko i zoptymalizować pracę z Testcontainers, stosuj poniższe praktyki:

  • konfiguruj odpowiednie wait strategies i timeouty,
  • stosuj dynamiczne mapowanie portów,
  • dbaj o poprawne zamykanie kontenerów (IAsyncDisposable),
  • sprawdzaj uprawnienia sieciowe i użytkowników Docker,
  • precyzyjnie oznaczaj wersje obrazów i utrzymuj ich rejestr,
  • włącz verbose logging,
  • zapewniaj izolację danych i czyszczenie stanu przed testami,
  • zarządzaj zgodnością wersji bibliotek, frameworków i obrazów.

Bezpieczeństwo i zgodność z politykami organizacyjnymi

Stosując Testcontainers w środowiskach enterprise, zwróć szczególną uwagę na:

  • korzystanie z prywatnych, skanowanych rejestrów obrazów,
  • izolowaną sieć Docker bez dostępu do zasobów produkcyjnych,
  • bezpieczne przechowywanie sekretów i haseł,
  • scentralizowany audyt i rejestr wersji obrazów,
  • ustalanie limitów CPU, pamięci i przestrzeni dla testowych kontenerów,
  • ochronę danych testowych zgodnie z RODO/GDPR.

Przyszłość Testcontainers i trendy technologiczne

Kierunki rozwoju Testcontainers obejmują:

  • cloud-native testing z rosnącą rolą Testcontainers Cloud,
  • pełną integrację z Kubernetes na poziomie testów podów i operatorów,
  • automatyczne testy wspierane AI,
  • zaawansowane cache’owanie i monitorowanie zasobów,
  • enforce polityk security i skanowanie obrazów na etapie testów,
  • narzędzia do monitorowania i debugowania kontenerów z poziomu IDE.

Rekomendacje praktyczne

Testcontainers dla .NET to fundamentalna zmiana w testach integracyjnych – rezygnacja z symulacji na rzecz kontrolowanych środowisk z rzeczywistymi usługami. Oto najważniejsze zalety:

  • eliminacja dedykowanej infrastruktury testowej,
  • pełna automatyzacja cyklu życia usług testowych,
  • testowanie faktycznych wersji usług,
  • weryfikacja poprawności działania aplikacji w rzeczywistym stacku technologicznym,
  • szybka integracja z .NET i popularnymi frameworkami,
  • dobór poziomu izolacji do wymagań zespołu i typu projektu.

Testcontainers dla .NET znacząco podnosi rzetelność, szybkość i pewność testowania nowoczesnych aplikacji.