Skip to main content

SshConfig

Struct SshConfig 

Source
pub struct SshConfig {
    pub credentials: SshCredentials,
    pub socket_addr: SocketAddr,
    pub connection_config: SshConnectionConfig,
}
Expand description

SSH connection configuration for a specific remote instance.

Contains both the SSH credentials and the target host socket address, representing everything needed to establish an SSH connection.

Fields§

§credentials: SshCredentials

SSH authentication credentials.

§socket_addr: SocketAddr

Socket address (IP address and port) of the target host for SSH connections.

This contains both the IP address and port number of the remote instance that the SSH client will connect to.

§connection_config: SshConnectionConfig

SSH connection behavior configuration (timeouts, retries, logging).

Implementations§

Source§

impl SshConfig

Source

pub fn new(credentials: SshCredentials, ssh_socket_addr: SocketAddr) -> Self

Creates a new SSH connection configuration with default connection settings.

Uses SshConnectionConfig::default() for connection behavior parameters.

use torrust_tracker_deployer_lib::adapters::ssh::{SshCredentials, SshConfig};
let credentials = SshCredentials::new(
    PathBuf::from("/home/user/.ssh/deploy_key"),
    PathBuf::from("/home/user/.ssh/deploy_key.pub"),
    Username::new("ubuntu").unwrap(),
);
let socket_addr = SocketAddr::new(IpAddr::V4(Ipv4Addr::new(192, 168, 1, 100)), 22);
let config = SshConfig::new(
    credentials,
    socket_addr,
);
Source

pub fn with_connection_config( credentials: SshCredentials, ssh_socket_addr: SocketAddr, connection_config: SshConnectionConfig, ) -> Self

Creates a new SSH connection configuration with custom connection settings.

Use this constructor when you need to customize connection behavior (timeouts, retries, logging) for specific scenarios.

use torrust_tracker_deployer_lib::adapters::ssh::{SshCredentials, SshConfig, SshConnectionConfig};
let credentials = SshCredentials::new(
    PathBuf::from("/home/user/.ssh/deploy_key"),
    PathBuf::from("/home/user/.ssh/deploy_key.pub"),
    Username::new("ubuntu").unwrap(),
);
let socket_addr = SocketAddr::new(IpAddr::V4(Ipv4Addr::new(192, 168, 1, 100)), 22);

// Custom configuration for fast testing
let connection_config = SshConnectionConfig::new(1, 5, 1, 2);
let config = SshConfig::with_connection_config(
    credentials,
    socket_addr,
    connection_config,
);
Source

pub fn with_default_port(credentials: SshCredentials, host_ip: IpAddr) -> Self

Creates a new SSH connection configuration with the default port (22).

This is a convenience method for when you want to use the standard SSH port.

use torrust_tracker_deployer_lib::adapters::ssh::{SshCredentials, SshConfig};
let credentials = SshCredentials::new(
    PathBuf::from("/home/user/.ssh/deploy_key"),
    PathBuf::from("/home/user/.ssh/deploy_key.pub"),
    Username::new("ubuntu").unwrap(),
);
let config = SshConfig::with_default_port(
    credentials,
    IpAddr::V4(Ipv4Addr::new(192, 168, 1, 100)),
);
Source

pub fn ssh_priv_key_path(&self) -> &PathBuf

Access the SSH private key path.

Source

pub fn ssh_pub_key_path(&self) -> &PathBuf

Access the SSH public key path.

Source

pub fn ssh_username(&self) -> &str

Access the SSH username.

Source

pub fn ssh_port(&self) -> u16

Access the SSH port.

Source

pub fn host_ip(&self) -> IpAddr

Access the host IP address.

Source

pub fn socket_addr(&self) -> SocketAddr

Access the socket address.

Source

pub fn connection_timeout_secs(&self) -> u32

Access the connection timeout in seconds.

Trait Implementations§

Source§

impl Clone for SshConfig

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> DynClone for T
where T: Clone,

Source§

fn __clone_box(&self, _: Private) -> *mut ()

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> FromRef<T> for T
where T: Clone,

Source§

fn from_ref(input: &T) -> T

Converts to this type from a reference to the input type.
Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> IntoRequest<T> for T

Source§

fn into_request(self) -> Request<T>

Wrap the input message T in a tonic::Request
Source§

impl<T> IntoResult<T> for T

Source§

type Err = !

Source§

fn into_result(self) -> Result<T, <T as IntoResult<T>>::Err>

Source§

impl<L> LayerExt<L> for L

Source§

fn named_layer<S>(&self, service: S) -> Layered<<L as Layer<S>>::Service, S>
where L: Layer<S>,

Applies the layer to a service and wraps it in Layered.
Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more