186 lines
5.8 KiB
Markdown
186 lines
5.8 KiB
Markdown
# 🚀 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` |