install_role
Install Ansible roles on Ludus servers from Galaxy or repositories, with automatic retry logic for reliable deployment.
Instructions
Install an Ansible role on the Ludus server via MCP.
This MCP tool automatically handles:
Galaxy roles (installed directly from Ansible Galaxy, e.g., "badsectorlabs.ludus_adcs")
Directory-based roles (automatically cloned via SSH if configured, e.g., "ludus-ad-content")
Retry logic for transient failures
For directory-based roles: If SSH is configured (via configure_ssh_role_installation),
the MCP server will automatically clone the repository on the Ludus server and install it.
Otherwise, manual installation instructions will be provided.
Args: role_name: Name of the role to install (e.g., "badsectorlabs.ludus_adcs", "aleemladha.wazuh_server_install") role_url: Optional URL for Galaxy roles (usually not needed) max_retries: Maximum retry attempts (default: 3)
Returns: Installation result with status and details
Example: # Install a Galaxy role (works immediately) result = await install_role(role_name="badsectorlabs.ludus_adcs")
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role_name | Yes | ||
| role_url | No | ||
| max_retries | No |