fix: Throw exception if Docker resource does not exist instead of silently ignoring it

src/Testcontainers/Clients/DockerContainerOperations.cs

@@ -32,26 +32,26 @@ public async Task<IEnumerable<ContainerListResponse>> GetAllAsync(FilterByProper
     }
 
     public async Task<ContainerInspectResponse> ByIdAsync(string id, CancellationToken ct = default)
+    {
+      return await DockerClient.Containers.InspectContainerAsync(id, ct)
+        .ConfigureAwait(false);
+    }
+
+    public async Task<bool> ExistsWithIdAsync(string id, CancellationToken ct = default)
     {
       try
       {
-        return await DockerClient.Containers.InspectContainerAsync(id, ct)
+        _ = await ByIdAsync(id, ct)
           .ConfigureAwait(false);
+
+        return true;
       }
-      catch (DockerApiException)
+      catch (DockerContainerNotFoundException)
       {
-        return null;
+        return false;
       }
     }
 
-    public async Task<bool> ExistsWithIdAsync(string id, CancellationToken ct = default)
-    {
-      var response = await ByIdAsync(id, ct)
-        .ConfigureAwait(false);
-
-      return response != null;
-    }
-
     public async Task<long> GetExitCodeAsync(string id, CancellationToken ct = default)
     {
       var response = await DockerClient.Containers.WaitContainerAsync(id, ct)

src/Testcontainers/Clients/DockerImageOperations.cs

@@ -35,26 +35,26 @@ public async Task<IEnumerable<ImagesListResponse>> GetAllAsync(FilterByProperty
     }
 
     public async Task<ImageInspectResponse> ByIdAsync(string id, CancellationToken ct = default)
+    {
+      return await DockerClient.Images.InspectImageAsync(id, ct)
+        .ConfigureAwait(false);
+    }
+
+    public async Task<bool> ExistsWithIdAsync(string id, CancellationToken ct = default)
     {
       try
       {
-        return await DockerClient.Images.InspectImageAsync(id, ct)
+        _ = await ByIdAsync(id, ct)
           .ConfigureAwait(false);
+
+        return true;
       }
-      catch (DockerApiException)
+      catch (DockerImageNotFoundException)
       {
-        return null;
+        return false;
       }
     }
 
-    public async Task<bool> ExistsWithIdAsync(string id, CancellationToken ct = default)
-    {
-      var response = await ByIdAsync(id, ct)
-        .ConfigureAwait(false);
-
-      return response != null;
-    }
-
     public async Task CreateAsync(IImage image, IDockerRegistryAuthenticationConfiguration dockerRegistryAuthConfig, CancellationToken ct = default)
     {
       var createParameters = new ImagesCreateParameters

src/Testcontainers/Clients/DockerNetworkOperations.cs

@@ -30,26 +30,26 @@ public async Task<IEnumerable<NetworkResponse>> GetAllAsync(FilterByProperty fil
     }
 
     public async Task<NetworkResponse> ByIdAsync(string id, CancellationToken ct = default)
+    {
+      return await DockerClient.Networks.InspectNetworkAsync(id, ct)
+        .ConfigureAwait(false);
+    }
+
+    public async Task<bool> ExistsWithIdAsync(string id, CancellationToken ct = default)
     {
       try
       {
-        return await DockerClient.Networks.InspectNetworkAsync(id, ct)
+        _ = await ByIdAsync(id, ct)
           .ConfigureAwait(false);
+
+        return true;
       }
-      catch (DockerApiException)
+      catch (DockerNetworkNotFoundException)
       {
-        return null;
+        return false;
       }
     }
 
-    public async Task<bool> ExistsWithIdAsync(string id, CancellationToken ct = default)
-    {
-      var response = await ByIdAsync(id, ct)
-        .ConfigureAwait(false);
-
-      return response != null;
-    }
-
     public async Task<string> CreateAsync(INetworkConfiguration configuration, CancellationToken ct = default)
     {
       var createParameters = new NetworksCreateParameters

src/Testcontainers/Clients/DockerVolumeOperations.cs

@@ -34,26 +34,26 @@ public async Task<IEnumerable<VolumeResponse>> GetAllAsync(FilterByProperty filt
     }
 
     public async Task<VolumeResponse> ByIdAsync(string id, CancellationToken ct = default)
+    {
+      return await DockerClient.Volumes.InspectAsync(id, ct)
+        .ConfigureAwait(false);
+    }
+
+    public async Task<bool> ExistsWithIdAsync(string id, CancellationToken ct = default)
     {
       try
       {
-        return await DockerClient.Volumes.InspectAsync(id, ct)
+        _ = await ByIdAsync(id, ct)
           .ConfigureAwait(false);
+
+        return true;
       }
       catch (DockerApiException)
       {
-        return null;
+        return false;
       }
     }
 
-    public async Task<bool> ExistsWithIdAsync(string id, CancellationToken ct = default)
-    {
-      var response = await ByIdAsync(id, ct)
-        .ConfigureAwait(false);
-
-      return response != null;
-    }
-
     public async Task<string> CreateAsync(IVolumeConfiguration configuration, CancellationToken ct = default)
     {
       var createParameters = new VolumesCreateParameters

src/Testcontainers/Clients/TestcontainersClient.cs

@@ -9,6 +9,7 @@ namespace DotNet.Testcontainers.Clients
   using System.Threading;
   using System.Threading.Tasks;
   using Docker.DotNet;
+  using Docker.DotNet.Models;
   using DotNet.Testcontainers.Builders;
   using DotNet.Testcontainers.Configurations;
   using DotNet.Testcontainers.Containers;
@@ -286,6 +287,8 @@ public async Task<byte[]> ReadFileAsync(string id, string filePath, Cancellation
     /// <inheritdoc />
     public async Task<string> RunAsync(IContainerConfiguration configuration, CancellationToken ct = default)
     {
+      ImageInspectResponse cachedImage;
+
       if (TestcontainersSettings.ResourceReaperEnabled && ResourceReaper.DefaultSessionId.Equals(configuration.SessionId))
       {
         var isWindowsEngineEnabled = await System.GetIsWindowsEngineEnabled(ct)
@@ -295,8 +298,15 @@ public async Task<string> RunAsync(IContainerConfiguration configuration, Cancel
           .ConfigureAwait(false);
       }
 
-      var cachedImage = await Image.ByIdAsync(configuration.Image.FullName, ct)
-        .ConfigureAwait(false);
+      try
+      {
+        cachedImage = await Image.ByIdAsync(configuration.Image.FullName, ct)
+          .ConfigureAwait(false);
+      }
+      catch (DockerImageNotFoundException)
+      {
+        cachedImage = null;
+      }
 
       if (configuration.ImagePullPolicy(cachedImage))
       {
@@ -325,8 +335,17 @@ await Task.WhenAll(configuration.ResourceMappings.Select(resourceMapping => Copy
     /// <inheritdoc />
     public async Task<string> BuildAsync(IImageFromDockerfileConfiguration configuration, CancellationToken ct = default)
     {
-      var cachedImage = await Image.ByIdAsync(configuration.Image.FullName, ct)
-        .ConfigureAwait(false);
+      ImageInspectResponse cachedImage;
+
+      try
+      {
+        cachedImage = await Image.ByIdAsync(configuration.Image.FullName, ct)
+          .ConfigureAwait(false);
+      }
+      catch (DockerImageNotFoundException)
+      {
+        cachedImage = null;
+      }
 
       if (configuration.ImageBuildPolicy(cachedImage))
       {

src/Testcontainers/Containers/DockerContainer.cs

@@ -7,6 +7,7 @@ namespace DotNet.Testcontainers.Containers
   using System.Linq;
   using System.Threading;
   using System.Threading.Tasks;
+  using Docker.DotNet;
   using Docker.DotNet.Models;
   using DotNet.Testcontainers.Clients;
   using DotNet.Testcontainers.Configurations;
@@ -507,8 +508,15 @@ protected virtual async Task UnsafeStopAsync(CancellationToken ct = default)
       await _client.StopAsync(_container.ID, ct)
         .ConfigureAwait(false);
 
-      _container = await _client.Container.ByIdAsync(_container.ID, ct)
-        .ConfigureAwait(false);
+      try
+      {
+        _container = await _client.Container.ByIdAsync(_container.ID, ct)
+          .ConfigureAwait(false);
+      }
+      catch (DockerContainerNotFoundException)
+      {
+        _container = new ContainerInspectResponse();
+      }
 
       StoppedTime = DateTime.UtcNow;
       Stopped?.Invoke(this, EventArgs.Empty);
@@ -517,7 +525,7 @@ await _client.StopAsync(_container.ID, ct)
     /// <inheritdoc />
     protected override bool Exists()
     {
-      return _container != null && ContainerHasBeenCreatedStates.HasFlag(State);
+      return ContainerHasBeenCreatedStates.HasFlag(State);
     }
 
     /// <summary>