2021-02-24 20:01:34 +01:00
|
|
|
# An ansible role to install Bibliogram on a Debian machine
|
|
|
|
|
|
|
|
## Dependencies
|
|
|
|
|
2021-02-25 23:41:11 +01:00
|
|
|
This role sets up a [bibliogram][1] node with one of two methods:
|
2021-02-24 20:01:34 +01:00
|
|
|
|
2021-02-25 23:41:11 +01:00
|
|
|
- orchestrating it via `systemd`
|
|
|
|
- orchestrating it via `docker`
|
2021-02-24 20:01:34 +01:00
|
|
|
|
2021-02-25 23:41:11 +01:00
|
|
|
You have to choose which method to use.
|
|
|
|
|
|
|
|
## Variables
|
|
|
|
|
|
|
|
These are the default values
|
|
|
|
```
|
|
|
|
---
|
|
|
|
ansible_bibliogram_port: "10407"
|
|
|
|
ansible_bibliogram_with_docker: false
|
|
|
|
ansible_bibliogram_with_systemd: false
|
|
|
|
ansible_bibliogram_backup_frequency: "daily"
|
|
|
|
ansible_bibliogram_root_directory: "/var/www/bibliogram"
|
|
|
|
ansible_bibliogram_tor_enabled: false
|
|
|
|
```
|
|
|
|
|
|
|
|
It is **mandatory** to set a value for `ansible_bibliogram_base_url`, that
|
|
|
|
points to the public url (together with the protocol and port if not default!)
|
|
|
|
the service is available at.
|
|
|
|
|
|
|
|
## Develop
|
|
|
|
|
|
|
|
A `Vagrantfile` is provided. You can run the `systemd` case with
|
|
|
|
|
|
|
|
```
|
|
|
|
$ vagrant up --provider=libvirt --provision
|
|
|
|
```
|
|
|
|
|
|
|
|
or the `docker` case with
|
|
|
|
|
|
|
|
```
|
|
|
|
$ ANSIBLE_BIBLIOGRAM_DOCKER=1 vagrant up --provider=libvirt --provision
|
|
|
|
```
|
|
|
|
|
|
|
|
Then, if you put `debiantest 192.168.123.2` in your `/etc/hosts`, you should be
|
|
|
|
able to reach a bibliogram instance at `http://debiantest:10407`.
|
2021-02-24 20:01:34 +01:00
|
|
|
|
|
|
|
|
|
|
|
[1]: https://git.sr.ht/~cadence/bibliogram
|