ProtoTest.Testcontainers 1.1.0

ProtoTest.Testcontainers

Shared container-resource support used by ProtoTest's Testcontainers packages, and the application container for an application under test.

Use it directly to start an application image with the run, or when building another run-scoped container integration.

ProtoContainerResource<TContainer> handles start-once and release-once behaviour. Register a resource as a target's UseContainer(...) provider when the host should start it and expose values such as a connection string. The technology packages (ProtoTest.Sql.Testcontainers, ProtoTest.Messaging.RabbitMq.Testcontainers, ProtoTest.Devices.Mqtt.Testcontainers) build on this contract: run-scoped start-once, TryStart reporting instead of throwing, and UseContainer(...) chain providers.

ApplicationContainer starts an application image as run infrastructure and publishes the mapped address as ProtoTest:Applications:{application}:BaseUrl, so the application's REST clients, browser sessions and the readiness probe resolve that one container:

var api = ApplicationContainer.Container("Api", "mcr.microsoft.com/dotnet/samples:aspnetapp", port: 8080);
builder
    .AddInfrastructure(
        api.Application,
        chain => chain
            .UseConfigured()      // a configured key skips the container
            .UseContainer(api),
        api.BaseUrlKey)
    .AddHttpReadiness(api.Application, "/")
    .AddApplication(api.Application, app => app
        .AddRest(rest => rest.AddClient(api.Application))
        .AddWeb());

The published address is http://{hostname}:{mapped port}; the default readiness check waits for the declared port to accept a connection, and the configure callback adds container build options or a Testcontainers wait strategy. A machine without a container runtime reports the reason through TryStart, so the suite can skip instead of failing.

UseContainer(PostgresDatabase.Container()) adds the container behind the Docker probe (DockerProbe.IsAvailable()), so a configured or AppHost provider earlier in the chain wins and the container starts only when the environment cannot serve the target.

The package does not depend on a specific Testcontainers module. Technology packages supply their own module container (for example PostgresDatabase); ApplicationContainer builds on the Testcontainers core library.

Limits

• The image and its readiness belong to the suite. ApplicationContainer knows only the image and the port it listens on - not the application's health endpoint, environment or protocol. Add AddHttpReadiness(application, path) for an HTTP-level wait.
• One scheme: http. The mapped address is published as http://…; an image that only serves HTTPS is not covered - point the application at that environment through ProtoTest:Applications:{application}:BaseUrl instead.
• UseContainer follows the Docker probe, not the piece's own condition. A provider earlier in the chain (a configured key, an AppHost resource) wins without probing, and a machine whose daemon does not answer skips the container with Docker is available as the recorded reason.

Learn more

• Infrastructure
• ASP.NET Core
• Extending ProtoTest
• Package source