Installation¶
These instructions will guide you though installing the ansible-rulebook CLI on your local system. Please ensure you have installed all components listed in the Requirements section before starting the installation process.
Requirements¶
Python >=3.9
Python 3 pip
Python 3 development libraries
Fedora: python3-devel
Ubuntu: python3-dev
Java development kit 17
Fedora: java-17-openjdk
Ubuntu: openjdk-17-jdk
Maven
gcc
Installation via pip¶
Ensure the JAVA_HOME environment variable is set. On Fedora-like systems it should be:
JAVA_HOME=/usr/lib/jvm/java-17-openjdk
We use a rules engine called Drools which is written in Java and needs to be compiled from source, by setting the following environment variable:
export PIP_NO_BINARY=jpy
Install ansible-rulebook and dependencies via pip:
pip install wheel ansible-rulebook ansible ansible-runner
Install the required Ansible collections:
ansible-galaxy collection install community.general ansible.eda