在Bitbucket流水线容器中运行Testcontainers集成测试遇错求助

1. 修正Bitbucket流水线配置（bitbucket-pipelines.yml） #

Bitbucket的docker-in-docker服务需要明确的环境变量配置，才能让Testcontainers正确识别Docker环境。以下是经过验证的配置示例：

image: mcr.microsoft.com/dotnet/sdk:7.0
pipelines:
  default:
    - step:
        name: 运行集成测试
        services:
          - docker
        size: 2x  # MSSQL容器对内存/CPU要求较高，放大资源避免启动超时
        caches:
          - dotnetcore
        script:
          # 配置Docker连接参数，指向dind服务
          - export DOCKER_HOST=tcp://docker:2376
          - export DOCKER_TLS_CERTDIR=/certs
          # 告诉Testcontainers使用dind的Docker实例，而非当前容器的localhost
          - export TESTCONTAINERS_DOCKER_SOCKET_OVERRIDE=/var/run/docker.sock
          - export TESTCONTAINERS_HOST_OVERRIDE=docker
          # 执行测试
          - dotnet restore
          - dotnet test YourIntegrationTestProject.csproj --configuration Release --no-restore
        environment:
          TESTCONTAINERS_RYUK_DISABLED: "true"  # 禁用Ryuk，避免权限/资源问题

关键变量说明：

• DOCKER_HOST：指定连接到流水线中docker服务的地址，而非当前容器内的Docker。
• TESTCONTAINERS_HOST_OVERRIDE：让Testcontainers将docker服务作为主机，替代默认的localhost。
• size:2x：默认流水线资源可能不足以启动MSSQL容器，放大资源避免启动超时。

2. 调整Testcontainers代码配置 #

确保测试代码中正确配置MSSQL容器，避免硬编码或依赖默认值导致的连接问题：

using Testcontainers.MsSql;

public class YourIntegrationTests
{
    private readonly MsSqlContainer _mssqlContainer;

    public YourIntegrationTests()
    {
        _mssqlContainer = new MsSqlBuilder()
            // 指定具体的MSSQL镜像版本，避免拉取不稳定的latest镜像
            .WithImage("mcr.microsoft.com/mssql/server:2022-latest")
            .WithPassword("YourStrong!Passw0rd123")
            // 添加等待策略，确保容器完全启动再尝试连接
            .WithWaitStrategy(Wait.ForUnixContainer()
                .UntilPortIsAvailable(1433)
                .UntilMessageIsLogged("SQL Server is now ready for client connections"))
            .Build();
    }

    [Fact]
    public async Task TestDatabaseConnection()
    {
        await _mssqlContainer.StartAsync();
        // 使用容器提供的连接字符串，而非硬编码
        var connectionString = _mssqlContainer.GetConnectionString();
        
        // 后续测试逻辑...
    }
}

3. 移除冗余的docker-compose配置（可选） #

如果你的测试已经通过Testcontainers直接管理MSSQL容器，建议去掉docker-compose-api-tests.yaml的依赖——Testcontainers会自动处理容器生命周期，额外的docker-compose配置可能导致环境冲突。

4. 排查Docker服务状态 #

可以在流水线脚本中添加Docker状态检查命令，确认服务是否正常运行：

# 在dotnet restore之前添加
- docker info
- docker ps

如果输出显示Docker服务未连接，说明流水线的docker服务配置有误，需要检查Bitbucket项目的流水线权限是否开启了Docker服务支持。

内容的提问来源于stack exchange，提问作者Nikolay