billyzou0741326/sre-fall-21

SRE Site

Test

Deploy

First, ensure .env file is present under the top level of the project with the correct configuration.

There are multiple steps to deploying the site with docker:

Initialize docker containers

docker-compose up --no-start    # create containers, volumes, network, etc

Set up postgres server

docker-compose start postgres   # starts the postgresql container

Bring up all services

docker-compose up -d --build    # starts all services (backend)

After the services are started up and running, proceed to set up some one-time configuration for django

One-time conifguration

docker-compose exec backend python manage.py createsuperuser    # create admin accounts for the web app

Develop

Start python application

On a separate shell, do:

dotenv python3 manage.py runserver 0.0.0.0:9000     # run python app

Watch tailwind css style changes

On a separate shell, do:

npx postcss css/tailwind.css -o static/css/tailwind-output.css --watch 

Now make changes to the code/html and see the changes live!

This workflow aims to resolve commit history conflicts.

After committing (git commit) new changes, before pushing to the remote repository:

git remote update               # checks for new commits from the remote repository
git rebase remotes/origin/main  # rebase, or align commit history, with the remote main branch

If rebase fails due to merge conflict, resolve the conflict and commit the resolution.

Then push to your branch and the main branch:

git push origin <your_branch>
git push origin HEAD:main       # main branch