feat: Add Docker Engine v29 support

Author: HofmeisterAn

Directory.Packages.props

@@ -5,8 +5,8 @@
     </PropertyGroup>
     <ItemGroup>
         <PackageVersion Include="BouncyCastle.Cryptography" Version="2.6.2"/>
-        <PackageVersion Include="Docker.DotNet.Enhanced.X509" Version="3.130.0"/>
-        <PackageVersion Include="Docker.DotNet.Enhanced" Version="3.130.0"/>
+        <PackageVersion Include="Docker.DotNet.Enhanced.X509" Version="3.131.1"/>
+        <PackageVersion Include="Docker.DotNet.Enhanced" Version="3.131.1"/>
         <PackageVersion Include="Microsoft.Bcl.AsyncInterfaces" Version="8.0.0"/>
         <PackageVersion Include="Microsoft.Bcl.HashCode" Version="1.1.1"/>
         <PackageVersion Include="Microsoft.Extensions.Logging.Abstractions" Version="8.0.3"/>

build/Tasks.cs

@@ -16,7 +16,9 @@ public void DotNetTest(SolutionProject project)
             Filter = Parameters.TestFilter,
             ResultsDirectory = Parameters.Paths.Directories.TestResultsDirectoryPath,
             ArgumentCustomization = args => args
-                .AppendSwitchQuoted("--blame-hang-timeout", "5m"),
+                // The windows-2025 GH-hosted runner no longer has cached images. Pulling the
+                // servercore:ltsc2025 image takes significantly longer.
+                .AppendSwitchQuoted("--blame-hang-timeout", "10m"),
         });
     }
 }

src/Testcontainers/Clients/ContainerConfigurationConverter.cs

@@ -97,7 +97,8 @@ public ToNetworks(IContainerConfiguration configuration)
 
       public override IEnumerable<KeyValuePair<string, EndpointSettings>> Convert([CanBeNull] IEnumerable<INetwork> source)
       {
-        return source?.Select(network => new KeyValuePair<string, EndpointSettings>(network.Name, new EndpointSettings { Aliases = _configuration.NetworkAliases?.ToList() }));
+        var endpointSettings = new EndpointSettings { Aliases = _configuration.NetworkAliases?.ToList(), MacAddress = _configuration.MacAddress };
+        return source?.Select(network => new KeyValuePair<string, EndpointSettings>(network.Name, endpointSettings));
       }
     }
 

src/Testcontainers/Clients/DockerContainerOperations.cs

@@ -204,7 +204,6 @@ public async Task<string> RunAsync(IContainerConfiguration configuration, Cancel
         Image = configuration.Image.FullName,
         Name = configuration.Name,
         Hostname = configuration.Hostname,
-        MacAddress = configuration.MacAddress,
         WorkingDir = configuration.WorkingDirectory,
         Entrypoint = converter.Entrypoint,
         Cmd = converter.Command,

src/Testcontainers/Clients/TraceProgress.cs

@@ -15,29 +15,35 @@ public TraceProgress(ILogger logger)
 
     public void Report(JSONMessage value)
     {
-#pragma warning disable CA1848, CA2254
-
-      if (!string.IsNullOrWhiteSpace(value.Status))
+      if (value.Error != null)
       {
-        _logger.LogDebug(value.Status.TrimEnd());
-      }
+        _logger.LogError(
+          "ID={ID}: {Error}",
+          value.ID,
+          value.Error.Message);
 
-      if (!string.IsNullOrWhiteSpace(value.Stream))
-      {
-        _logger.LogDebug(value.Stream.TrimEnd());
+        return;
       }
 
-      if (!string.IsNullOrWhiteSpace(value.ProgressMessage))
+      if (value.Progress != null && value.Progress.Total > 0)
       {
-        _logger.LogDebug(value.ProgressMessage.TrimEnd());
+        var percentage = (double)value.Progress.Current / value.Progress.Total * 100;
+
+        _logger.LogDebug(
+          "ID={ID}: {Status} {Percentage,6:F2}% ({Current}/{Total})",
+          value.ID,
+          value.Status,
+          percentage,
+          value.Progress.Current,
+          value.Progress.Total);
       }
-
-      if (!string.IsNullOrWhiteSpace(value.ErrorMessage))
+      else
       {
-        _logger.LogError(value.ErrorMessage.TrimEnd());
+        _logger.LogDebug(
+          "ID={ID}: {Status}",
+          value.ID,
+          value.Status);
       }
-
-#pragma warning restore CA1848, CA2254
     }
   }
 }

src/Testcontainers/Containers/ExecResult.cs

@@ -14,7 +14,7 @@ public readonly struct ExecResult
     /// <param name="stdout">The stdout output.</param>
     /// <param name="stderr">The stderr output.</param>
     /// <param name="exitCode">The exit code.</param>
-    public ExecResult(string stdout, string stderr, long exitCode)
+    public ExecResult(string stdout, string stderr, long? exitCode)
     {
       Stdout = stdout;
       Stderr = stderr;
@@ -37,6 +37,6 @@ public ExecResult(string stdout, string stderr, long exitCode)
     /// Gets the exit code.
     /// </summary>
     [PublicAPI]
-    public long ExitCode { get; }
+    public long? ExitCode { get; }
   }
 }

tests/Testcontainers.Commons/CommonImages.cs

@@ -15,5 +15,5 @@ public static class CommonImages
 
     public static readonly IImage Nginx = new DockerImage("nginx:1.22");
 
-    public static readonly IImage ServerCore = new DockerImage("mcr.microsoft.com/windows/servercore:ltsc2022");
+    public static readonly IImage ServerCore = new DockerImage("mcr.microsoft.com/windows/servercore:ltsc2025");
 }

tests/Testcontainers.Platform.Windows.Tests/.runs-on

@@ -1 +1 @@
-windows-2022
+windows-2025

tests/Testcontainers.Tests/Unit/Containers/Unix/TestcontainersContainerTest.cs

@@ -89,8 +89,12 @@ public async Task MacAddress()
         // Given
         const string macAddress = "92:95:5e:30:fe:6d";
 
+        await using var network = new NetworkBuilder()
+          .Build();
+
         await using var container = new ContainerBuilder(CommonImages.Alpine)
           .WithEntrypoint(CommonCommands.SleepInfinity)
+          .WithNetwork(network)
           .WithMacAddress(macAddress)
           .Build();