👁 Image
Ductus.FluentDocker 2.85.0

FluentDocker

👁 CI
👁 NuGet
👁 Downloads
👁 License

This library enables docker and docker-compose interactions using a Fluent API. It is supported on Linux, Windows and Mac. It also has support for the legacy docker-machine interactions.

Have a look at the project site for more information.

Sample Fluent API usage

 using (
 var container =
 new Builder().UseContainer()
 .UseImage("kiasaki/alpine-postgres")
 .ExposePort(5432)
 .WithEnvironment("POSTGRES_PASSWORD=mysecretpassword")
 .WaitForPort("5432/tcp", 30000 /*30s*/)
 .Build()
 .Start())
 {
 var config = container.GetConfiguration(true);
 Assert.AreEqual(ServiceRunningState.Running, config.State.ToServiceState());
 }

The following snippet fires up Postgres and waits for it to be ready. It uses docker-compose file to perform the task.

 var file = Path.Combine(Directory.GetCurrentDirectory(),
 (TemplateString) "Resources/ComposeTests/WordPress/docker-compose.yml");

 // @formatter:off
 using (var svc = new Builder()
 .UseContainer()
 .UseCompose()
 .FromFile(file)
 .RemoveOrphans()
 .WaitForHttp("wordpress", "http://localhost:8000/wp-admin/install.php") 
 .Build().Start())
 // @formatter:on
 {
 // We now have a running WordPress with a MySql database 
 var installPage = await "http://localhost:8000/wp-admin/install.php".Wget();

 Assert.IsTrue(installPage.IndexOf("https://wordpress.org/", StringComparison.Ordinal) != -1);
 Assert.AreEqual(1, svc.Hosts.Count); // The host used by compose
 Assert.AreEqual(2, svc.Containers.Count); // We can access each individual container
 Assert.AreEqual(2, svc.Images.Count); // And the images used.
 }

👀 It has tons of features, including a low-level command style, services and finally, the Fluent API on top of it.