Setup a development environment

Pre requisites

Following tools need to be installed on your workstation:

Ubuntu based OS:

sudo apt-get install libmysqlclient-dev

CentOS/RedHat/Fedora

sudo yum install mysql-devel

The development environment is composed of 4 parts:

Docker compose: The Docker compose file is used to deploy all required components such as the database and the message broker
Celery worker: The Celery worker is a separated process that receive tasks from the main Django process to be executed asynchronously
Celery beat: Celery beat is a periodic task scheduler that send task into the celery worker based on a frequency. This part is used by Squest to check the status of executed Tower job
Django built in web server: Integrated web server used only for development purpose. main process of the application that serve the Web Ui and the API

Run the Docker dev env to bring up database, message broker and other required system

docker-compose -f dev-env.docker-compose.yml up

Install JS libs (npm need to be installed)

npm install

Initializing and installing python libraries with Poetry

poetry install

Go into the python virtual env

poetry shell

Create the database with Django migration script

python manage.py migrate

Collect static files

python manage.py collectstatic --noinput

Insert default data

python manage.py insert_default_data

Run Celery process for async tasks from a new terminal

poetry shell
celery -A service_catalog worker -l info

Run Celery beat for periodic tasks from a new terminal

poetry shell
celery -A service_catalog worker --beat --scheduler django -l info

This next command should be executed from your IDE.

Run django dev server

poetry shell
python manage.py runserver

To clean all Celery pending tasks

poetry shell
celery -A restapi purge

Run unit tests

poetry shell
python manage.py test

Run code coverage

coverage run --source='.' manage.py test
coverage report

phpMyAdmin is exposed on localhost:8082.