75e62b57a1
All checks were successful
CI/CD Pipeline / build-and-deploy (push) Successful in 43s
Unused component that also carried several security issues (default admin credentials, hardcoded Flask secret key, debug mode, plaintext passwords). Cleaned up compose files, CI/CD pipeline, and docs accordingly; also dropped the stale IS_PROD config docs in favor of the current .env-based setup. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
4.7 KiB
4.7 KiB
Инструкция для пользователя
Первая установка на новом сервере
Требования
- Docker и Docker Compose установлены
- Доступ к GitHub репозиторию
Шаг 1: Клонирование репозитория
git clone https://github.com/vrubelroman/LichessStatTgWeb.git
cd LichessStatTgWeb
Шаг 2: Передача базы данных (опционально)
Если у вас есть бэкап базы данных с другого сервера:
# Скопируйте файл базы на сервер
cp /path/to/backup.db LichessClientTG_bot/data/lichess_bot.db
Или импортируйте через скрипт:
chmod +x import_db.sh
./import_db.sh /path/to/backup.db
Шаг 3: Запуск
chmod +x start.sh
./start.sh
Скрипт автоматически:
- Остановит существующие контейнеры (если есть)
- Создаст бэкап базы данных
- Пересоберет Docker образы
- Запустит оба сервиса
Шаг 4: Проверка
Откройте в браузере:
- API документация: http://localhost:8001/docs
Проверьте логи:
docker logs lichess-telegram-bot -f
Обновление до новой версии
Шаг 1: Создайте бэкап (рекомендуется)
chmod +x export_db.sh
./export_db.sh
Это создаст копию базы в папке backups/.
Шаг 2: Обновите код
cd /path/to/LichessStatTgWeb
git pull
Шаг 3: Перезапустите сервисы
./start.sh
Важно: start.sh НЕ удалит вашу базу данных. Она останется в LichessClientTG_bot/data/.
Шаг 4: Проверка
Проверьте что все контейнеры запущены:
docker ps | grep lichess
Работа с бэкапами
Экспорт базы данных
./export_db.sh
Создает файл в backups/export_lichess_bot_YYYYMMDD_HHMMSS.db
Импорт базы данных
./import_db.sh backups/export_lichess_bot_20251028_123456.db
Автоматически создаст бэкап текущей базы перед импортом.
Просмотр логов
Все сервисы
docker-compose logs -f
Только бот
docker logs lichess-telegram-bot -f
Только API
docker logs lichess-api -f
Остановка и удаление
Остановка без удаления данных
docker-compose down
База данных остается.
Полное удаление (с данными!)
docker-compose down -v # ОПАСНО! Удалит volumes
rm -rf LichessClientTG_bot/data/ # Удалит базу данных
Перенос на другой сервер
На старом сервере:
./export_db.sh
# Скопируйте файл из backups/ на новый сервер
На новом сервере:
git clone https://github.com/vrubelroman/LichessStatTgWeb.git
cd LichessStatTgWeb
chmod +x import_db.sh start.sh
./import_db.sh /path/to/backup.db
./start.sh
Устранение проблем
Порт уже занят
Ошибка: bind: address already in use
Решение:
# Найдите процесс на порту
sudo fuser -k 8001/tcp # Для API
# Перезапустите
./start.sh
Контейнер не запускается
# Проверьте логи
docker logs lichess-telegram-bot
# Удалите и пересоздайте
docker-compose down
docker-compose build --no-cache
./start.sh
База данных повреждена
# Восстановите из бэкапа
./import_db.sh backups/export_lichess_bot_YYYYMMDD_HHMMSS.db
Структура проекта
LichessStatTgWeb/
├── LichessWebServices/ # API сервис
├── LichessClientTG_bot/ # Telegram бот
│ └── data/
│ └── lichess_bot.db # База данных (НЕ в git!)
├── backups/ # Бэкапы БД (НЕ в git!)
├── docs/ # Документация
├── docker-compose.yml # Конфигурация Docker
├── start.sh # Скрипт запуска
├── export_db.sh # Экспорт БД
└── import_db.sh # Импорт БД