feat: add CodeBuild support (#47)

Author: hughesjs

src/Testcontainers.Floci/CodeBuildConfig.cs

@@ -0,0 +1,41 @@
+using System.Collections.Generic;
+using JetBrains.Annotations;
+
+namespace Testcontainers.Floci;
+
+/// <summary>
+/// Configuration for Floci's CodeBuild emulation.
+/// </summary>
+/// <remarks>
+/// CodeBuild is a container-based service: Floci runs each build inside a Docker container spawned
+/// via the Docker socket (mounted automatically).
+/// <code>
+/// await using var floci = new FlociBuilder()
+///     .WithCodeBuild(new CodeBuildConfig())
+///     .Build();
+/// </code>
+/// </remarks>
+[PublicAPI]
+public sealed record CodeBuildConfig : FlociServiceConfig
+{
+    /// <summary>
+    /// Gets the Docker network that spawned build containers join, or <see langword="null" /> to
+    /// use the default bridge network.
+    /// </summary>
+    public string? DockerNetwork { get; init; }
+
+    /// <inheritdoc />
+    protected override string ServiceKey => "CODEBUILD";
+
+    /// <inheritdoc />
+    internal override bool RequiresDockerAccess => true;
+
+    /// <inheritdoc />
+    protected override void AddSettings(IDictionary<string, string> env, string prefix)
+    {
+        if (!string.IsNullOrEmpty(DockerNetwork))
+        {
+            env[prefix + "DOCKER_NETWORK"] = DockerNetwork!;
+        }
+    }
+}

src/Testcontainers.Floci/FlociBuilder.cs

@@ -221,6 +221,14 @@ public FlociBuilder WithAvailabilityZone(string availabilityZone)
     /// <returns>A configured instance of <see cref="FlociBuilder" />.</returns>
     public FlociBuilder WithEc2(Ec2Config config) => WithServiceConfig(config);
 
+    /// <summary>
+    /// Configures Floci's CodeBuild emulation. Container-based: mounts the Docker socket so Floci
+    /// can run each build inside a spawned container.
+    /// </summary>
+    /// <param name="config">The CodeBuild configuration.</param>
+    /// <returns>A configured instance of <see cref="FlociBuilder" />.</returns>
+    public FlociBuilder WithCodeBuild(CodeBuildConfig config) => WithServiceConfig(config);
+
     /// <summary>
     /// Configures Floci's CodeDeploy emulation.
     /// </summary>

tests/Testcontainers.Floci.IntegrationTests/CodeBuildServiceTest.cs

@@ -0,0 +1,102 @@
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using Amazon.CodeBuild;
+using Amazon.CodeBuild.Model;
+using Testcontainers.Floci;
+using Xunit;
+
+namespace Testcontainers.Floci.Tests;
+
+public sealed class CodeBuildServiceTest : IAsyncLifetime
+{
+    private const string ProjectName = "floci-test";
+
+    private readonly FlociContainer _floci = new FlociBuilder(TestImages.Floci)
+        .WithCodeBuild(new CodeBuildConfig())
+        .Build();
+
+    public Task InitializeAsync() => _floci.StartAsync();
+
+    public async Task DisposeAsync()
+    {
+        try
+        {
+            using var cb = CreateClient();
+            await cb.DeleteProjectAsync(new DeleteProjectRequest { Name = ProjectName });
+        }
+        catch (AmazonCodeBuildException)
+        {
+            // The container is being disposed anyway; nothing actionable here.
+        }
+
+        await _floci.DisposeAsync();
+    }
+
+    private AmazonCodeBuildClient CreateClient()
+    {
+        return new AmazonCodeBuildClient(
+            _floci.AccessKey,
+            _floci.SecretKey,
+            new AmazonCodeBuildConfig
+            {
+                ServiceURL = _floci.GetEndpoint(),
+                AuthenticationRegion = _floci.Region,
+            });
+    }
+
+    [Fact]
+    public async Task RunsABuildToCompletion()
+    {
+        using var cb = CreateClient();
+
+        // Unlike the upstream Java test (which only lists projects), we run a real build: Floci
+        // spawns a build container, executes the buildspec, and reports the terminal status. A
+        // tiny alpine image keeps the build container pull cheap. (Verified separately that a
+        // failing buildspec yields FAILED, so SUCCEEDED genuinely reflects buildspec execution.)
+        await cb.CreateProjectAsync(new CreateProjectRequest
+        {
+            Name = ProjectName,
+            Source = new ProjectSource
+            {
+                Type = SourceType.NO_SOURCE,
+                Buildspec = "version: 0.2\nphases:\n  build:\n    commands:\n      - echo hello-from-floci",
+            },
+            Artifacts = new ProjectArtifacts { Type = ArtifactsType.NO_ARTIFACTS },
+            Environment = new ProjectEnvironment
+            {
+                Type = EnvironmentType.LINUX_CONTAINER,
+                Image = "public.ecr.aws/docker/library/alpine:3.20",
+                ComputeType = ComputeType.BUILD_GENERAL1_SMALL,
+            },
+            ServiceRole = "arn:aws:iam::000000000000:role/codebuild-role",
+        });
+
+        var started = await cb.StartBuildAsync(new StartBuildRequest { ProjectName = ProjectName });
+        var buildId = started.Build.Id;
+
+        var status = await WaitForTerminalStatusAsync(cb, buildId);
+
+        Assert.Equal(StatusType.SUCCEEDED, status);
+    }
+
+    private static async Task<StatusType> WaitForTerminalStatusAsync(AmazonCodeBuildClient cb, string buildId)
+    {
+        for (var attempt = 0; attempt < 60; attempt++)
+        {
+            var builds = await cb.BatchGetBuildsAsync(new BatchGetBuildsRequest
+            {
+                Ids = new List<string> { buildId },
+            });
+
+            var status = builds.Builds[0].BuildStatus;
+            if (status != StatusType.IN_PROGRESS)
+            {
+                return status;
+            }
+
+            await Task.Delay(2000);
+        }
+
+        throw new Xunit.Sdk.XunitException("CodeBuild build did not reach a terminal status within the timeout.");
+    }
+}

tests/Testcontainers.Floci.IntegrationTests/Testcontainers.Floci.IntegrationTests.csproj

@@ -22,6 +22,7 @@
     <PackageReference Include="AWSSDK.CloudWatch" Version="4.0.3" />
     <PackageReference Include="AWSSDK.CloudFront" Version="4.0.3" />
     <PackageReference Include="AWSSDK.CloudWatchLogs" Version="4.0.3" />
+    <PackageReference Include="AWSSDK.CodeBuild" Version="4.0.6.4" />
     <PackageReference Include="AWSSDK.CodeDeploy" Version="4.0.3" />
     <PackageReference Include="AWSSDK.ConfigService" Version="4.0.3" />
     <PackageReference Include="AWSSDK.CostExplorer" Version="4.0.3" />

tests/Testcontainers.Floci.Tests/CodeBuildConfigTest.cs

@@ -0,0 +1,50 @@
+using Testcontainers.Floci;
+using Xunit;
+
+namespace Testcontainers.Floci.Tests;
+
+public sealed class CodeBuildConfigTest
+{
+    [Fact]
+    public void DefaultsMatchUpstream()
+    {
+        var config = new CodeBuildConfig();
+
+        Assert.True(config.Enabled);
+        Assert.Null(config.DockerNetwork);
+    }
+
+    [Fact]
+    public void RequiresDockerAccess()
+    {
+        Assert.True(new CodeBuildConfig().RequiresDockerAccess);
+    }
+
+    [Fact]
+    public void DefaultConfigEmitsUpstreamDefaultEnvVars()
+    {
+        var env = new CodeBuildConfig().BuildEnvironment();
+
+        Assert.Equal("true", env["FLOCI_SERVICES_CODEBUILD_ENABLED"]);
+        // DockerNetwork is only emitted when set.
+        Assert.DoesNotContain("FLOCI_SERVICES_CODEBUILD_DOCKER_NETWORK", env.Keys);
+    }
+
+    [Fact]
+    public void CustomConfigEmitsCustomEnvVars()
+    {
+        var env = new CodeBuildConfig { DockerNetwork = "floci-net" }.BuildEnvironment();
+
+        Assert.Equal("true", env["FLOCI_SERVICES_CODEBUILD_ENABLED"]);
+        Assert.Equal("floci-net", env["FLOCI_SERVICES_CODEBUILD_DOCKER_NETWORK"]);
+    }
+
+    [Fact]
+    public void DisabledConfigEmitsOnlyTheEnabledFlag()
+    {
+        var env = new CodeBuildConfig { Enabled = false }.BuildEnvironment();
+
+        Assert.Equal("false", env["FLOCI_SERVICES_CODEBUILD_ENABLED"]);
+        Assert.DoesNotContain("FLOCI_SERVICES_CODEBUILD_DOCKER_NETWORK", env.Keys);
+    }
+}