Struct ProvisionCommandHandler 

pub struct ProvisionCommandHandler { /* private fields */ }

ProvisionCommandHandler orchestrates the complete infrastructure provisioning workflow

The ProvisionCommandHandler orchestrates the complete infrastructure provisioning workflow.

This command handler handles all steps required to provision infrastructure:

1. Render OpenTofu templates
2. Initialize OpenTofu
3. Validate configuration syntax and consistency
4. Plan infrastructure
5. Apply infrastructure
6. Get instance information
7. Render Ansible templates (with runtime IP address)
8. Wait for SSH connectivity
9. Wait for cloud-init completion

State Management

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

• Accepts Environment<Created> as input
• Transitions to Environment<Provisioning> at start
• Returns Environment<Provisioned> on success
• Transitions to Environment<ProvisionFailed> on error

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

Implementations

impl ProvisionCommandHandler

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

Create a new ProvisionCommandHandler

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

Execute the complete provisioning workflow

Arguments

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

Returns

Returns the provisioned environment

Errors

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

• Environment not found or not in Created state
• Template rendering fails
• OpenTofu initialization, planning, or apply fails
• Unable to retrieve instance information
• SSH connectivity cannot be established
• Cloud-init does not complete successfully

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