Template Django app.
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.
 
 
 
 
 
Mark Veidemanis b055dc9f77
Update templates
7 days ago
app Remove async and update CRUD helpers 7 days ago
core Update templates 7 days ago
docker Tweak UWSGI settings 2 months ago
.gitignore Add local settings to Git 7 days ago
.pre-commit-config.yaml Update pre-commit hooks and reformat 1 month ago
Dockerfile Make running with Docker more convenient 4 weeks ago
Makefile Make running with Docker more convenient 4 weeks ago
README.md Create a better Readme 2 months ago
docker-compose.yml Make running with Docker more convenient 4 weeks ago
manage.py Initial commit 2 months ago
requirements.txt Make running with Docker more convenient 4 weeks ago

README.md

Envelope

Template Django app.

Setting up the environment

Create the virtual environment, enable it, and install the dependencies.

$ python3 -m venv env
$ source env/bin/activate
(env) $ pip install -r docker/prod/requirements.prod.txt

Local settings

You'll need to copy the app/local_settings.example.py file to app/local_settings.py. The project won't start otherwise.

$ cp app/local_settings.example.py app/local_settings.py

stack.env

The stack.env file referenced is a Portainer special. This is where Portainer would put a file containing all the environment variables set up in its UI. To run it manually, you will need to copy stack.env.example to stack.env in the project root.

Running database migrations

Now we need to run the database migrations in order to get a working database.

(env) $ python manage.py migrate

Note that these are automatically run by a step in the compose file in production. You won't need to do that manually.

Creating a superuser

In order to access Django admin, we need a superuser.

(env) $ python manage.py createsuperuser
Username: t2
Email address: t2@google.com
Password: 
Password (again): 
Superuser created successfully.

Running

The Docker Compose file is located in docker/docker-compose.prod.yml. There is a shortcut to run it: make run.

Stopping

To stop the containers, run make stop.

Setup

This setup may be different from what you've seen before.

Uvicorn

There is a Uvicorn worker in the app container listening on /var/run/socks/app.sock. This is the bit that runs the actual code.

Nginx

Nginx runs in the nginx container and proxies requests to Uvicorn thanks to a mounted and shared directory. No TCP required.

Pre-start steps

There's a few commands running before start to ensure Django works correctly.

Migration

The migration container step runs the migrations so you don't need to remember to do it.

Collectstatic

The collectstatic container step collects all static files from plugins and puts them in the core/static folder. This folder is served straight from Nginx without going through Uvicorn.