openfisca-djangoapi

A database and Django webserver layer for serving OpenFisca rulesets

Serving Locally and Deploying

This repo can be served in two ways:

Serve with a local development environment ✔️
- Instructions in local_deployment.md
Serve with Docker
- Not recommended (this functionality is currently broken ⚠️) ⚠️
- Instructions in docker_deployment.md

This app can be deployed in a number of ways, we'll leave that up to you 😉
But, here are some considerations
- This app uses a sqlite3 database. SQLite runs in memory, and backs up its data store in files on disk. Thus, a persistent filesystem is required - and platforms with ephemeral filesystems (such as Heroku) are not suitable.
- The authors of this repo use AWS ElasticBeanstalk, because it has a persistent filesystem. AWS ElasticBeanstalk requires a few additional config files, located at /.ebextensions and /.platform. Additional info on ElasticBeanstalk can be found at aws_elasticbeanstalk_instructions.md.

We recommend you build and serve this Django application locally.

To do this, follow these instructions: local_deployment.md.

Not recommended (this functionality is currently broken ⚠️)

To do this, follow these instructions: docker_deployment.md.

See additional_resources.md to learn more about all the different components used in this repository.