All ITEZ services started from a single repository
Keep in mind this repository is for local development only and is not meant to be deployed on any production environment!.
- Clone the repository:
$ git clone https://github.com/Digital-Prophets/itez-platform.git --recursive --jobs 2
-
We are using shared folders to enable live code reloading. Without this, Docker Compose will not start:
- Windows/MacOS: Add the cloned
itez-platform
directory to Docker shared directories (Preferences -> Resources -> File sharing). - Windows/MacOS: Make sure that in Docker preferences you have dedicated at least 5 GB of memory (Preferences -> Resources -> Advanced).
- Linux: No action required, sharing already enabled and memory for Docker engine is not limited.
- Windows/MacOS: Add the cloned
-
Go to the cloned directory:
$ cd itez-platform
- Build the application:
$ docker-compose up --build
- Apply Django migrations:
$ docker-compose run --rm api python manage.py makemigrations
$ docker-compose run --rm api python manage.py migrate
- Collect static files:
$ docker-compose run --rm api python manage.py collectstatic --noinput
- To create the admin super user:
$ docker-compose run --rm api python manage.py createsuperuser
- Run the application:
$ docker-compose up
Both the frontend and api backend services will build and start up the necesarry services. If nothing shows up on port 3000 wait until Compiled successfully
shows in the console output.
This repository contains newest stable versions. When new release appear, pull new version of this repository. In order to update all of them to their newest versions, run:
$ git submodule update --remote
You can find the latest version of API backend and the Frontend in their individual repositories:
Most of the time both issues can be solved by cleaning up space taken by old containers. After that, we build again the whole platform.
- During these problems. Make sure docker stack is not running
$ docker-compose stop
- Remove existing volumes
Warning! Proceeding will remove also your database container! If you need existing data, please remove only services which cause problems! https://docs.docker.com/compose/reference/rm/
docker-compose rm
- Build fresh containers
docker-compose build
- Now you can run fresh environment using commands from
How to run it?
section. Done!
If you are getting issues with lack of available space, consider prunning your docker cache:
Warning! This will remove:
- all stopped containers
- all networks not used by at least one container
- all dangling images
- all dangling build cache
More info: https://docs.docker.com/engine/reference/commandline/system_prune/
I've been warned
$ docker system prune
docker-compose up api worker
for backend services onlydocker-compose up
for backend and frontend services
- Itez Core (API) - http://localhost:8000
- Itez Frontend - http://localhost:3000
- Jaeger UI (APM) - http://localhost:16686
- Mailhog (Test email interface) - http://localhost:8025
Disclaimer: Everything you see here is open and free to use as long as you comply with the license. There are no hidden charges. We promise to do our best to fix bugs and improve the code.