refactor: rename deployment validation to configuration validation

- Rename run_deployment_validation module to run_configuration_validation
- Rename run_deployment_validation function to run_configuration_validation
- Extract validate_docker_installation and validate_docker_compose_installation functions
- Update all module references and imports throughout codebase
- Update documentation to reflect new naming conventions

The new naming better reflects that this validates the configuration
of installed software rather than the deployment process itself.

Author: josecelano

docs/refactors/e2e-config-tests-cleanup.md

@@ -120,7 +120,7 @@ This refactor plan outlines the improvements needed for `src/bin/e2e_config_test
 
 - **Task**: Replace nested match statements with `?` operator ✅
 - **Pattern**: Convert `match result { Ok(x) => ..., Err(e) => return Err(...) }` to direct `?` usage ✅
-- **Focus**: `run_ansible_configuration()` and `run_deployment_validation()` ✅
+- **Focus**: `run_ansible_configuration()` and `run_configuration_validation()` ✅
 
 **Status**: ✅ COMPLETE - Replaced nested match patterns with `?` operator in both functions, improved readability
 

src/bin/e2e_config_tests.rs

@@ -58,7 +58,7 @@ use torrust_tracker_deploy::e2e::tasks::{
         run_provision_simulation::run_provision_simulation,
     },
     preflight_cleanup,
-    run_deployment_validation::run_deployment_validation,
+    run_configuration_validation::run_configuration_validation,
 };
 use torrust_tracker_deploy::logging::{self, LogFormat};
 
@@ -167,9 +167,9 @@ async fn run_configuration_tests(test_env: &TestEnvironment) -> Result<()> {
     // Step 2: Run Ansible configuration
     run_configure_command(test_env)?;
 
-    // Step 3: Run deployment validation
+    // Step 3: Run configuration validation
     let socket_addr = running_container.ssh_socket_addr();
-    run_deployment_validation(socket_addr, &test_env.config.ssh_credentials).await?;
+    run_configuration_validation(socket_addr, &test_env.config.ssh_credentials).await?;
 
     // Step 4: Cleanup container
     cleanup_infrastructure(running_container);

src/e2e/tasks/mod.rs

@@ -10,7 +10,7 @@
 //!
 //! ### Infrastructure-agnostic tasks (can be used with both containers and VMs):
 //! - `run_configure_command` - Infrastructure configuration via Ansible and playbook execution
-//! - `run_deployment_validation` - Deployment validation and testing
+//! - `run_configuration_validation` - Configuration validation and testing
 //! - `run_test_command` - Deployment validation and testing
 //!
 //! ### Container-specific tasks (`container` submodule):
@@ -28,7 +28,7 @@
 
 pub mod container;
 pub mod preflight_cleanup;
+pub mod run_configuration_validation;
 pub mod run_configure_command;
-pub mod run_deployment_validation;
 pub mod run_test_command;
 pub mod virtual_machine;

…c/e2e/tasks/run_deployment_validation.rs …2e/tasks/run_configuration_validation.rssrc/e2e/tasks/run_deployment_validation.rs renamed to src/e2e/tasks/run_configuration_validation.rs src/e2e/tasks/run_deployment_validation.rs renamed to src/e2e/tasks/run_configuration_validation.rs

@@ -1,7 +1,7 @@
-//! Deployment validation task for E2E testing
+//! Configuration validation task for E2E testing
 //!
-//! This module provides the E2E testing task for validating that deployments
-//! are working correctly after configuration. It performs comprehensive checks
+//! This module provides the E2E testing task for validating that configurations
+//! are working correctly after deployment. It performs comprehensive checks
 //! to ensure all required services and components are properly installed and running.
 //!
 //! ## Key Operations
@@ -29,9 +29,84 @@ use crate::infrastructure::remote_actions::{
     DockerComposeValidator, DockerValidator, RemoteAction,
 };
 
-/// Run deployment validation tests on a configured instance
+/// Validate Docker installation on a configured instance
 ///
-/// This function performs comprehensive validation of a deployed instance,
+/// This function validates that Docker is properly installed and functioning
+/// on the target instance by connecting via SSH and running validation commands.
+///
+/// # Arguments
+///
+/// * `ip_addr` - IP address of the target instance
+/// * `ssh_credentials` - SSH credentials for connecting to the instance
+///
+/// # Returns
+///
+/// Returns `Ok(())` when Docker validation passes successfully.
+///
+/// # Errors
+///
+/// Returns an error if:
+/// - SSH connection cannot be established
+/// - Docker validation fails (not installed or not working)
+async fn validate_docker_installation(
+    ip_addr: std::net::IpAddr,
+    ssh_credentials: &SshCredentials,
+    port: u16,
+) -> Result<()> {
+    info!("Validating Docker installation");
+
+    let ssh_connection = ssh_credentials.clone().with_host_and_port(ip_addr, port);
+
+    let docker_validator = DockerValidator::new(ssh_connection);
+    docker_validator
+        .execute(&ip_addr)
+        .await
+        .context("Docker validation failed")?;
+
+    Ok(())
+}
+
+/// Validate Docker Compose installation on a configured instance
+///
+/// This function validates that Docker Compose is properly installed and functioning
+/// on the target instance by connecting via SSH and running validation commands.
+///
+/// # Arguments
+///
+/// * `ip_addr` - IP address of the target instance
+/// * `ssh_credentials` - SSH credentials for connecting to the instance
+/// * `port` - SSH port to connect to
+///
+/// # Returns
+///
+/// Returns `Ok(())` when Docker Compose validation passes successfully.
+///
+/// # Errors
+///
+/// Returns an error if:
+/// - SSH connection cannot be established
+/// - Docker Compose validation fails (not installed or not working)
+async fn validate_docker_compose_installation(
+    ip_addr: std::net::IpAddr,
+    ssh_credentials: &SshCredentials,
+    port: u16,
+) -> Result<()> {
+    info!("Validating Docker Compose installation");
+
+    let ssh_connection = ssh_credentials.clone().with_host_and_port(ip_addr, port);
+
+    let compose_validator = DockerComposeValidator::new(ssh_connection);
+    compose_validator
+        .execute(&ip_addr)
+        .await
+        .context("Docker Compose validation failed")?;
+
+    Ok(())
+}
+
+/// Run configuration validation tests on a configured instance
+///
+/// This function performs comprehensive validation of a configured instance,
 /// checking that all required services and components are properly installed
 /// and functioning. It uses SSH to connect to the target instance and run
 /// validation commands.
@@ -56,7 +131,7 @@ use crate::infrastructure::remote_actions::{
 /// # Example
 ///
 /// ```rust,no_run
-/// use torrust_tracker_deploy::e2e::tasks::run_deployment_validation::run_deployment_validation;
+/// use torrust_tracker_deploy::e2e::tasks::run_configuration_validation::run_configuration_validation;
 /// use torrust_tracker_deploy::config::SshCredentials;
 /// use std::net::{IpAddr, Ipv4Addr, SocketAddr};
 ///
@@ -69,48 +144,33 @@ use crate::infrastructure::remote_actions::{
 ///         "testuser".to_string()
 ///     );
 ///     
-///     run_deployment_validation(socket_addr, &ssh_credentials).await?;
-///     println!("All deployment validations passed");
+///     run_configuration_validation(socket_addr, &ssh_credentials).await?;
+///     println!("All configuration validations passed");
 ///     Ok(())
 /// }
 /// ```
-pub async fn run_deployment_validation(
+pub async fn run_configuration_validation(
     socket_addr: SocketAddr,
     ssh_credentials: &SshCredentials,
 ) -> Result<()> {
     info!(
         socket_addr = %socket_addr,
         ssh_user = %ssh_credentials.ssh_username,
-        "Running deployment validation tests"
+        "Running configuration validation tests"
     );
 
     let ip_addr = socket_addr.ip();
 
-    // Create SSH connection with the instance's address and port
-    let ssh_connection = ssh_credentials
-        .clone()
-        .with_host_and_port(ip_addr, socket_addr.port());
-
     // Validate Docker installation
-    info!("Validating Docker installation");
-    let docker_validator = DockerValidator::new(ssh_connection.clone());
-    docker_validator
-        .execute(&ip_addr)
-        .await
-        .context("Docker validation failed")?;
+    validate_docker_installation(ip_addr, ssh_credentials, socket_addr.port()).await?;
 
     // Validate Docker Compose installation
-    info!("Validating Docker Compose installation");
-    let compose_validator = DockerComposeValidator::new(ssh_connection);
-    compose_validator
-        .execute(&ip_addr)
-        .await
-        .context("Docker Compose validation failed")?;
+    validate_docker_compose_installation(ip_addr, ssh_credentials, socket_addr.port()).await?;
 
     info!(
         socket_addr = %socket_addr,
         status = "success",
-        "All deployment validation tests passed successfully"
+        "All configuration validation tests passed successfully"
     );
 
     Ok(())