For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Open sourceSupportFAQsDocs Home
DocumentationRelease notes
DocumentationRelease notes
  • Itential Automation Gateway
    • Overview
    • Related terminology
        • Git integration
        • gRPC framework
        • HashiCorp Vault
        • HTTP requests
        • NETCONF
        • Netmiko
        • Nornir
        • OpenConfig
        • Python virtual environment
        • Script execution engine
        • Multiple Ansible versions
        • Terraform
    • Navigate UI
    • Automatic discovery in IAG
    • Use hidden keyword extension
    • Edit the description field
    • Edit JSON schema
    • Manage decorations
    • View audit logs
LogoLogo
Open sourceSupportFAQsDocs Home
On this page
  • Activate and install Ansible VENV
  • Choose the Ansible VENV version to use
  • Ansible configuration
Itential Automation GatewayDeploy and manageConfigure and manage integrations

Support of multiple Ansible versions

Was this page helpful?
Previous

Terraform integration

Next
Built with

You can optionally select which version of Ansible to use to execute a particular Ansible playbook in Itential Automation Gateway (IAG). Virtual environments (VENVs) let you associate any Ansible playbook with an existing virtual environment. Any Ansible playbook not associated with a virtual environment will execute in the default version of Ansible configured for IAG.

Activate and install Ansible VENV

Using a terminal, run the lines of code below and choose the version of Ansible needed (in the example, Ansible 2.9.0 is shown).

Place a new virtual environment in the Ansible virtual environment directory:

$/opt/automation-gateway/ansible_venvs/

Activate the environment and install the Ansible version of your choice:

$python3 -m venv /opt/automation-gateway/ansible_venvs/ansible2.9
$source /opt/automation-gateway/ansible_venvs/ansible2.9/bin/activate
$pip install ansible==2.9.0

Choose the Ansible VENV version to use

In IAG, navigate to Ansible and then click Playbooks to open the menu and select the appropriate playbook.

From the Parameters tab, open the Select an Ansible Venv dropdown to display the available versions of Ansible.

Select an Ansible Venv dropdown showing available versions

Once you have selected the Ansible version, click the save (disk) icon to automatically set the decorator.

Save icon to set the Ansible version decorator

Ansible configuration

After setting the decorator, navigate to Ansible Configuration in IAG to verify the Ansible Venv checkbox is selected and the Ansible Venv Path is shown.

Ansible configuration showing the Venv checkbox and path

If Ansible Venv is not checked, the Select an Ansible Venv dropdown in the Parameters tab of the playbook will be grayed out and unavailable.