Развертывание проекта

Требования
- Docker engine
- docker-compose
- make

Основной репозиторий проекта:

https://github.com/skaben/skaben

(это не монорепозиторий, проект развертывается с помощью git submodules)

Win + WSL:

Docker Desktop WSL 2 backend on Windows

Linux:

Install Docker Engine on Ubuntu

запуск сборки TL;DR

склонить себе основной репозиторий https://github.com/skaben/skaben
сказать make fetch
положить .env в skaben/server_core
сказать make build && make start
не забыть создать суперпользователя Django make superuser
создать и применить миграции БД через make migrations && make migrate

содержимое .env

ENVIRONMENT='testing'
DB_HOST='db'
DB_NAME='skaben'
DB_USER='skaben'
DB_PASS='sk4b3n'
POSTGRES_DB='skaben'
POSTGRES_USER='skaben'
POSTGRES_PASSWORD='sk4b3n'
RABBITMQ_ERLANG_COOKIE=''
RABBITMQ_USERNAME='mqtt'
RABBITMQ_PASSWORD='skabent0mqtt'

Где что работает и как запускается

фронт запускается на 127.0.0.1
Django-админка на 127.0.0.1/admin
веб-интерфейс rabbitmq - 127.0.0.1:15672

Дополнительно можно поднять pgadmin:

cd docker_build/pgadmin && docker-compose up
он стартует на 127.0.0.1:5050 и требует минимальной настройки в веб-интерфейсе, чтобы подключиться к БД

Все операции со сборкой производятся через make, ниже приведен список команд. Запуск без аргументов показывает help.

Команды (нужен установленный make)

fetch: Скачать все submodules (фронт и бэк)

build: Запустить сборку сервисов

rebuild: Собрать без кэша, с удалением node_modules

start: Запуск всех сервисов

sh.%: Открыть shell в указанном сервисе [sh.[service]]

exec: Выполнение команды в указанном сервисе [service [command]] migrate Применить миграции

migrations Создать новую миграцию

superuser Создать суперюзера в админке Django

stop Остановка всех сервисов

restart.%: Перезапустить сервис [restart.[service]]

info Показать список сервисов