feat: добавлена Docker инфраструктура для продакшн-развертывания
Добавлено: - Обновлен docker-compose.yml для production (упрощен, удален Redis/pgAdmin) - .env.prod.example - шаблон конфигурации для продакшн - deploy.sh - скрипт автоматического развертывания - DOCKER_DEPLOY.md - полная документация по развертыванию Makefile команды: - docker-setup - первоначальная настройка - docker-build/up/down - управление контейнерами - docker-logs/logs-db - просмотр логов - docker-db-migrate/backup/restore - работа с БД - docker-deploy - полное автоматическое развертывание Использование: 1. make docker-setup (создаст .env.prod) 2. Отредактировать .env.prod 3. make docker-deploy (автоматическое развертывание) Или: ./deploy.sh
This commit is contained in:
281
DOCKER_DEPLOY.md
Normal file
281
DOCKER_DEPLOY.md
Normal file
@@ -0,0 +1,281 @@
|
||||
# 🐳 Docker Deployment Guide
|
||||
|
||||
## Быстрый старт
|
||||
|
||||
### 1. Настройка окружения
|
||||
```bash
|
||||
make docker-setup
|
||||
```
|
||||
|
||||
Отредактируйте `.env.prod` и укажите:
|
||||
- `BOT_TOKEN` - токен от @BotFather
|
||||
- `POSTGRES_PASSWORD` - надежный пароль для БД
|
||||
- `DATABASE_URL` - обновите пароль в строке подключения
|
||||
- `ADMIN_IDS` - ваш Telegram ID
|
||||
|
||||
### 2. Развертывание
|
||||
```bash
|
||||
# Автоматическое развертывание
|
||||
make docker-deploy
|
||||
|
||||
# Или вручную:
|
||||
make docker-build
|
||||
make docker-up
|
||||
make docker-db-migrate
|
||||
```
|
||||
|
||||
### 3. Проверка
|
||||
```bash
|
||||
make docker-status
|
||||
make docker-logs
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Основные команды
|
||||
|
||||
### Управление контейнерами
|
||||
```bash
|
||||
make docker-up # Запустить контейнеры
|
||||
make docker-down # Остановить контейнеры
|
||||
make docker-restart # Перезапустить контейнеры
|
||||
make docker-status # Статус контейнеров
|
||||
```
|
||||
|
||||
### Просмотр логов
|
||||
```bash
|
||||
make docker-logs # Логи бота (с отслеживанием)
|
||||
make docker-logs-db # Логи базы данных
|
||||
make docker-logs-all # Все логи
|
||||
```
|
||||
|
||||
### База данных
|
||||
```bash
|
||||
make docker-db-migrate # Применить миграции
|
||||
make docker-db-shell # Подключиться к PostgreSQL
|
||||
make docker-db-backup # Создать бэкап
|
||||
make docker-db-restore BACKUP=backups/backup_20231115.sql
|
||||
```
|
||||
|
||||
### Разработка
|
||||
```bash
|
||||
make docker-shell # Открыть shell в контейнере бота
|
||||
make docker-rebuild # Пересобрать и перезапустить
|
||||
```
|
||||
|
||||
### Очистка
|
||||
```bash
|
||||
make docker-clean # Удалить контейнеры
|
||||
make docker-prune # Полная очистка (включая volumes)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Структура проекта
|
||||
|
||||
```
|
||||
lottery_bot/
|
||||
├── Dockerfile # Образ бота
|
||||
├── docker-compose.yml # Оркестрация контейнеров
|
||||
├── .env.prod # Продакшн-конфигурация (НЕ коммитить!)
|
||||
├── .env.prod.example # Пример конфигурации
|
||||
├── .dockerignore # Исключения для Docker
|
||||
├── deploy.sh # Скрипт автоматического развертывания
|
||||
├── logs/ # Логи (монтируется из контейнера)
|
||||
├── backups/ # Бэкапы БД
|
||||
└── data/ # Данные приложения
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Архитектура
|
||||
|
||||
### Контейнеры
|
||||
|
||||
**bot** - Telegram бот
|
||||
- Образ: Собирается из `Dockerfile`
|
||||
- Restart: unless-stopped
|
||||
- Зависимости: db
|
||||
- Health check: Python проверка
|
||||
|
||||
**db** - PostgreSQL база данных
|
||||
- Образ: postgres:15-alpine
|
||||
- Restart: unless-stopped
|
||||
- Порты: 5432:5432
|
||||
- Volume: postgres_data
|
||||
- Health check: pg_isready
|
||||
|
||||
### Volumes
|
||||
- `postgres_data` - Данные PostgreSQL (персистентные)
|
||||
- `bot_data` - Данные приложения
|
||||
|
||||
### Networks
|
||||
- `lottery_network` - Внутренняя сеть для связи контейнеров
|
||||
|
||||
---
|
||||
|
||||
## Мониторинг
|
||||
|
||||
### Статус контейнеров
|
||||
```bash
|
||||
docker-compose ps
|
||||
|
||||
# Ожидаемый вывод:
|
||||
# lottery_bot running 0.0.0.0:->
|
||||
# lottery_db running 0.0.0.0:5432->5432/tcp
|
||||
```
|
||||
|
||||
### Логи в реальном времени
|
||||
```bash
|
||||
docker-compose logs -f bot
|
||||
```
|
||||
|
||||
### Использование ресурсов
|
||||
```bash
|
||||
docker stats lottery_bot lottery_db
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Бэкапы
|
||||
|
||||
### Автоматический бэкап
|
||||
```bash
|
||||
# Создать бэкап с временной меткой
|
||||
make docker-db-backup
|
||||
|
||||
# Файл будет сохранен в:
|
||||
# backups/backup_YYYYMMDD_HHMMSS.sql
|
||||
```
|
||||
|
||||
### Восстановление
|
||||
```bash
|
||||
make docker-db-restore BACKUP=backups/backup_20231115_120000.sql
|
||||
```
|
||||
|
||||
### Настройка автоматических бэкапов (cron)
|
||||
```bash
|
||||
# Добавьте в crontab:
|
||||
0 2 * * * cd /path/to/lottery_bot && make docker-db-backup
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Обновление
|
||||
|
||||
### Обновление кода
|
||||
```bash
|
||||
git pull
|
||||
make docker-rebuild
|
||||
```
|
||||
|
||||
### Применение миграций
|
||||
```bash
|
||||
make docker-db-migrate
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Контейнер не запускается
|
||||
```bash
|
||||
# Проверьте логи
|
||||
make docker-logs
|
||||
|
||||
# Проверьте конфигурацию
|
||||
cat .env.prod
|
||||
|
||||
# Пересоберите образ
|
||||
make docker-rebuild
|
||||
```
|
||||
|
||||
### База данных недоступна
|
||||
```bash
|
||||
# Проверьте статус БД
|
||||
docker-compose ps db
|
||||
|
||||
# Проверьте логи БД
|
||||
make docker-logs-db
|
||||
|
||||
# Подключитесь к БД напрямую
|
||||
make docker-db-shell
|
||||
```
|
||||
|
||||
### Проблемы с миграциями
|
||||
```bash
|
||||
# Проверьте текущую версию
|
||||
docker-compose exec bot alembic current
|
||||
|
||||
# Откатите миграцию
|
||||
docker-compose exec bot alembic downgrade -1
|
||||
|
||||
# Примените снова
|
||||
make docker-db-migrate
|
||||
```
|
||||
|
||||
### Высокое потребление ресурсов
|
||||
```bash
|
||||
# Проверьте использование
|
||||
docker stats
|
||||
|
||||
# Ограничьте ресурсы в docker-compose.yml:
|
||||
services:
|
||||
bot:
|
||||
deploy:
|
||||
resources:
|
||||
limits:
|
||||
cpus: '0.5'
|
||||
memory: 512M
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Безопасность
|
||||
|
||||
### Рекомендации
|
||||
|
||||
1. **Пароли**
|
||||
- Используйте надежные пароли в `.env.prod`
|
||||
- Не коммитьте `.env.prod` в Git
|
||||
|
||||
2. **Порты**
|
||||
- Закройте порт 5432 если БД не нужна извне
|
||||
- Используйте firewall для ограничения доступа
|
||||
|
||||
3. **Обновления**
|
||||
- Регулярно обновляйте образы:
|
||||
```bash
|
||||
docker-compose pull
|
||||
make docker-rebuild
|
||||
```
|
||||
|
||||
4. **Логи**
|
||||
- Ротация логов в production
|
||||
- Настройте logrotate для `/home/trevor/new_lottery_bot/logs/`
|
||||
|
||||
5. **Бэкапы**
|
||||
- Автоматические ежедневные бэкапы
|
||||
- Храните бэкапы в безопасном месте
|
||||
|
||||
---
|
||||
|
||||
## Production Checklist
|
||||
|
||||
- [ ] Отредактирован `.env.prod` с реальными значениями
|
||||
- [ ] Установлены надежные пароли
|
||||
- [ ] Настроены автоматические бэкапы
|
||||
- [ ] Настроен мониторинг и алерты
|
||||
- [ ] Настроена ротация логов
|
||||
- [ ] Закрыты неиспользуемые порты
|
||||
- [ ] Протестирован процесс восстановления из бэкапа
|
||||
- [ ] Документированы учетные данные администраторов
|
||||
|
||||
---
|
||||
|
||||
## Полезные ссылки
|
||||
|
||||
- [Docker Documentation](https://docs.docker.com/)
|
||||
- [Docker Compose Documentation](https://docs.docker.com/compose/)
|
||||
- [PostgreSQL Docker Hub](https://hub.docker.com/_/postgres)
|
||||
- [Alembic Documentation](https://alembic.sqlalchemy.org/)
|
||||
Reference in New Issue
Block a user