mirror of
https://gitlab.com/megazordpobeda/DataRush.git
synced 2026-05-23 05:07:10 +00:00
148 lines
2.1 KiB
Markdown
148 lines
2.1 KiB
Markdown
# DataRush Backend
|
|
|
|
## Prerequisites
|
|
|
|
Ensure you have the following installed on your system:
|
|
|
|
- [Python](https://www.python.org/) (>=3.10,<3.12)
|
|
- [uv](https://docs.astral.sh/uv/)
|
|
- [Docker](https://www.docker.com/) (for containerized setup)
|
|
|
|
## Basic setup
|
|
|
|
### Installation
|
|
|
|
#### Clone the project
|
|
|
|
```bash
|
|
git clone git@gitlab.com:megazordpobeda/DataRush.git
|
|
```
|
|
|
|
#### Go to the project directory
|
|
|
|
```bash
|
|
cd project/services/backend
|
|
```
|
|
|
|
#### Customize environment
|
|
|
|
```bash
|
|
cp .env.template .env
|
|
```
|
|
|
|
And setup env vars according to your needs.
|
|
|
|
#### Install dependencies
|
|
|
|
##### For dev environment
|
|
|
|
```bash
|
|
uv sync --all-extras
|
|
```
|
|
|
|
##### For prod environment
|
|
|
|
```bash
|
|
uv sync --no-dev
|
|
```
|
|
|
|
#### Running
|
|
|
|
##### Apply migrations
|
|
|
|
```bash
|
|
uv run python manage.py migrate
|
|
```
|
|
|
|
##### Start celery worker
|
|
|
|
```bash
|
|
celery -A config worker -l INFO
|
|
```
|
|
|
|
##### Start server
|
|
|
|
In dev mode:
|
|
|
|
```bash
|
|
uv run python manage.py runserver
|
|
```
|
|
|
|
In prod mode:
|
|
|
|
```bash
|
|
uv run gunicorn config.wsgi
|
|
```
|
|
|
|
## Containerized setup
|
|
|
|
### Clone the project
|
|
|
|
```bash
|
|
git clone git@gitlab.com:megazordpobeda/DataRush.git
|
|
```
|
|
|
|
### Go to the project directory
|
|
|
|
```bash
|
|
cd project/services/backend
|
|
```
|
|
|
|
### Build docker image
|
|
|
|
```bash
|
|
docker build -t datarush-backend .
|
|
```
|
|
|
|
### Customize environment
|
|
|
|
Customize environment with `docker run` command (or bind .env file to container), for all environment vars and default values see [.env.template](./.env.template).
|
|
|
|
### Run docker image
|
|
|
|
#### Backend
|
|
|
|
```bash
|
|
docker run -p 8080:8080 --name datarush-backend datarush-backend
|
|
```
|
|
|
|
#### Celery worker
|
|
|
|
```bash
|
|
docker run --name datarush-celery-worker datarush-backend celery -A config worker -l INFO
|
|
```
|
|
|
|
Backend will be available on [127.0.0.1:8080](http://127.0.0.1:8080).
|
|
|
|
## Testing
|
|
|
|
### Clone the project
|
|
|
|
```bash
|
|
git clone git@gitlab.com:megazordpobeda/DataRush.git
|
|
```
|
|
|
|
### Go to the project directory
|
|
|
|
```bash
|
|
cd project/services/backend
|
|
```
|
|
|
|
### Install dependencies
|
|
|
|
```bash
|
|
uv sync --all-extras
|
|
```
|
|
|
|
### Run tests
|
|
|
|
```bash
|
|
uv run coverage run --source="." manage.py test
|
|
```
|
|
|
|
### Check coverage
|
|
|
|
```bash
|
|
uv run coverage report
|
|
```
|