如何在Testcontainers中配置私有镜像仓库凭证测试Spring微服务

针对你的场景，这里有几种实用的配置方法，帮你在微服务A的Testcontainers测试中拉取私有仓库的微服务B镜像：

方法一：Spring Boot配置文件直接配置（最省心） #

Testcontainers和Spring Boot集成后，可以直接在测试环境的配置文件里写认证信息，不用改代码。

如果用application-test.properties：

# 对应你的AWS私有仓库地址
testcontainers.docker.client.auth.configs.something.amazonaws.com.username=你的用户名
testcontainers.docker.client.auth.configs.something.amazonaws.com.password=你的密码

如果用application-test.yml：

testcontainers:
  docker:
    client:
      auth:
        configs:
          something.amazonaws.com:
            username: 你的用户名
            password: 你的密码

启动测试时，Testcontainers会自动读取这些配置，提前完成仓库登录，直接拉取镜像。

方法二：代码里手动配置（灵活可控） #

如果需要从环境变量或者其他地方动态获取凭证，可以在测试类里手动设置Docker认证：

import org.testcontainers.DockerClientFactory;
import com.github.dockerjava.api.model.AuthConfig;
import org.junit.jupiter.api.BeforeAll;

public class ServiceATest {

    @BeforeAll
    static void setupDockerAuth() {
        // 可以换成从环境变量取：System.getenv("ECR_USERNAME")
        AuthConfig authConfig = new AuthConfig()
                .withUsername("你的用户名")
                .withPassword("你的密码")
                .withRegistryAddress("something.amazonaws.com");
        
        DockerClientFactory.instance().client().authConfig(authConfig);
    }

    // 你的测试用例示例
    // @Test
    // void testServiceInteraction() {
    //     GenericContainer<?> serviceB = new GenericContainer<>("something.amazonaws.com/service-b:latest");
    //     serviceB.start();
    //     // 编写微服务A和B的交互测试逻辑
    // }
}

方法三：用环境变量配置（适合CI/CD场景） #

在CI环境或者本地终端里，直接设置环境变量，Testcontainers会自动识别：

# Linux/macOS终端示例
export TESTCONTAINERS_DOCKER_CLIENT_AUTH_CONFIGS_SOMETHING_AWSAMAZON_COM_USERNAME=你的用户名
export TESTCONTAINERS_DOCKER_CLIENT_AUTH_CONFIGS_SOMETHING_AWSAMAZON_COM_PASSWORD=你的密码

或者如果你已经通过docker login完成过登录，也可以直接指定Docker配置文件的路径：

export DOCKER_CONFIG=~/.docker/config.json

额外提示 #

• 绝对不要把硬编码的用户名密码提交到代码仓库！ 建议用环境变量、Spring Cloud Config或者AWS Secrets Manager这类工具来管理凭证。
• 如果是AWS ECR仓库，还可以用AWS SDK自动获取临时令牌，用户名固定为AWS，密码调用ECR的getAuthorizationToken接口获取，这样更安全，不用存储长期密码。

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