Requirements and dependencies¶
ARA should work on any Linux distributions as long as python3 is available.
Since ARA provides Ansible plugins to record data, it should be installed wherever Ansible is running from so that Ansible can use those plugins. The API server does not require to run on the same machine as Ansible.
By default, only the client and plugin dependencies are installed. This lets users record and send data to a remote API server without requiring that the API server dependencies are installed.
If you are standing up an API server or if your use case is about recording
data locally or offline, the required dependencies can be installed
automatically by suffixing
[server] to your pip install commands.
Installing from PyPi or from source¶
First, it is recommended to use a python virtual environment in order to avoid conflicts with your Linux distribution python packages.
python3 -m venv ~/.ara/virtualenv
To install the latest release of ARA from PyPi:
# With the API server dependencies ~/.ara/virtualenv/bin/pip install "ara[server]" # Without the API server dependencies ~/.ara/virtualenv/bin/pip install ara
Installing from source is possible by using the git repository:
# With the API server dependencies # (Suffixes don't work when supplying the direct git URL) git clone https://github.com/ansible-community/ara ara-src pip install "./ara-src[server]" # Without the API server dependencies ~/.ara/virtualenv/bin/pip install git+https://github.com/ansible-community/ara