Struct DockerDebugInfo 

pub struct DockerDebugInfo {
    pub all_containers: Result<String, String>,
    pub ssh_images: Result<String, String>,
    pub ssh_containers: Result<Vec<ContainerInfo>, String>,
    pub port_usage: Result<Vec<String>, String>,
    /* private fields */
}

Debug information collected about Docker containers

This struct holds structured information about Docker state for troubleshooting SSH server container issues. Each field contains either successfully collected data or an error message explaining what went wrong.

Fields

all_containers: Result<String, String>

Output from docker ps -a listing all containers

ssh_images: Result<String, String>

Docker images matching the SSH server image name

ssh_containers: Result<Vec<ContainerInfo>, String>

Information about containers using the SSH server image

port_usage: Result<Vec<String>, String>

Port usage information for the SSH port

Implementations

impl DockerDebugInfo

pub fn new( docker: Arc<DockerClient>, container_port: u16, image_name: &str, image_tag: &str, ) -> Self

Create a new DockerDebugInfo and collect all diagnostic information

This constructor runs various Docker commands to gather diagnostic information when SSH connectivity tests fail. It collects container status, logs, and port usage information.

Arguments

• docker - Docker client for executing commands
• container_port - The host port that the SSH container is mapped to
• image_name - Image name to filter by (e.g., “torrust-ssh-server”)
• image_tag - Image tag to filter by (e.g., “latest”)

Returns

A DockerDebugInfo struct containing all collected information. Each field is a Result that either contains the successfully collected data or an error message explaining what went wrong.

Example

use std::sync::Arc;
use torrust_tracker_deployer_lib::adapters::docker::DockerClient;
use torrust_tracker_deployer_lib::testing::integration::ssh_server::DockerDebugInfo;

let docker = Arc::new(DockerClient::new());
let debug_info = DockerDebugInfo::new(docker, 2222, "torrust-ssh-server", "latest");
debug_info.print();

pub fn docker(&self) -> &Arc<DockerClient>

Get a reference to the Docker client

This allows access to the underlying Docker client for additional operations if needed after debug info has been collected.

pub fn print(&self)

Print the debug information in a formatted way

Prints all collected debug information to stdout in a human-readable format.

Trait Implementations

impl Debug for DockerDebugInfo

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.