Varia library working group XPPL.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
anglk 9d549d0db0 Update 'xppl/' 4 years ago
ansible Ansible fixups. Just make it sure it works for real. 6 years ago
scripts Arrange custom scripts for running applications. 6 years ago
tests Get dummy test suite in place. 6 years ago
xppl Update 'xppl/' 4 years ago
.gitignore Ignore egg files. 6 years ago Shorten that one. 6 years ago
Makefile Remove docker, just us plain RQLite. 6 years ago
Pipfile Drop python-dotenv and load straight form Pipenv + xppl.config. 6 years ago
Pipfile.lock Drop python-dotenv and load straight form Pipenv + xppl.config. 6 years ago Fix link to YAML and an Ansible link. 6 years ago Add a dummy setuptools file. 6 years ago
tox.ini Get dummy test suite in place. 6 years ago Setup application factory and dev/prod files. 6 years ago

Varia's XPPL

The XPUB library living at Varia.

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/ 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 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.