Struct ImageBuilder 

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

Builder for building Docker images with a fluent API.

Implementations

impl<'a> ImageBuilder<'a>

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

Set the path to the Dockerfile (relative to context).

Example

client.images()
    .build("my-app:latest")
    .dockerfile("docker/app.Dockerfile")
    .context(std::path::Path::new("."))
    .execute()
    .await?;

pub fn context(self, path: impl AsRef<Path>) -> Self

Set the build context directory.

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

Add a build argument.

Example

client.images()
    .build("my-app:latest")
    .build_arg("RUNTIME_IMAGE", "alpine:latest")
    .build_arg("VERSION", "1.0.0")
    .execute()
    .await?;

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

Add a label to the image.

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

Set the target build stage (for multi-stage builds).

Example

client.images()
    .build("my-app:latest")
    .target("production")
    .execute()
    .await?;

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

Add an image to use for build cache.

pub fn remove_intermediate(self, rm: bool) -> Self

Remove intermediate containers after build (default: true).

pub fn pull(self, pull: bool) -> Self

Always pull the latest base image (default: false).

pub async fn execute(self) -> Result<String>

Execute the build and return the image tag.

This will stream the build output via tracing.