能否在测试中通过ContainerBuilder创建容器并手动启动？

完全理解你觉得@DockerContainer声明式方式不够灵活的痛点——这种静态注解的方式确实在需要动态调整容器配置、根据测试场景按需创建容器时会受限。手动使用ContainerBuilder是完全可行的，而且能给你带来极高的灵活性。

下面是具体的实现步骤和代码示例：

核心实现思路 #

你需要通过Arquillian的上下文获取Cube的配置，然后用ContainerBuilder构建自定义容器配置，最后手动管理容器的启动、运行和销毁生命周期。

1. 基础准备 #

确保你的测试类已经配置了Arquillian的运行环境：

• 测试类上标注@RunWith(Arquillian.class)
• 引入arquillian-cube-docker相关依赖（版本和你的Arquillian版本匹配即可）

2. 手动创建并启动容器的代码示例 #

import org.arquillian.cube.docker.impl.client.CubeDockerConfiguration;
import org.arquillian.cube.docker.impl.client.containerbuilder.ContainerBuilder;
import org.arquillian.cube.spi.CubeContainer;
import org.jboss.arquillian.junit.Arquillian;
import org.junit.After;
import org.junit.Before;
import org.junit.Test;
import org.junit.runner.RunWith;

import static org.jboss.arquillian.core.api.InstanceProvider.Arquillian;

@RunWith(Arquillian.class)
public class ManualCubeContainerTest {

    private CubeContainer manualContainer;

    @Before
    public void setupContainer() {
        // 获取Cube的Docker配置上下文
        CubeDockerConfiguration cubeConfig = Arquillian.getConfiguration(CubeDockerConfiguration.class);

        // 使用ContainerBuilder构建自定义容器
        ContainerBuilder containerBuilder = ContainerBuilder.builder()
            .id("my-custom-nginx") // 容器唯一标识
            .image("nginx:alpine") // 指定镜像
            .portBinding("8081->80/tcp") // 端口映射
            .env("NGINX_HOST=localhost") // 设置环境变量
            .command("nginx -g 'daemon off;'") // 自定义启动命令
            .build();

        // 创建并启动容器
        manualContainer = containerBuilder.create(cubeConfig);
        manualContainer.start();
    }

    @Test
    public void testManualContainer() {
        // 这里编写你的测试逻辑，比如访问容器提供的服务
        // 例如：发送HTTP请求到http://localhost:8081验证服务可用性
    }

    @After
    public void teardownContainer() {
        // 测试结束后停止并销毁容器
        if (manualContainer != null) {
            manualContainer.stop();
            manualContainer.destroy();
        }
    }
}

关键注意事项 #

• 生命周期管理：手动创建的容器需要你自己负责启动、停止和销毁，避免测试后残留容器资源。可以用@Before/@After或者@BeforeClass/@AfterClass来管理全局容器的生命周期。
• 配置复用：如果多个测试用例需要相同的容器配置，可以把容器构建逻辑抽成工具方法，减少重复代码。
• 动态调整：你可以在测试过程中根据条件修改容器配置，比如不同测试用例使用不同的镜像版本、端口映射或者环境变量，这是声明式方式做不到的。
• 上下文初始化：确保在获取CubeDockerConfiguration时，Arquillian的上下文已经完成初始化——标注@RunWith(Arquillian.class)会帮你处理这一点。

这种手动方式特别适合需要动态控制容器的场景，比如集成测试中根据测试步骤启动不同服务，或者在测试过程中重启容器验证容错性。

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