3wordchant/capsul-flask
1
0
Fork 1
Code Issues Pull Requests 1 Releases Wiki Activity
mirror of capsul cloud compute provider web application https://giit.cyberia.club/~forest/capsul-flask
306 Commits 16 Branches 0 Tags 970 KiB
Python 65.3%
HTML 26%
Shell 4.9%
CSS 2.7%
JavaScript 0.7%
Other 0.4%
6bd02a660e
Go to file
3wc 6bd02a660e Basic testing using flask-testing 
This commit makes it possible to override settings during tests, by
switching capsulflask/__init__.py to a "create_app" pattern, and using
`dotenv_values` instead of `load_dotenv`.

The create_app() method returns a Flask app instance, to give
more control over when to initialise the app. This allows setting
environment variables in test files.

Then, use dotenv_values to override loaded .env variables with ones from
the environment, so that tests can set `POSTGRES_CONNECTION_PARAMETERS`
and `SPOKE_MODEL` (possibly others in future..).

Inital tests for the "landing" pages, and login / activation, are
included.
2021-08-16 02:07:34 +02:00
capsulflask Basic testing using flask-testing 2021-08-16 02:07:34 +02:00
docs Split README up into separate files, plus: 2021-07-21 23:43:44 +02:00
.drone.yml Docker image, & local development docker-compose.yml (#2) 2021-07-22 01:18:10 +02:00
.gitignore correctly enforce affordable_vm_sizes post form submission 2021-07-21 16:45:53 -05:00
app.py Basic testing using flask-testing 2021-08-16 02:07:34 +02:00
docker-compose.yml Docker image, & local development docker-compose.yml (#2) 2021-07-22 01:18:10 +02:00
Dockerfile Docker image, & local development docker-compose.yml (#2) 2021-07-22 01:18:10 +02:00
letsencrypt-root-ca.crt simplify postgres connection parameters as a single string 2021-02-16 16:08:54 -06:00
LICENSE.md affero GPL license 2020-05-26 19:56:09 -05:00
Pipfile Basic testing using flask-testing 2021-08-16 02:07:34 +02:00
Pipfile.lock add gevent so we can have concurrent requests in gunicorn mode 2021-02-16 10:40:31 -06:00
README.md Split README up into separate files, plus: 2021-07-21 23:43:44 +02:00
setup.cfg affero GPL license 2020-05-26 19:56:09 -05:00
setup.py postgres automatic schema management roughly working 2020-05-09 19:13:20 -05:00

README.md

capsul-flask

screenshot of capsul.org home page

Python Flask web application implementing user accounts, payment, and virtual machine management for a smol "virtual machine (vm) as a service" aka "cloud compute" provider. Originally developed by Cyberia Computer Club for https://capsul.org

capsul-flask integrates with Stripe as a credit card processor, and BTCPay Server as a cryptocurrency payment processor.

capsul-flask invokes shell-scripts to create/manage libvirt/qemu vms, and it depends on dnsmasq to act as the DHCP server for the vms.

capsul-flask has a "hub and spoke" architecture. The "Hub" runs the web application and talks to the Postrges database, while the "Spoke"(s) are responsible for creating/managing virtual machines. In this way, capsul can be scaled to span more than one machine. One instance of the capsul-flask application can run in both hub mode and spoke mode at the same time, however there must only be one instance of the app running in "Hub" mode at any given time.

Quickstart (run capsul-flask on your computer in development mode)

# get an instance of postgres running locally on port 5432
# (you don't have to use docker, but we thought this might be the easiest for a how-to example)
docker run --rm -it -e POSTGRES_PASSWORD=dev -p 5432:5432 postgres &

# install dependencies 
sudo apt install pipenv python3-dev libpq-dev

# download and run
git clone https://giit.cyberia.club/~forest/capsul-flask
cd capsul-flask
pipenv install
pipenv run flask run

Interested in learning more? How about a trip to the the docs/ folder: