Enum ErrorKind 

pub enum ErrorKind {
    TemplateRendering,
    InfrastructureOperation,
    NetworkConnectivity,
    CommandExecution,
    Timeout,
    FileSystem,
    Configuration,
    StatePersistence,
}

Generic error categories for command failures

These categories provide high-level classification for debugging and potential recovery strategies. They are used in trace files and failure context but are not directly user-facing.

Error kinds were introduced to provide an easy way to understand what type of error occurred without parsing detailed trace log files. They serve as a high-level summary that can be:

• Displayed to users without technical details
• Used for filtering/grouping errors
• Foundation for future retry/recovery strategies based on error category

Examples

use torrust_tracker_deployer_types::ErrorKind;

let kind = ErrorKind::TemplateRendering;
assert_eq!(format!("{kind:?}"), "TemplateRendering");

Variants

TemplateRendering

Template rendering or generation failed

Examples: Tera template errors, invalid template variables, missing template files

InfrastructureOperation

Infrastructure operations failed

Examples: OpenTofu operations (init, plan, apply), LXD operations, container/VM management failures

NetworkConnectivity

Network connectivity or communication failed

Examples: SSH connection timeouts, unreachable hosts, network configuration issues

CommandExecution

External tool or command execution failed

Examples: Ansible playbook failures, shell command errors, tool installation failures

Timeout

Timeout or deadline exceeded

Examples: Operation timeouts, cloud-init wait exceeded, long-running process killed

FileSystem

File system or I/O operation failed

Examples: File read/write errors, permission denied, disk space issues, path not found

Configuration

Configuration validation or parsing failed

Examples: Invalid YAML/TOML, missing required fields, configuration value out of range

StatePersistence

State persistence operation failed

Examples: Failed to save environment state, repository errors, serialization/deserialization failures, storage access issues

Trait Implementations

impl Clone for ErrorKind

fn clone(&self) -> ErrorKind

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ErrorKind

impl Debug for ErrorKind

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ErrorKind

fn deserialize<__D>( __deserializer: __D, ) -> Result<ErrorKind, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ErrorKind

impl PartialEq for ErrorKind

fn eq(&self, other: &ErrorKind) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ErrorKind

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ErrorKind