Varia library working group XPPL. https://gitea.xpub.nl/XPUB/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.
 
 
 
 
Luke Murphy fc393a3d5f
Separate Ansible world into setup and deployment.
5 years ago
ansible Separate Ansible world into setup and deployment. 5 years ago
scripts Arrange custom scripts for running applications. 5 years ago
tests Get dummy test suite in place. 5 years ago
xppl Updated .messages to have more top margin. Re-arranged CSS to bring * & body to top of page. 5 years ago
.gitignore Ignore egg files. 5 years ago
CHANGELOG.md Add a first stab at a change log. 5 years ago
Makefile Remove docker, just us plain RQLite. 5 years ago
Pipfile Drop python-dotenv and load straight form Pipenv + xppl.config. 5 years ago
Pipfile.lock Drop python-dotenv and load straight form Pipenv + xppl.config. 5 years ago
README.md Make the title better. Add note. 5 years ago
setup.py Add a dummy setuptools file. 5 years ago
tox.ini Get dummy test suite in place. 5 years ago
wsgi.py Setup application factory and dev/prod files. 5 years ago

README.md

Varia's XPPL

The XPUB library living at Varia.

https://books.vvvvvvaria.org/

Change It

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

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:

  • The Flask application and it's dependencies.
  • The RQLite database.
  • The Syncthing integration for uploads.
  • The Nginx reverse proxy.
  • The Let's Encrypt web certificates.

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.