Struct TestCommandHandler 

pub struct TestCommandHandler { /* private fields */ }

TestCommandHandler orchestrates smoke testing for running Torrust Tracker services

Purpose: Post-deployment smoke test to verify the application is running and accessible

This handler validates that deployed services are operational and accessible from external clients by performing comprehensive health checks on the Tracker API and HTTP Tracker endpoints.

Validation Steps

1. Service Status - Verifies Docker Compose services are running via SSH
2. Tracker API Health (required) - Tests external accessibility of HTTP API
3. HTTP Tracker Health (optional) - Tests external accessibility of HTTP tracker

Port Discovery

The handler extracts tracker ports from the environment’s tracker configuration:

• HTTP API port from tracker.http_api.bind_address
• HTTP Tracker port from tracker.http_trackers[0].bind_address

Design Rationale

This command accepts an EnvironmentName in its execute method to align with other command handlers (ProvisionCommandHandler, ConfigureCommandHandler). This design:

• Loads environment from repository (consistent pattern across all handlers)
• Allows testing environments regardless of compile-time state (runtime validation)
• Requires the environment to have an instance IP set (checked at runtime)
• Enables repository integration for future enhancements (e.g., tracking test history)

Implementations

impl TestCommandHandler

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

Create a new TestCommandHandler

pub async fn execute( &self, env_name: &EnvironmentName, ) -> Result<TestResult, TestCommandHandlerError>

Execute the complete testing and validation workflow

Validates that the Torrust Tracker services are running and accessible by performing external health checks on the deployed services. Also performs advisory DNS resolution checks for configured domains.

Returns a structured TestResult containing any DNS warnings found. The presentation layer is responsible for rendering these warnings.

Arguments

• env_name - The name of the environment to test

Returns

• Ok(TestResult) - Test passed, may contain advisory DNS warnings

Errors

Returns an error if:

• Environment not found
• Environment does not have an instance IP set
• Tracker configuration is invalid or missing required ports
• Running services validation fails:
  • Services are not running
  • Health check endpoints are not accessible
  • Firewall rules block external access