🚀 Добавлен мастер-скрипт развертывания с полной автоматизацией
Some checks failed
continuous-integration/drone/push Build is failing

 Новые возможности:
- Мастер-развертывание с автоматической настройкой всех компонентов
- Генерация безопасных .env файлов с криптографически стойкими ключами
- Полная изоляция и защита PostgreSQL
- Автоматическая настройка Let's Encrypt SSL
- Система backup и мониторинга
- Comprehensive security audit для БД

🔧 Новые команды:
- make deploy - мастер-развертывание
- make pre-deploy-check - проверка готовности системы
- make security-audit - аудит безопасности PostgreSQL
- make ssl-setup - интерактивная настройка SSL
- make update-production-security - безопасное обновление в продакшене

📁 Новые файлы:
- scripts/master-deploy.sh - основной скрипт развертывания
- scripts/pre-deploy-check.sh - проверка системы
- scripts/ssl-manager.sh - управление SSL сертификатами
- scripts/audit-db-security.sh - аудит безопасности БД
- DEPLOYMENT.md - полное руководство по развертыванию
- COMMANDS.md - справочник команд
- SECURITY.md - документация по безопасности

🔒 Улучшения безопасности:
- Изоляция PostgreSQL в Docker сети (без внешних портов)
- SCRAM-SHA-256 аутентификация
- TLSv1.3 для БД соединений
- Удаление прав суперпользователя у приложения
- Детальное логирование всех операций БД
- Security headers в nginx
- Автообновление SSL сертификатов
This commit is contained in:
2025-11-04 14:07:58 +09:00
parent 735c1984f9
commit e1bb1ab90a
7 changed files with 1933 additions and 22 deletions

186
COMMANDS.md Normal file
View File

@@ -0,0 +1,186 @@
# 🚀 CatLink Commands Quick Reference
## 📋 Основные команды
### Развертывание
```bash
make deploy # Мастер-развертывание (полная настройка)
make pre-deploy-check # Проверка готовности системы
make deploy-simple # Простое развертывание без мастер-настройки
```
### Разработка
```bash
make install # Первая установка
make dev # Режим разработки
make build # Сборка контейнеров
make up # Запуск сервисов
make down # Остановка сервисов
make restart # Перезапуск
```
### База данных
```bash
make migrate # Применить миграции
make makemigrations # Создать миграции
make superuser # Создать суперпользователя
```
### Безопасность
```bash
make security-audit # Аудит безопасности PostgreSQL
make security-setup # Настройка безопасности БД
make update-production-security # Безопасное обновление в продакшене
```
### SSL/TLS
```bash
make ssl-setup # Интерактивная настройка SSL
make ssl-renew # Обновление сертификатов
```
### Мониторинг и диагностика
```bash
make status # Статус сервисов
make health # Проверка здоровья
make logs # Просмотр логов
make monitor # Мониторинг ресурсов
```
### Тестирование
```bash
make test # Запуск тестов
make lint # Проверка кода
make format # Форматирование кода
```
### Обслуживание
```bash
make backup # Создать backup
make restore # Восстановить из backup
make clean # Очистка (containers, images)
make clean-all # Полная очистка (+ volumes, data)
make reset # Сброс к заводским настройкам
```
## 🔧 Полезные скрипты
### Прямое выполнение
```bash
./scripts/master-deploy.sh # Мастер-развертывание
./scripts/pre-deploy-check.sh # Проверка системы
./scripts/ssl-manager.sh # Управление SSL
./scripts/audit-db-security.sh # Аудит безопасности БД
./scripts/health-check.sh # Проверка здоровья
./scripts/auto-backup.sh # Создание backup
```
## 🌐 URL-адреса (по умолчанию)
### Разработка
- **Frontend:** http://localhost:3000
- **Backend API:** http://localhost:8000/api/
- **Admin:** http://localhost:8000/admin/
### Продакшен
- **Site:** https://your-domain.com
- **Admin:** https://your-domain.com/admin/
## 📁 Важные файлы
### Конфигурация
- `.env` - переменные окружения
- `docker-compose.yml` - основная конфигурация
- `docker-compose.prod.yml` - продакшен overrides
- `Makefile` - команды автоматизации
### Безопасность
- `database/postgresql.conf` - конфигурация PostgreSQL
- `database/pg_hba.conf` - настройки аутентификации
- `SECURITY.md` - руководство по безопасности
### Документация
- `README.md` - основная документация
- `DEPLOYMENT.md` - руководство по развертыванию
- `COMMANDS.md` - этот файл
### Backup и логи
- `backups/` - резервные копии
- `logs/` - логи системы
## 🚨 Экстренные команды
### Быстрое восстановление
```bash
# Перезапуск всех сервисов
make restart
# Пересборка и перезапуск
make build && make up
# Проверка логов при проблемах
make logs
# Полная очистка и переустановка
make clean-all && make install
```
### Восстановление из backup
```bash
# База данных
docker exec -i links-db-1 psql -U postgres links_db < backups/database/backup_YYYYMMDD.sql
# Файлы
tar -xzf backups/files/media_YYYYMMDD.tar.gz
```
### Диагностика проблем
```bash
# Проверка контейнеров
docker ps -a
# Проверка ресурсов
docker stats
# Проверка сетей
docker network ls
# Проверка volumes
docker volume ls
```
## 🔄 Обновление проекта
### Стандартное обновление
```bash
git pull
make restart
```
### Обновление с миграциями
```bash
git pull
make down
make build
make up
make migrate
```
### Безопасное обновление продакшена
```bash
make update-production-security
```
## 💡 Подсказки
1. **Всегда проверяйте статус** перед началом работы: `make status`
2. **Используйте pre-deploy-check** перед развертыванием: `make pre-deploy-check`
3. **Регулярно делайте backup**: `./scripts/auto-backup.sh`
4. **Мониторьте безопасность**: `make security-audit`
5. **Проверяйте логи** при проблемах: `make logs`
## 📞 Поддержка
- **Issues:** https://github.com/smartsoltech/links/issues
- **Документация:** README.md, DEPLOYMENT.md, SECURITY.md
- **Команды:** `make help`