install_role
Install Ansible roles on Ludus servers, handling Galaxy roles automatically and directory-based roles with SSH configuration or manual instructions.
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 |