Struct AnsibleClient 

pub struct AnsibleClient { /* private fields */ }

A specialized Ansible client for configuration management. This client provides a consistent interface for Ansible operations:

• Run playbooks against target hosts
• Execute ad-hoc commands
• Manage inventory and configuration

Uses CommandExecutor as a collaborator for actual command execution.

Implementations

impl AnsibleClient

pub fn new<P: Into<PathBuf>>(working_dir: P) -> Self

Creates a new AnsibleClient

Arguments

• working_dir - Path to the directory containing Ansible configuration files

pub fn run_playbook( &self, playbook: &str, extra_args: &[&str], ) -> Result<String, CommandError>

Run an Ansible playbook with optional extra arguments

Arguments

• playbook - Name of the playbook file (without .yml extension)
• extra_args - Optional extra arguments to pass to ansible-playbook

Returns

• Ok(String) - The stdout output if the command succeeds
• Err(CommandError) - Error describing what went wrong

Errors

This function will return an error if:

• The Ansible playbook execution fails
• The playbook file does not exist in the working directory
• There are issues with the inventory or configuration

Examples

// Run without extra args (backward compatible)
client.run_playbook("install-docker", &[]).unwrap();

// Run with extra variables
client.run_playbook("configure-firewall", &["-e", "@variables.yml"]).unwrap();

pub fn working_dir(&self) -> &Path

Get the working directory path