Make the image platform configurable

Author: 0xced

src/Testcontainers/Clients/DockerImageOperations.cs

@@ -60,6 +60,7 @@ public async Task CreateAsync(IImage image, IDockerRegistryAuthenticationConfigu
       var createParameters = new ImagesCreateParameters
       {
         FromImage = image.FullName,
+        Platform = image.Platform,
       };
 
       var authConfig = new AuthConfig

src/Testcontainers/Images/DockerImage.cs

@@ -31,12 +31,15 @@ public sealed class DockerImage : IImage
     [CanBeNull]
     private readonly string _digest;
 
+    [CanBeNull]
+    private readonly string _platform;
+
     /// <summary>
     /// Initializes a new instance of the <see cref="DockerImage" /> class.
     /// </summary>
     /// <param name="image">The image.</param>
     public DockerImage(IImage image)
-      : this(image.Repository, image.Registry, image.Tag, image.Digest)
+      : this(image.Repository, image.Registry, image.Tag, image.Digest, image.Platform)
     {
     }
 
@@ -57,19 +60,22 @@ public DockerImage(string image)
     /// <param name="registry">The registry.</param>
     /// <param name="tag">The tag.</param>
     /// <param name="digest">The digest.</param>
+    /// <param name="platform">The platform.</param>
     /// <param name="hubImageNamePrefix">The Docker Hub image name prefix.</param>
     /// <example><c>fedora/httpd:version1.0</c> where <c>fedora/httpd</c> is the repository and <c>version1.0</c> the tag.</example>
     public DockerImage(
       string repository,
       string registry = null,
       string tag = null,
       string digest = null,
+      string platform = null,
       string hubImageNamePrefix = null)
       : this(
         TrimOrDefault(repository),
         TrimOrDefault(registry),
         TrimOrDefault(tag, tag == null && digest == null ? LatestTag : null),
         TrimOrDefault(digest),
+        TrimOrDefault(platform),
         hubImageNamePrefix == null ? [] : hubImageNamePrefix.Trim(TrimChars).Split(SlashChar, 2, StringSplitOptions.RemoveEmptyEntries))
     {
     }
@@ -79,6 +85,7 @@ private DockerImage(
       string registry,
       string tag,
       string digest,
+      string platform,
       string[] substitutions)
     {
       _ = Guard.Argument(repository, nameof(repository))
@@ -109,6 +116,7 @@ private DockerImage(
 
       _tag = tag;
       _digest = digest;
+      _platform = platform;
     }
 
     /// <inheritdoc />
@@ -123,6 +131,9 @@ private DockerImage(
     /// <inheritdoc />
     public string Digest => _digest;
 
+    /// <inheritdoc />
+    public string Platform => _platform;
+
     /// <inheritdoc />
     public string FullName
     {

src/Testcontainers/Images/FutureDockerImage.cs

@@ -68,6 +68,16 @@ public string Digest
       }
     }
 
+    /// <inheritdoc />
+    public string Platform
+    {
+      get
+      {
+        ThrowIfResourceNotFound();
+        return _configuration.Image.Platform;
+      }
+    }
+
     /// <inheritdoc />
     public string FullName
     {

src/Testcontainers/Images/IImage.cs

@@ -33,6 +33,15 @@ public interface IImage
     [CanBeNull]
     string Digest { get; }
 
+    /// <summary>
+    /// Gets the platform. Supported format is <c>&lt;os&gt;|&lt;arch&gt;|&lt;os&gt;/&lt;arch&gt;[/&lt;variant&gt;]</c>. Either the operating system or the architecture or both can be provided.
+    /// </summary>
+    /// <remarks>
+    /// See https://github.com/containerd/platforms for more information.
+    /// </remarks>
+    [CanBeNull]
+    string Platform { get; }
+
     /// <summary>
     /// Gets the full image name.
     /// </summary>

tests/Testcontainers.Tests/Fixtures/Images/HealthCheckFixture.cs

@@ -23,6 +23,8 @@ public sealed class HealthCheckFixture : IImage, IAsyncLifetime
 
     public string Digest => _image.Digest;
 
+    public string Platform => _image.Platform;
+
     public string FullName => _image.FullName;
 
     public string GetHostname()