Struct ConfigureCommandHandler 

pub struct ConfigureCommandHandler { /* private fields */ }

ConfigureCommandHandler orchestrates the complete infrastructure configuration workflow

The ConfigureCommandHandler orchestrates the complete infrastructure configuration workflow.

This command handles all steps required to configure infrastructure:

1. Install Docker
2. Install Docker Compose
3. Configure automatic security updates
4. Configure UFW firewall

State Management

The command integrates with the type-state pattern for environment lifecycle:

• Accepts Environment<Provisioned> as input
• Transitions to Environment<Configuring> at start
• Returns Environment<Configured> on success
• Transitions to Environment<ConfigureFailed> on error

State is persisted after each transition using the injected repository. Persistence failures are logged but don’t fail the command (state remains valid in memory).

Implementations

impl ConfigureCommandHandler

pub fn new( clock: Arc<dyn Clock>, repository: Arc<dyn EnvironmentRepository>, ) -> Self

Create a new ConfigureCommandHandler

pub fn execute( &self, env_name: &EnvironmentName, listener: Option<&dyn CommandProgressListener>, ) -> Result<Environment<Configured>, ConfigureCommandHandlerError>

Execute the complete configuration workflow

Arguments

• env_name - The name of the environment to configure
• listener - Optional progress listener for reporting step-level progress. When provided, the handler reports progress at each of the 4 configuration steps. When None, the handler executes silently (backward compatible).

Returns

Returns the configured environment

Errors

Returns an error if any step in the configuration workflow fails:

• Environment not found or not in Provisioned state
• Docker installation fails
• Docker Compose installation fails
• Security updates configuration fails
• Firewall configuration fails

On error, the environment transitions to ConfigureFailed state and is persisted.