install_role_from_url
Install Ansible roles from custom Git repositories not available on Ansible Galaxy. Clone and set up roles directly from Git URLs with optional branch specification.
Instructions
Install an Ansible role from a custom Git repository URL.
Use this to install roles from custom Git repositories that are not on Ansible Galaxy. The repository will be cloned on the Ludus server and installed.
Args: role_name: Name to give the role when installed git_url: Git repository URL (e.g., "https://github.com/user/my-role") branch: Optional branch/tag to checkout (default: main/master)
Returns: Installation result with status and instructions
Examples: # Install a custom role from GitHub result = await install_role_from_url( role_name="my-custom-role", git_url="https://github.com/myorg/ludus-custom-role" )
# Install from a specific branch
result = await install_role_from_url(
role_name="my-role-dev",
git_url="https://github.com/myorg/ludus-custom-role",
branch="develop"
)Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role_name | Yes | ||
| git_url | Yes | ||
| branch | No |