Struct ServiceEndpoints 

pub struct ServiceEndpoints {
    pub udp_trackers: Vec<Url>,
    pub http_trackers: Vec<Url>,
    pub api_endpoint: Option<Url>,
    pub health_check_url: Option<Url>,
}

Service endpoints for deployed tracker services

This struct stores the URLs for all deployed tracker services. These URLs are computed from the tracker configuration and instance IP after the run command successfully starts the services.

Purpose

Having service endpoints as first-class data allows:

• Displaying service URLs without recomputation
• Sharing URLs with external tools/integrations
• Validating service availability against stored endpoints

Examples

use torrust_tracker_deployer_lib::domain::environment::runtime_outputs::ServiceEndpoints;
use url::Url;

let endpoints = ServiceEndpoints {
    udp_trackers: vec![
        Url::parse("udp://10.0.0.1:6969/announce").unwrap(),
    ],
    http_trackers: vec![
        Url::parse("http://10.0.0.1:7070/announce").unwrap(),
    ],
    api_endpoint: Some(Url::parse("http://10.0.0.1:1212/api").unwrap()),
    health_check_url: Some(Url::parse("http://10.0.0.1:1313/health_check").unwrap()),
};

Fields

udp_trackers: Vec<Url>

UDP tracker announce URLs (e.g., udp://10.0.0.1:6969/announce)

http_trackers: Vec<Url>

HTTP tracker announce URLs (e.g., http://10.0.0.1:7070/announce)

api_endpoint: Option<Url>

HTTP API endpoint URL (e.g., http://10.0.0.1:1212/api)

health_check_url: Option<Url>

Health check API URL (e.g., http://10.0.0.1:1313/health_check)

Implementations

impl ServiceEndpoints

pub fn new( udp_trackers: Vec<Url>, http_trackers: Vec<Url>, api_endpoint: Option<Url>, health_check_url: Option<Url>, ) -> Self

Create new ServiceEndpoints from the provided URLs

pub fn from_tracker_config( tracker_config: &TrackerConfig, instance_ip: IpAddr, ) -> Self

Build ServiceEndpoints from tracker configuration and instance IP

Constructs service URLs by combining the configured bind addresses with the actual instance IP address.

Examples

use torrust_tracker_deployer_lib::domain::environment::runtime_outputs::ServiceEndpoints;
use torrust_tracker_deployer_lib::domain::tracker::TrackerConfig;
use std::net::{IpAddr, Ipv4Addr};

let tracker_config = TrackerConfig::default();
let instance_ip = IpAddr::V4(Ipv4Addr::new(10, 0, 0, 1));

let endpoints = ServiceEndpoints::from_tracker_config(&tracker_config, instance_ip);

Trait Implementations

impl Clone for ServiceEndpoints

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServiceEndpoints

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ServiceEndpoints

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ServiceEndpoints

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

where __S: Serializer,

Serialize this value into the given Serde serializer.