Struct ContainerBuilder 

pub struct ContainerBuilder<'a> { /* private fields */ }

Builder for creating containers with a fluent API.

Implementations

impl<'a> ContainerBuilder<'a>

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

Set the container name.

pub fn env(self, key: impl Into<String>, value: impl Into<String>) -> Self

Add an environment variable.

Example

client.containers()
    .create("nginx:latest")
    .env("ENV", "production")
    .env("DEBUG", "false")
    .build()
    .await?;

pub fn port(self, host_port: u16, container_port: u16, protocol: &str) -> Self

Map a port from host to container.

Arguments

• host_port - Port on the host
• container_port - Port in the container
• protocol - Protocol (“tcp” or “udp”)

Example

client.containers()
    .create("nginx:latest")
    .port(8080, 80, "tcp")
    .port(8443, 443, "tcp")
    .build()
    .await?;

pub fn volume( self, host_path: impl Into<String>, container_path: impl Into<String>, ) -> Self

Mount a volume.

Arguments

• host_path - Path on the host
• container_path - Path in the container

Example

client.containers()
    .create("nginx:latest")
    .volume("/host/data", "/app/data")
    .build()
    .await?;

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

Connect to a network.

pub fn cmd(self, cmd: Vec<impl Into<String>>) -> Self

Set the command to run in the container.

Example

client.containers()
    .create("alpine:latest")
    .cmd(vec!["echo", "hello"])
    .build()
    .await?;

pub fn entrypoint(self, entrypoint: Vec<impl Into<String>>) -> Self

Set the entrypoint.

pub fn working_dir(self, dir: impl Into<String>) -> Self

Set the working directory.

pub fn restart_always(self) -> Self

Set the restart policy to “always”.

pub fn restart_unless_stopped(self) -> Self

Set the restart policy to “unless-stopped”.

pub fn restart_on_failure(self, max_retries: Option<i64>) -> Self

Set the restart policy to “on-failure” with optional retry count.

pub fn memory(self, bytes: i64) -> Self

Set memory limit in bytes.

pub fn cpu_shares(self, shares: i64) -> Self

Set CPU shares (relative weight).

pub fn label(self, key: impl Into<String>, value: impl Into<String>) -> Self

Add a label.

pub fn auto_remove(self, enable: bool) -> Self

Enable auto-remove (container is deleted when it stops).

pub fn privileged(self, enable: bool) -> Self

Enable privileged mode.

pub async fn build(self) -> Result<ContainerRef<'a>>

Build and create the container.

Returns a ContainerRef that can be used to interact with the container.