sail_lanier

this project contains the source for the sail-lanier.com website.

License: GPL-3.0 (see LICENSE).

to run locally

create a python venv. the version must match the runtime in zappa_settings.json, because zappa packages your local site-packages rather than installing from requirements.txt at deploy time.

python3.14 -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt

if you want to use docker

docker build -t sail_lanier .  # add --no-cache to force a complete rebuild

the sail_lanier-shell alias lives in ~/.aliases (chezmoi dot_aliases). it bind-mounts this repo's sail_lanier/ dir and uses AWS_PROFILE=sail-lanier.

sail_lanier-shell

create a fresh database

note that you must run . .venv/bin/activate before interacting with manage.py

create a database

./manage.py migrate --settings=sail_lanier.settings.base

add an admin user

./manage.py createsuperuser --settings=sail_lanier.settings.base

start the server

cd sail_lanier
./manage.py runserver --settings=sail_lanier.settings.base 0.0.0.0:8000  # remove 0.0.0.0:8000 to only listen on localhost

if everything goes as planned your site should be available on http://127.0.0.1:8000/

managing the production instance

in order to manage the production and development instance, you must have AWS IAM credentials and the prod.py or dev.py config file.

to update the lambda function

zappa update prod

to update static files

AWS_PROFILE=sail-lanier ./manage.py collectstatic --settings=sail_lanier.settings.dev
AWS_PROFILE=sail-lanier ./manage.py collectstatic --settings=sail_lanier.settings.prod

to vacuum sqlite

zappa manage prod s3_sqlite_vacuum

before upgrading Django version, run

python -Wa manage.py test --settings=sail_lanier.settings.base

useful URLs

technologies this project makes use of:

• https://www.djangoproject.com/
• https://github.com/Miserlou/Zappa
• https://edgarroman.github.io/zappa-django-guide/setup/