This is a continuation of an earlier post Integration Testing Postgres Store. In this tutorial I will extend the sample to use testcontainers-dotnet to spin up database container and apply migrations before executing our integration tests.
Prior to this sample, pre-requisite of running integration tests was that database server is running either on machine or in a container and migrations are applied. This step removes that manual step.
Setup
Lets start by adding nuget packages
dotnet add package TestContainers.Container.Database.PostgreSql --version 1.5.4
We would need to start 2 containers before running our integration tests.
- Database Container - hosting the database server
- Migrations Container - container to apply database migrations
MigrationsContainer
We will start by adding a new class MigrationsContainer
inheriting from GenericContainer
. We will add a helper method to create an image using Dockerfile
from our db
folder.
We will also add a helper method GetExitCodeAsync
, this will use the docker client to wait for migrations container to exit, we need this so that we only run our integration tests after the migrations have been applied.
MigrationsContainer
would look like following
using Docker.DotNet;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Logging;
using TestContainers.Container.Abstractions;
using TestContainers.Container.Abstractions.Hosting;
using TestContainers.Container.Abstractions.Images;
namespace Movies.Api.Tests.Integration;
public class MigrationsContainer : GenericContainer
{
[ActivatorUtilitiesConstructor]
public MigrationsContainer(IDockerClient dockerClient, ILoggerFactory loggerFactory)
: base(CreateDefaultImage(), dockerClient, loggerFactory)
{
this.DockerClient = dockerClient;
}
internal IDockerClient DockerClient { get; }
public async Task<long> GetExitCodeAsync()
{
var containerWaitResponse = await this.DockerClient.Containers.WaitContainerAsync(this.ContainerId);
return containerWaitResponse.StatusCode;
}
private static IImage CreateDefaultImage()
{
return new ImageBuilder<DockerfileImage>()
.ConfigureImage((context, image) =>
{
image.DockerfilePath = "Dockerfile";
image.DeleteOnExit = true;
image.BasePath = "../../../../db";
})
.Build();
}
}
DatabaseFixture
For DatabaseFixture
we will add following fields
private readonly bool useServiceDatabase;
private readonly PostgreSqlContainer? databaseContainer;
private MigrationsContainer? migrationsContainer;
useServiceDatabase
will be helpful if we want to just use the database server running either on our host or running in a container and debug a test, this would reduce the startup time while debugging and fixing tests or running the red-green-refactor cycle.
Other 2 variables are to hold the references to containers and we will use those to cleanup after the tests are complete.
We will setup databaseContainer in the constructor by setting the Docker image to use using ConfigureDockerImageName
and configuring username, password and database name using ConfigureDatabaseConfiguration
extension method. Constructor will look like following
public DatabaseFixture()
{
this.useServiceDatabase = Debugger.IsAttached;
if (!this.useServiceDatabase)
{
Environment.SetEnvironmentVariable("REAPER_DISABLED", true.ToString());
this.databaseContainer = new ContainerBuilder<PostgreSqlContainer>()
.ConfigureDockerImageName("postgres:14-alpine")
.ConfigureDatabaseConfiguration("postgres", "Password123", "moviesdb")
.Build();
}
}
InitializeAsync
To start with if we are running in debug mode we will just set the connection string to point to database server already running either on our host or in container.
Fun starts if test is not running in debug mode. We start off by starting our database container. After that we will configure and build our migrations container. This needs to be done here becuase we need to pass connection string to database container to migrations container.
After the image is built, we will start migrations container and wait for it to exit, if the exit code is 0 that would indicate migrations are applied successfully. At this point we will setup ConnectionString
in DatabaseFixture
that will be used in the integration tests.
Complete code for InitializeAsync
method is as follows
public async Task InitializeAsync()
{
if (this.useServiceDatabase)
{
this.ConnectionString = "Host=localhost;Username=postgres;Password=Password123;Database=moviesdb;Integrated Security=false;";
return;
}
await this.databaseContainer!.StartAsync();
this.migrationsContainer = new ContainerBuilder<MigrationsContainer>()
.ConfigureContainer((context, container) =>
{
var connectionString = $"Host=localhost;Port={this.databaseContainer.GetMappedPort(PostgreSqlContainer.DefaultPort)};Username=postgres;Password=Password123;Database=moviesdb;Integrated Security=false;";
container.Command = new List<string>
{
connectionString,
};
})
.ConfigureNetwork((hostContext, builderContext) =>
{
return new NetworkBuilder<UserDefinedNetwork>()
.ConfigureNetwork((context, network) => { network.NetworkName = "host"; })
.Build();
})
.Build();
await this.migrationsContainer.StartAsync();
var exitCode = await this.migrationsContainer.GetExitCodeAsync();
if (exitCode > 0)
{
throw new Exception("Database migration failed");
}
this.ConnectionString = $"Host={this.databaseContainer.GetDockerHostIpAddress()};Port={this.databaseContainer.GetMappedPort(PostgreSqlContainer.DefaultPort)};Username=postgres;Password=Password123;Database=moviesdb;Integrated Security=false;";
}
DisposeAsync
DisposeAsync
is simple, if we are not running in debug mode, we double check if database and migration continers are not null we stop those using StopAsync
.
Complete source of DatabaseFixture
is as follows
using System.Diagnostics;
using TestContainers.Container.Abstractions.Hosting;
using TestContainers.Container.Abstractions.Networks;
using TestContainers.Container.Database.PostgreSql;
using TestContainers.Container.Database.Hosting;
namespace Movies.Api.Tests.Integration;
public class DatabaseFixture : IAsyncLifetime
{
public string ConnectionString { get; private set; } = default!;
private readonly bool useServiceDatabase;
private readonly PostgreSqlContainer? databaseContainer;
private MigrationsContainer? migrationsContainer;
public DatabaseFixture()
{
this.useServiceDatabase = Debugger.IsAttached;
if (!this.useServiceDatabase)
{
Environment.SetEnvironmentVariable("REAPER_DISABLED", true.ToString());
this.databaseContainer = new ContainerBuilder<PostgreSqlContainer>()
.ConfigureDockerImageName("postgres:14-alpine")
.ConfigureDatabaseConfiguration("postgres", "Password123", "moviesdb")
.Build();
}
}
public async Task InitializeAsync()
{
if (this.useServiceDatabase)
{
this.ConnectionString = "Host=localhost;Username=postgres;Password=Password123;Database=moviesdb;Integrated Security=false;";
return;
}
await this.databaseContainer!.StartAsync();
this.migrationsContainer = new ContainerBuilder<MigrationsContainer>()
.ConfigureContainer((context, container) =>
{
var connectionString = $"Host=localhost;Port={this.databaseContainer.GetMappedPort(PostgreSqlContainer.DefaultPort)};Username=postgres;Password=Password123;Database=moviesdb;Integrated Security=false;";
container.Command = new List<string>
{
connectionString,
};
})
.ConfigureNetwork((hostContext, builderContext) =>
{
return new NetworkBuilder<UserDefinedNetwork>()
.ConfigureNetwork((context, network) => { network.NetworkName = "host"; })
.Build();
})
.Build();
await this.migrationsContainer.StartAsync();
var exitCode = await this.migrationsContainer.GetExitCodeAsync();
if (exitCode > 0)
{
throw new Exception("Database migration failed");
}
this.ConnectionString = $"Host={this.databaseContainer.GetDockerHostIpAddress()};Port={this.databaseContainer.GetMappedPort(PostgreSqlContainer.DefaultPort)};Username=postgres;Password=Password123;Database=moviesdb;Integrated Security=false;";
}
public async Task DisposeAsync()
{
if (this.useServiceDatabase)
{
return;
}
if (this.migrationsContainer != null)
{
await this.migrationsContainer.StopAsync();
}
if (this.databaseContainer != null)
{
await this.databaseContainer.StopAsync();
}
}
}
Test
Now Run Test
should automatically perform following
- Spin up a Database container
- Create an image for migrations
- Spin up migrations container to execute migrations
- Execute integration tests
- Stop containers
This is all for this post, this automates spining up database and migrations before running integration tests.
Source
Source code for the demo application is hosted on GitHub in blog-code-samples repository.
References
In no particular order
Top comments (0)