如何使用testcontainers-node将测试容器连接至现有Docker网络？

你可以通过以下两种方式实现需求，核心是在测试容器的配置中指定已创建的自定义网络：

方法一：直接指定网络名称（简单快捷） #

使用withNetworkMode()方法，传入你通过docker-compose创建的自定义网络名称即可：

const { GenericContainer } = require("testcontainers");

async function startTestContainer() {
  // 假设你的自定义网络名称是 "my-custom-bridge"
  const container = await new GenericContainer("redis:latest")
    .withNetworkMode("my-custom-bridge") // 指定已存在的自定义网络
    .withExposedPorts(6379)
    .start();

  console.log(`Redis容器已加入网络: my-custom-bridge`);
  return container;
}

startTestContainer();

方法二：先获取已存在的网络实例（更严谨） #

如果需要确保网络确实存在，可以先通过Networks.get()获取已有网络的实例，再关联到测试容器：

const { GenericContainer, Networks } = require("testcontainers");

async function startTestContainer() {
  // 获取已存在的自定义网络
  const existingNetwork = await Networks.get("my-custom-bridge");

  const container = await new GenericContainer("redis:latest")
    .withNetwork(existingNetwork) // 关联获取到的网络实例
    .withExposedPorts(6379)
    .start();

  console.log(`Redis容器已加入网络: ${existingNetwork.getName()}`);
  return container;
}

startTestContainer();

注意事项 #

• 确保你传入的网络名称和docker-compose创建的网络完全一致，可以通过docker network ls命令查看准确的网络名称
• 加入同一网络后，测试容器可以直接通过其他容器的名称（比如docker-compose中定义的服务名）进行通信，无需暴露端口到宿主机

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