Struct ContainerConfigBuilder 

pub struct ContainerConfigBuilder { /* private fields */ }

Flexible container configuration builder

This struct provides a builder pattern for configuring Docker containers with explicit configuration options instead of hardcoded values.

Currently supports the minimal set of features needed by the provisioned container:

• Image name and tag validation
• Container name customization
• Exposed ports (with validation)
• Wait conditions (with reasonable limits)

Implementations

impl ContainerConfigBuilder

pub fn new(image: impl Into<String>) -> Self

Create a new container configuration builder with the specified image

Arguments

• image - Docker image name with optional tag (e.g., “redis:7”, “app:latest”)

Example

use torrust_tracker_deployer_lib::testing::e2e::containers::config_builder::ContainerConfigBuilder;

let builder = ContainerConfigBuilder::new("torrust-provisioned-instance:latest");

pub fn with_exposed_port(self, port: u16) -> Self

Add an exposed port to the container configuration

Arguments

• port - Port number to expose (as u16)

Example

use torrust_tracker_deployer_lib::testing::e2e::containers::config_builder::ContainerConfigBuilder;

let builder = ContainerConfigBuilder::new("torrust-provisioned-instance:latest")
    .with_exposed_port(22)
    .with_exposed_port(80);

pub fn with_container_name(self, name: impl Into<String>) -> Self

Set a custom container name for the running container

Arguments

• name - Container name to use when starting the container

Example

use torrust_tracker_deployer_lib::testing::e2e::containers::config_builder::ContainerConfigBuilder;

let builder = ContainerConfigBuilder::new("torrust-provisioned-instance:latest")
    .with_container_name("my-custom-container-name");

pub fn with_wait_condition(self, condition: WaitFor) -> Self

Add a wait condition to determine when the container is ready

Arguments

• condition - Wait condition (e.g., message on stdout, HTTP endpoint, etc.)

Example

use torrust_tracker_deployer_lib::testing::e2e::containers::config_builder::ContainerConfigBuilder;
use testcontainers::core::WaitFor;

let builder = ContainerConfigBuilder::new("torrust-provisioned-instance:latest")
    .with_wait_condition(WaitFor::message_on_stdout("sshd entered RUNNING state"));

pub fn build(self) -> Result<GenericImage>

Build the final GenericImage with all configured options and validation

This method creates a GenericImage with all the configuration options that were specified using the builder methods. It also validates the configuration to catch common issues early.

Returns

A configured GenericImage ready to be used with testcontainers

Errors

Returns an error if:

• Image name is empty or invalid
• Any port number is invalid (e.g., 0)
• Too many wait conditions (performance concern)

Example

use torrust_tracker_deployer_lib::testing::e2e::containers::config_builder::ContainerConfigBuilder;
use testcontainers::core::WaitFor;

let image = ContainerConfigBuilder::new("torrust-provisioned-instance:latest")
    .with_exposed_port(22)
    .with_wait_condition(WaitFor::message_on_stdout("sshd entered RUNNING state"))
    .build()?;

pub fn image_name(&self) -> &str

Get the configured image name

Returns

The Docker image name that was configured for this builder

pub fn exposed_ports(&self) -> &[u16]

Get the configured exposed ports

Returns

A slice of port numbers that will be exposed

pub fn wait_conditions_count(&self) -> usize

Get the number of configured wait conditions

Returns

The number of wait conditions configured

Trait Implementations

impl Clone for ContainerConfigBuilder

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ContainerConfigBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.