Extend docs for local development and production deploy

This commit is contained in:
Ben Sturmfels 2023-10-26 13:22:45 +11:00
parent 5686e54386
commit 5047e2f68b
Signed by: bsturmfels
GPG key ID: 023C05E2C9C068F0

View file

@ -33,15 +33,32 @@ exist** on disk for the redirect to be applied.
## Local development ## Local development
Python dependencies are tied to the versions available in Debian. Python dependencies in `requirements.txt` are tied to the versions available in
Debian:
python3 -m pip install -r requirements.txt python3 -m pip install -r requirements.txt
cd www
You'll need a copy of `conservancy/djangocommonsettings.py`, a file that not
committed to the repository that has database settings and other
environment-specific config.
Then run:
python manage.py migrate
python manage.py runserver python manage.py runserver
There is also a Dockerfile available if that's more convenient. See that file
for details.
## Deploying ## Deploying
Changes pushed to the https://k.sfconservancy.org/website repository are Changes pushed to the https://k.sfconservancy.org/website repository are
automatically deployed to the production website by the `conservancy-www-update` automatically deployed to the production website by the `conservancy-www-update`
SystemD timer. See `systemd/conservancy-www-update.timer` for details. SystemD timer. See `systemd/conservancy-www-update.timer` for details.
The `migrate` and `collectstatic` commands are not run automatically. You may
need to run these if modifying the database schema or adding/moving static files:
sudo -u www-data /var/www/venv-website/bin/python manage.py migrate
sudo -u www-data /var/www/venv-website/bin/python manage.py collectstatic --link