cusdeb-single-node

The project is a set of scripts intended for simplifying deployment of CusDeb for developing purposes.

Installation

Install packages.

sudo apt install git docker docker-compose curl pkg-config pandoc supervisor python3-pip virtualenv postgresql postgresql-server-dev-all qemu-user-static whois -y

Clone project.

git clone git@github.com:tolstoyevsky/cusdeb-single-node.git

Create directory cusdeb.

mkdir cusdeb

Build project in directory cusdeb.

cd cusdeb-single-node
sudo ./single-node.sh build ../cusdeb

Usage

Script supports the following parameters:

Parameter	Description
build <target_directory>	Setup all CusDeb services with all dependences to the <target_directory>. It supposed to be empty.
create-superuser	Create superuser for Django admin interface (see the corresponding section in the official documentation).
dbshell	Connect to the project's database (see the corresponding section in the official documentation).
list	List all services.
loaddata <fixture>	Read the data from the specified fixture and load it into the database (note that <fixture> must be a full path to the fixture file) (see the corresponding section in the official documentation).
makemigrations	Generate migrations based on changes in models (see the corresponding section in the official documentation).
migrate	Apply all migrations (see the corresponding section in the official documentation).
rebuild [<fast>]	Clean the directory the CusDeb services were installed to (see the build command) and re-setup all the services. By default, the chroot environments will be left when cleaning the directory. If you want to re-setup not only the CusDeb services but also chroot environments, pass full as the first argument to rebuild.
remove	Clean the directory the CusDeb services were installed to (see the build command).
restart	Restart all services.
shell	Start Python interpreter with established enviroment.
start	Start all services.
stop <service>	Stop the specified service.
stop-all	Stop all services.

When you start services you can specify the ports for them via the BM_PORT and DOMINION_PORT environment variables. For example:

sudo env BM_PORT=9000 ./single-node.sh start

Default ports are:

Service	Default
CusDeb Web Client	8000
CusDeb API	8001
Black Magic	8002
Dominion	8003
Orion	8004
CusDeb Helpik	8005
CusDeb Tz	8006
CusDeb Anonymous	8007

Authors

See AUTHORS.

Licensing

cusdeb-single-node is available under the Apache License, Version 2.0.