This repository contains code to deploy a Leihs system.
The important configuration is defaults.yml. It should never be necessary to modify this file.
We have set up the deployment such that variables defined in this file have the lowest precedence possible in an Ansible setup. They are precicely role defaults. See the Ansible documentation regarding precedence for details.
All variables defined in you inventory (including those from an inventory file) can and will override variables defined in defaults.yml!
A recent Linux or MacOS System with "build-tools" installed.
The scripts used in this project try to setup their own environment via the
asdf version manager. Therefore asdf
needs to be properyly installed and
configured, see https://asdf-vm.com/.
We assume that the target server is used exclusively to run Leihs. We further assume that the system is a largely unmodified Debian or Ubuntu server. If this is true the integrity and security of the system will not be compromised to our best knowledge.
To use ansible
locally installed and pinned to a recommended version,
use the helper scripts to set up a "python virtualenv" and use it from there.
For simple use, invoke the wrapper script: bin/ansible-playbook --help
To debug the installation (more verbose output): bin/virtualenv