Varia library working group XPPL. https://gitea.xpub.nl/XPUB/XPPL
anglk 59be37d9a4 Update 'xppl/getannot.py' 2 months ago
ansible Ansible fixups. Just make it sure it works for real. 4 months ago
scripts Arrange custom scripts for running applications. 5 months ago
tests Get dummy test suite in place. 5 months ago
xppl Update 'xppl/getannot.py' 2 months ago
.gitignore Ignore egg files. 4 months ago
CHANGELOG.md Shorten that one. 4 months ago
Makefile Remove docker, just us plain RQLite. 5 months ago
Pipfile Drop python-dotenv and load straight form Pipenv + xppl.config. 5 months ago
Pipfile.lock Drop python-dotenv and load straight form Pipenv + xppl.config. 5 months ago
README.md Fix link to YAML and an Ansible link. 4 months ago
setup.py Add a dummy setuptools file. 4 months ago
tox.ini Get dummy test suite in place. 5 months ago
wsgi.py Setup application factory and dev/prod files. 5 months ago

README.md

Varia’s XPPL

The XPUB library living at Varia.

https://books.vvvvvvaria.org/

Run It Locally

Please note, the following instructions have only been tested on the Debian Stretch OS.

You’ll need to run an RQLite database first:

$ apt update && apt install -y make
$ make install-rqlite
$ make rqlited

Then get Pipenv and run the development server with:

$ pipenv install --dev --three
$ pipenv run devserver

The local development web server will now be available.

If you need to check the database contents, run:

$ make rqlite

And then run .help for which commands are available.

Test It

$ pipenv run tox

Refer to the tox.ini for configuration options.

Deploy It

See ansible/README.md for this.

Maintain It

The XPPL is made up of a few parts:

If you know Ansible (it’s just YAML), you can just read the entire configuration.

On the varia.zone machine, you can check the running services with:

$ sudo supervisorctl status all    # check all services
$ sudo supervisorctl stop xppl:*   # stop all XPPL services
$ sudo supervisorctl start xppl:*  # start all XPPL services

You can also view the error logs with:

$ sudo supervisorctl tail xppl:xppl-flask stderr
$ sudo supervisorctl tail xppl:xppl-rqlite stderr

The /var/xppl/xppl/uploads folder is managed by the Varia Syncthing UI.

The RQLite database is located at /var/xppl/rqlite/node.1. No cluster is configured.

No backups are configured right now.