Struct AnsibleTemplateRenderingService 

pub struct AnsibleTemplateRenderingService { /* private fields */ }

Service for rendering Ansible templates with runtime configuration

This service encapsulates the logic for rendering Ansible inventory and configuration templates. It’s designed to be shared across command handlers that need to prepare Ansible files (e.g., Provision, Register).

Design

The service follows dependency injection principles:

• Dependencies (template renderer) are injected at construction time
• Runtime data (SSH credentials, IP, port) is passed to the render method

This allows the service to be configured once and reused with different runtime parameters.

Implementations

impl AnsibleTemplateRenderingService

pub fn new( ansible_template_renderer: Arc<AnsibleProjectGenerator>, clock: Arc<dyn Clock>, ) -> Self

Create a new AnsibleTemplateRenderingService

Arguments

• ansible_template_renderer - The renderer for Ansible templates
• clock - The clock for generating timestamps

pub fn from_paths( templates_dir: PathBuf, build_dir: PathBuf, clock: Arc<dyn Clock>, ) -> Self

Build an AnsibleTemplateRenderingService from environment paths

This is a factory method that creates the service with all necessary dependencies based on the environment’s template and build directories.

Arguments

• templates_dir - Directory containing the source templates
• build_dir - Directory where rendered templates will be written
• clock - The clock for generating timestamps

Returns

Returns a configured AnsibleTemplateRenderingService ready for template rendering

Example

use std::path::PathBuf;
use std::sync::Arc;
use torrust_tracker_deployer_lib::application::services::rendering::AnsibleTemplateRenderingService;
use torrust_tracker_deployer_lib::shared::clock::SystemClock;

let service = AnsibleTemplateRenderingService::from_paths(
    PathBuf::from("templates"),
    PathBuf::from("build/my-env"),
    Arc::new(SystemClock),
);

pub async fn render_templates( &self, user_inputs: &UserInputs, instance_ip: IpAddr, ssh_port_override: Option<u16>, ) -> Result<(), AnsibleTemplateRenderingServiceError>

Render Ansible templates with the provided runtime configuration

This renders the Ansible inventory and configuration templates so that Ansible playbooks can be executed against the target instance.

Arguments

• user_inputs - User-provided environment configuration (SSH credentials, tracker config, etc.)
• instance_ip - IP address of the provisioned instance (runtime output)
• ssh_port_override - Optional SSH port override (takes precedence over user_inputs.ssh_port)

Errors

Returns AnsibleTemplateRenderingServiceError::RenderingFailed if template rendering fails.

Example

use std::net::IpAddr;

let service = AnsibleTemplateRenderingService::from_paths(...);
service.render_templates(&user_inputs, "192.168.1.100".parse().unwrap(), None).await?;