Struct RegisterCommandHandler 

pub struct RegisterCommandHandler { /* private fields */ }

RegisterCommandHandler registers existing instances with environments

This command handler provides an alternative path to ProvisionCommandHandler. Instead of provisioning new infrastructure, it registers an existing instance (VM, physical server, or container) with an environment.

State Management

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

• Accepts Environment<Created> as input
• Returns Environment<Provisioned> on success

This allows the environment to continue with configure, release, and run commands just like a normally provisioned environment.

Workflow

1. Load environment from repository (must be in Created state)
2. Validate SSH connectivity to the provided IP address
3. Render Ansible templates with the instance IP
4. Update runtime outputs with the instance IP and provision method
5. Transition to Provisioned state
6. Persist the updated environment

Implementations

impl RegisterCommandHandler

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

Create a new RegisterCommandHandler

pub async fn execute( &self, env_name: &EnvironmentName, instance_ip: IpAddr, ssh_port: Option<u16>, ) -> Result<Environment<Provisioned>, RegisterCommandHandlerError>

Execute the register workflow

Arguments

• env_name - The name of the environment to register the instance with
• instance_ip - The IP address of the existing instance
• ssh_port - Optional SSH port (overrides environment config if provided)

Returns

Returns the environment in Provisioned state

Errors

Returns an error if:

• Environment not found or not in Created state
• SSH connectivity validation fails
• Ansible template rendering fails
• Unable to persist the environment state