Struct DockerService 

pub struct DockerService { /* private fields */ }

Docker service for managing containers and Docker Compose

Examples

use mecha10_cli::services::DockerService;

let service = DockerService::new();

// Check if Docker is available
service.check_installation()?;

// Start services with Docker Compose
service.compose_up(true).await?;

// Check container status
let running = service.is_container_running("mecha10-redis").await?;

Implementations

impl DockerService

pub fn new() -> Self

Create a new Docker service

pub fn with_compose_file(compose_file: impl Into<String>) -> Self

Create a Docker service with a custom compose file path

Arguments

• compose_file - Path to docker-compose.yml

pub fn check_installation(&self) -> Result<DockerInfo>

Check if Docker is installed and accessible

Errors

Returns an error if Docker is not found or not executable.

pub fn check_daemon(&self) -> Result<()>

Check if Docker daemon is running

Errors

Returns an error if the daemon is not running or unreachable.

pub fn compose_build(&self, service: Option<&str>) -> Result<()>

Build Docker images using Docker Compose

Arguments

• service - Optional service name to build (builds all if None)

pub async fn compose_up(&self, detach: bool) -> Result<()>

Start services using Docker Compose

Arguments

• detach - Run in detached mode

pub async fn compose_up_service( &self, service: &str, detach: bool, ) -> Result<()>

Start a specific service using Docker Compose

Arguments

• service - Service name to start
• detach - Run in detached mode

pub async fn compose_run_service( &self, service: &str, detach: bool, service_ports: bool, command_args: &[String], ) -> Result<()>

Run a one-off command in a service container

Uses docker compose run to start a service with custom command arguments.

Arguments

• service - Service name to run
• detach - Run in detached mode
• service_ports - Publish service ports (useful for detached mode)
• command_args - Additional arguments to pass to the container’s entrypoint

pub async fn compose_stop(&self, service: Option<&str>) -> Result<()>

Stop services using Docker Compose

Arguments

• service - Optional service name to stop (stops all if None)

pub async fn compose_down(&self) -> Result<()>

Stop and remove services using Docker Compose

pub async fn compose_restart(&self, service: Option<&str>) -> Result<()>

Restart services using Docker Compose

Arguments

• service - Optional service name to restart (restarts all if None)

pub fn compose_logs( &self, service: Option<&str>, follow: bool, tail: Option<usize>, ) -> Result<()>

Get logs from Docker Compose services

Arguments

• service - Optional service name (all services if None)
• follow - Follow log output
• tail - Number of lines to show from the end

pub async fn is_container_running(&self, container_name: &str) -> Result<bool>

Check if a container is running

Arguments

• container_name - Name or ID of the container

pub async fn list_containers(&self) -> Result<Vec<ContainerInfo>>

List running containers

pub fn compose_file_exists(&self, path: Option<&Path>) -> bool

Check if docker-compose.yml exists

Arguments

• path - Path to check (defaults to current directory)

pub async fn wait_for_healthy( &self, container_name: &str, timeout: Duration, ) -> Result<()>

Wait for a service to be healthy

Arguments

• container_name - Name of the container
• timeout - Maximum time to wait

pub async fn start_project_services( &self, services: &[String], project_name: &str, ) -> Result<bool>

Start project services for development mode

This is a convenience method that:

1. Checks if services are already running
2. Starts only the services that aren’t running
3. Waits for them to be healthy

Arguments

• services - List of service names to start
• project_name - Project name for container naming

Returns

Returns Ok(true) if services were started, Ok(false) if already running

Trait Implementations

impl Default for DockerService

fn default() -> Self

Returns the “default value” for a type.