# Production Deployment Guide для Oknardia

## Структура на хосте

Структура директорий на production сервере должна быть:

```
~/docker-app/oknardia-site/
├── .env                          # Переменные окружения Django
├── config/                       # Конфиги
│   └── nginx/
│       └── oknardia-app--external-nginx.conf  # Конфиг Nginx (шаблон)
├── database/                     # БД SQLite (создается автоматически)
│   └── oknardia.sqlite3
├── media/                        # Медиа файлы, uploads, кеши
│   ├── img_avatar/
│   ├── img_seria/
│   ├── _serv_sitemap/
│   └── _error/               # Error pages (генерируются контейнером)
└── docker-compose.prod.yml   # Конфиг Docker
```

## Установка на Production сервере

### 1. Создать директории и скопировать файлы

```bash
# На хосте
mkdir -p ~/docker-app/oknardia-site/{config/nginx,database,media}

# Скопировать docker-compose.prod.yml и .env из проекта
cp docker-compose.prod.yml ~/docker-app/oknardia-site/
cp .env ~/docker-app/oknardia-site/

# Скопировать конфиг nginx
cp config/nginx/oknardia-app--external-nginx.conf ~/docker-app/oknardia-site/config/nginx/
```

### 2. Настроить .env на сервере

Отредактировать `~/docker-app/oknardia-site/.env`:

```bash
# Критично: должны быть правильные credentials для реестра Gitea
REPO_USER=erjemin
REPO_PASS=<сгенерированный токен из личного кабинета>

# Критично: переменная с путем проекта для sed в конфиге nginx
export HOST_PROJECT_PATH=/home/default_user/projects/oknardia-site
# (если путь другой, обновить эту переменную)

# Остальное можно скопировать из локального .env
DEBUG=False
DJANGO_SECRET_KEY=...
```

### 3. Запустить контейнеры

```bash
cd ~/docker-app/oknardia-site/

# Первый запуск (холодный старт)
docker compose -f docker-compose.prod.yml up -d

# Проверить логи
docker compose -f docker-compose.prod.yml logs -f web

# Проверить статус контейнеров
docker compose -f docker-compose.prod.yml ps
```

### 4. Проверить что nginx конфиг был сгенерирован

После первого запуска контейнер должен:
- Создать `/config/nginx/oknardia-app--external-nginx.conf` (боевой конфиг)
- Создать `/config/nginx/oknardia-app--external-nginx.conf.example` (exemplo)

```bash
ls -la ~/docker-app/oknardia-site/config/nginx/
```

### 5. Настроить Nginx на хосте

На хосте установить Nginx и скопировать/ссылаться на конфиг из контейнера:

```bash
# На хосте (например, Ubuntu 20.04)
sudo systemctl install nginx

# Включить сгенерированный конфиг в основной конфиг Nginx
# /etc/nginx/sites-available/oknardia или /etc/nginx/conf.d/oknardia.conf

# Пример:
sudo ln -s /home/default_user/projects/oknardia-site/config/nginx/oknardia-app--external-nginx.conf \
    /etc/nginx/sites-enabled/oknardia

# Проверить и перезагрузить Nginx
sudo nginx -t
sudo systemctl reload nginx
```

## Команды для управления

```bash
cd ~/docker-app/oknardia-site/

# Запустить контейнеры (если они были остановлены)
docker compose -f docker-compose.prod.yml up -d

# Остановить контейнеры
docker compose -f docker-compose.prod.yml down

# Перезагрузить контейнеры (удалить и создать заново)
docker compose -f docker-compose.prod.yml down
docker compose -f docker-compose.prod.yml up -d

# Посмотреть логи
docker compose -f docker-compose.prod.yml logs -f web
docker compose -f docker-compose.prod.yml logs -f watchtower

# Выполнить команду внутри контейнера Django
docker compose -f docker-compose.prod.yml exec web python manage.py shell

# Пересоздать пре-рендер кеши вручную
docker compose -f docker-compose.prod.yml exec web python manage.py regenerate_seria_prerender
```

## Что делает docker-compose.prod.yml

### Сервис `web` (Django + Gunicorn)

При старте контейнера:
1. ✅ Применяет миграции БД (`migrate --noinput`)
2. ✅ Собирает статику (`collectstatic --noinput`)
3. ✅ Генерирует sitemap'ы (`generate_sitemaps`)
4. ✅ Пересоздает пре-рендер кеши для серий (`regenerate_seria_prerender`)
5. ✅ Пересчитывает рейтинги (`make_rating`)
6. ✅ Копирует конфиг nginx с авто-заменой путей (через `sed`)
7. ✅ Запускает Gunicorn на `127.0.0.1:8000`

### Сервис `watchtower` (авто-обновление)

- 👁️ Следит за реестром Gitea (проверка каждые 30 минут)
- 🔄 Автоматически скачивает новый образ, если он есть
- ♻️ По-graceful перезагружает контейнер web
- 🗑️ Удаляет старые образы (WATCHTOWER_CLEANUP=true)

Watchtower использует метку на контейнере `web`:
```yaml
labels:
  - "com.centurylinklabs.watchtower.scope=oknardia-scope"
```

## Файлы, которые монтируются с хоста

| На хосте | В контейнере | Назначение |
|----------|----------|-----------|
| `./database/` | `/home/app/database/` | БД SQLite (КРИТИЧНО!) |
| `./media/` | `/home/app/public/media/` | Медиа файлы, uploads |
| `./config/` | `/nginx_configs_host/` | Конифиги (читаются и пишущутся контейнером) |

## Переменные окружения в docker-compose.prod.yml

```yaml
environment:
  - DEBUG=False                # Production: без debug
  - DJANGO_LOG_LEVEL=INFO      # Минимум логов
  - ALLOW_MEDIA_SERVE=False    # Nginx обслуживает медиа
  - HOST_PROJECT_PATH=...      # Путь для sed-замены в конфиге nginx
  - REPO_USER=${REPO_USER}     # Из .env (для Watchtower)
  - REPO_PASS=${REPO_PASS}     # Из .env (для Watchtower)
```

## Health Check

Контейнер имеет healthcheck, который проверяет доступность Django:
- Проверка каждые 3 минуты
- Таймаут: 12 секунд
- Unhealthy после 3 неудачных попыток
- Это критично для Watchtower (он ждет что контейнер станет healthy перед finalization)

## Troubleshooting

### ContainerError при запуске

Проверить логи:
```bash
docker compose -f docker-compose.prod.yml logs web
```

### БД не синхронизируется между перезагрузками

Убедиться что `./database/` правильно монтирует:
```bash
docker compose -f docker-compose.prod.yml exec web ls -la /home/app/database/
```

### Watchtower не обновляет контейнер

Проверить:
- Есть ли интернет на сервере
- Правильны ли REPO_USER и REPO_PASS в .env
- Существует ли образ `oknardia:latest` в реестре

```bash
docker compose -f docker-compose.prod.yml logs watchtower
```

### Nginx конфиг не обновился

Конфиг копируется при старте контейнера. Если нужно пересоздать:
```bash
docker compose -f docker-compose.prod.yml down
docker compose -f docker-compose.prod.yml up -d
```

Потом проверить:
```bash
cat ~/docker-app/oknardia-site/config/nginx/oknardia-app--external-nginx.conf
```

## Резервные копии

Важно регулярно бэкапить:
- `./database/oknardia.sqlite3` - БД
- `./media/` - Загруженные файлы

Пример cronjob для ежедневного бэкапа:
```bash
# /etc/cron.daily/backup-oknardia
#!/bin/bash
BACKUP_DIR="/backup/oknardia"
APP_DIR="/home/default_user/projects/oknardia-site"

mkdir -p $BACKUP_DIR
tar -czf $BACKUP_DIR/oknardia-$(date +%Y%m%d).tar.gz $APP_DIR
find $BACKUP_DIR -name "oknardia-*.tar.gz" -mtime +30 -delete  # Удалять старше 30 дней
```