Struct RunCommandHandler 

pub struct RunCommandHandler { /* private fields */ }

RunCommandHandler orchestrates the stack execution workflow

The RunCommandHandler orchestrates the execution of the deployed software stack on the target environment.

This command handler handles all steps required to run the stack:

1. Load the environment from storage
2. Validate the environment is in the correct state
3. Start services via Ansible playbook
4. Transition environment to Running state

Architecture

Follows the three-level architecture:

• Command (Level 1): This handler orchestrates the run workflow
• Step (Level 2): StartServicesStep
• Remote Action (Level 3): Ansible playbook executes on remote host

State Management

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

• Accepts environment in Released state
• Transitions to Environment<Running> on success
• Transitions to Environment<RunFailed> on error

State is persisted after each transition using the injected repository.

Implementations

impl RunCommandHandler

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

Create a new RunCommandHandler

pub fn execute( &self, env_name: &EnvironmentName, ) -> Result<Environment<Running>, RunCommandHandlerError>

Execute the run workflow

Arguments

• env_name - The name of the environment to run

Returns

Returns Ok(Environment<Running>) on success

Errors

Returns an error if:

• Environment not found
• Environment is not in Released state
• Instance IP is not available
• Starting services fails
• State persistence fails