Technical: Deployment

Prerequisites

Tools

• Installed Git, Python, Postgres, Python IDE (pycharm or vscode recommended), Postgres IDE (for example, DBVisualizer)

Knowledge

• Git
• Python Click here and read up to and including "Data Structures". This will be enough to get you started.
• Django Part 1 and Part 2 of "Writing your first Django app"

=================================================================

Knowledgebase / BOP Catalog Setup

First Time Set up (Mac and Windows):

1. If using your account
   • Fork repository in github
   • Clone fork
   • Create a branch
2. If you have maintain privileges for this repo, just clone this repo directly

Fix EOL (Windows only)

To avoid issues with Git line endings, disable Git EOL conversion before running the Docker script.
From the bash terminal, type:

git config --global core.autocrlf false
git add --renormalize .

If you don't do this, after docker-compose up, you might get ./start-docker.sh: no such file or directory. Even if running locally, there may be issues if you don't do the above.

Install Python Packages Locally (for both running application in Docker or locally)

If running Docker, it is still recommended to install Python packages locally. This will improve Intellisense and compile errors in IDE such as VSCode.

• Create a virtual environment
• Activate the virtual environment
• Install Python packages. From terminal, run:

cd django_root
pip install -r requirements.txt

You can either run locally or run using docker. If you want to run locally see below. If you have trouble running locally you can run using docker

Running Locally

Install Python Packages Locally

• Install Python locally
• From django_root directory:

pip install -r requirements.txt

Start App Locally

Docker is the preferred method for starting. If Docker is not working or you have some other reason to run it locally: From terminal:

cd django_root
cp .env.local-example .env.local # only needs to be done once
source ./start-dev.sh

Run Scripts Locally

• Open terminal
• From a terminal, run

cd django_root
source ./activate.sh
source ./loadenv.sh .env.local

• From terminal in previous steps, run Python or Django commands

Using Docker

Install Python Packages Locally (optional)

Installing Python packages locally will improve Intellisense and compile errors in IDE such as VSCode.

• Install Python locally
• From django_root directory:

pip install -r requirements.txt

Create Docker Image and Container

• Start Docker
• From the terminal, type:

docker build -t kb-web-image . # this only needs to be done once
docker-compose up

Manually Run Python or Django In Docker Terminal

If you need to open the Docker terminal to try some Django or Python commands:

• From Docker UI, open terminal in Docker for django-hfla-web container.
• From a terminal, run

cd django_root
source ./activate.sh

• From terminal in previous steps, run Python or Django commands