126 lines
3.2 KiB
Markdown
126 lines
3.2 KiB
Markdown
# Быстрый старт Auth Learning App
|
||
|
||
## Требования
|
||
- Docker 20.10+ (запущенный)
|
||
- Docker Compose 2.0+
|
||
|
||
## Установка и запуск
|
||
|
||
1. **Клонируйте проект** (если нужно):
|
||
```bash
|
||
git clone <repository-url>
|
||
cd auth-learning-app
|
||
```
|
||
|
||
2. **Настройте переменные окружения**:
|
||
```bash
|
||
cp .env.example .env
|
||
# Отредактируйте .env при необходимости
|
||
```
|
||
|
||
3. **Запустите приложение**:
|
||
```bash
|
||
docker-compose up --build
|
||
```
|
||
|
||
Или в фоновом режиме:
|
||
```bash
|
||
docker-compose up -d --build
|
||
```
|
||
|
||
4. **Приложение будет доступно**:
|
||
- 🌐 Frontend: http://localhost
|
||
- 📚 API Documentation: http://localhost:8000/docs
|
||
- 📖 ReDoc: http://localhost:8000/redoc
|
||
|
||
## Тестовые учетные данные
|
||
- **Email**: test@example.com
|
||
- **Password**: Test1234
|
||
|
||
## Очистка Docker (если нужно)
|
||
|
||
### Использование скрипта:
|
||
```bash
|
||
# Мягкая очистка (контейнеры и сети)
|
||
./docker-cleanup.sh --soft
|
||
|
||
# Средняя очистка (рекомендуется) + образы без тегов
|
||
./docker-cleanup.sh --medium
|
||
|
||
# Полная очистка (ВНИМАНИЕ: удалит базу данных!)
|
||
./docker-cleanup.sh --all
|
||
```
|
||
|
||
### Ручная очистка:
|
||
```bash
|
||
# Остановить и удалить контейнеры проекта
|
||
docker-compose down
|
||
|
||
# Удалить все неиспользуемые образы
|
||
docker image prune -a
|
||
|
||
# Удалить все неиспользуемые volumes (удалит БД!)
|
||
docker volume prune
|
||
|
||
# Очистить build cache
|
||
docker builder prune
|
||
```
|
||
|
||
## Решение проблем
|
||
|
||
### 1. Docker не запущен
|
||
```bash
|
||
# Запустите Docker Desktop или Docker daemon
|
||
# Проверьте статус:
|
||
docker info
|
||
```
|
||
|
||
### 2. Порт уже используется
|
||
```bash
|
||
# Найдите процесс, использующий порт
|
||
sudo lsof -i :80 # Frontend
|
||
sudo lsof -i :8000 # Backend API
|
||
sudo lsof -i :5432 # PostgreSQL
|
||
|
||
# Остановите процесс или измените порты в docker-compose.yml
|
||
```
|
||
|
||
### 3. Проблемы с базой данных
|
||
```bash
|
||
# Просмотрите логи PostgreSQL
|
||
docker-compose logs postgres
|
||
|
||
# Пересоздайте volume (удалит данные!)
|
||
docker-compose down -v
|
||
docker-compose up -d
|
||
```
|
||
|
||
### 4. Проблемы с зависимостями
|
||
```bash
|
||
# Пересоберите образы с очисткой кэша
|
||
docker-compose build --no-cache
|
||
docker-compose up -d
|
||
```
|
||
|
||
## Логи приложения
|
||
```bash
|
||
# Все сервисы
|
||
docker-compose logs -f
|
||
|
||
# Конкретный сервис
|
||
docker-compose logs -f backend
|
||
docker-compose logs -f frontend
|
||
docker-compose logs -f postgres
|
||
```
|
||
|
||
## Остановка приложения
|
||
```bash
|
||
# Остановить все сервисы
|
||
docker-compose down
|
||
|
||
# Остановить с удалением volumes (удалит БД!)
|
||
docker-compose down -v
|
||
```
|
||
|
||
## Дополнительная информация
|
||
Полная документация: [README.md](README.md) |