Struct ReleaseCommandHandler 

pub struct ReleaseCommandHandler { /* private fields */ }

ReleaseCommandHandler orchestrates the software release workflow

The ReleaseCommandHandler orchestrates the software release workflow to deploy software to a configured environment.

This command handler handles all steps required to release software:

1. Load the environment from storage
2. Validate the environment is in the correct state
3. Render Docker Compose templates to the build directory
4. Deploy compose files to the remote host via Ansible
5. Transition environment to Released state

Architecture

Follows the three-level architecture:

• Command (Level 1): This handler orchestrates the release workflow
• Step (Level 2): RenderDockerComposeTemplatesStep, DeployComposeFilesStep
• 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 Configured state
• Transitions to Environment<Releasing> at start
• Returns Environment<Released> on success
• Transitions to Environment<ReleaseFailed> on error

State is persisted after each transition using the injected repository.

Implementations

impl ReleaseCommandHandler

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

Create a new ReleaseCommandHandler

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

Execute the release workflow

Arguments

• env_name - The name of the environment to release to
• listener - Optional progress listener for step-level reporting

Returns

Returns Ok(Environment<Released>) on success

Errors

Returns an error if:

• Environment not found
• Environment is not in Configured state
• Docker Compose template rendering fails
• File deployment to VM fails
• State persistence fails