@dev-pro.server — Документация

Версия: 2.0.0
Дата: 2025-12-01
Роль: Control Plane сервер для управления DevOps инфраструктурой
Сервер: 91.218.142.168 (xirfbwpmvt)
Тип: Infrastructure project
Статус: Производственная система ✅

📚 Быстрая навигация

Основные документы

Проектирование:
- design/PROJECT.md — описание проекта, назначение, роль
- design/ARCHITECTURE.md — архитектура, компоненты, ADR

Управление:
- management/README.md — быстрый старт, основные команды
- management/TODO.md — задачи и статус выполнения

Инфраструктура:
- infrastructure/SERVER.md — характеристики сервера, SSH, безопасность

Решения:
- solution/scripts/LOCATION.md — скрипты управления инфраструктурой

🎯 Назначение

DEV-PRO — центральный узел управления для всей инфраструктуры через Claude Code.

Ключевые факты:
- Сервер НЕ используется для хостинга приложений
- Только для координации и управления
- SSH доступ настроен к управляемым серверам
- Минимальные ресурсы (2 cores, 2GB RAM)
- Работа из-под root пользователя

🔑 SSH доступ

К этому серверу

ssh root@91.218.142.168

Аутентификация: SSH key only (пароль отключён)

К управляемым серверам

# SSH ключ
~/.ssh/id_ed25519

# DEV-PROD-RF (45.144.177.147)
ssh root@45.144.177.147

# Тест подключения
ssh root@45.144.177.147 "hostname"

🖥️ Управляемые серверы

DEV-PROD-RF (45.144.177.147)

Доступ: ssh root@45.144.177.147
SSH Key: Настроен (passwordless)
Роль: Dev+Prod Platform
- 34 Docker контейнера в 7 стеках
- seller1.ru 🔴 PRODUCTION сервис 24/7
Проект: $WORKSPACE/infra/@dev-prod-rf.server/

🚀 Типичные задачи

Проверка состояния инфраструктуры

cd $WORKSPACE/infra/@dev-pro.server/solution/scripts/
./check-infra.sh

Что проверяет:
- DEV-PRO: uptime, CPU, RAM, disk, Docker
- SSH к DEV-PROD-RF
- DEV-PROD-RF: ресурсы, 34 контейнера
- seller1.ru: доступность (HTTP 200)

Подключение к управляемому серверу

cd $WORKSPACE/infra/@dev-pro.server/solution/scripts/
./connect-to-dev-prod-rf.sh

# Или напрямую
ssh root@45.144.177.147

Backup критичных данных

cd $WORKSPACE/infra/@dev-pro.server/solution/scripts/
./backup.sh

Что бэкапится:
- SSH ключи
- Claude workspace
- Системные конфиги

Хранение: /var/backups/dev-pro/
Автоматизация: Cron (воскресенье 03:00)

📁 Важные пути

/root/                        # Home directory
├── .ssh/                     # SSH ключи
│   └── id_ed25519           # Ключ для DEV-PROD-RF

$WORKSPACE/        # Claude Code workspace
├── pirotehnika/             # Бизнес: пиротехника
├── lider/                   # Бизнес: Лидер Авто
├── seller1/                 # Бизнес: Seller1
├── infra/                   # Инфраструктура
│   ├── @dev-pro.server/    # Этот проект
│   └── @dev-prod-rf.server/# Управляемый сервер
├── architect/               # Методология
└── system/                  # Агенты

/var/log/                     # Логи
├── auth.log                  # SSH логи
└── dev-pro-backup.log       # Логи backup

/var/backups/dev-pro/         # Backup архивы

🔒 Безопасность

Firewall (UFW): Активен
- Port 22 (SSH) — ALLOW

fail2ban: Running
- Защита SSH от брутфорса

SSH:
- Аутентификация только по ключу
- Пароль отключён

🛠️ Мониторинг

Ресурсы

htop              # Интерактивный мониторинг
free -h           # Память
df -h             # Диск
uptime            # Аптайм и нагрузка

Логи

tail -f /var/log/auth.log                              # SSH логи
journalctl -f                                          # Системные логи
grep "Failed password" /var/log/auth.log | tail -20   # Неудачные входы

Сервисы

systemctl status docker
systemctl status fail2ban
systemctl status ssh

❌ Что НЕ делать

• ❌ Запускать Docker контейнеры (это Control Plane)
• ❌ Размещать production приложения
• ❌ Использовать для высоко-ресурсных задач
• ❌ Устанавливать базы данных

✅ Что ВСЕГДА делать

• ✅ Использовать SSH для управления удалёнными серверами
• ✅ Проверять SSH connectivity перед выполнением команд
• ✅ Мониторить логи при troubleshooting
• ✅ Держать систему обновлённой
• ✅ Использовать proper SSH key authentication

🔗 Связанные проекты

• @dev-prod-rf.server — управляемый Production Platform (45.144.177.147)
• seller1/ — бизнес-проект

📖 Дополнительная информация

Подробная документация:
- design/PROJECT.md — полное описание проекта
- design/ARCHITECTURE.md — архитектура с ADR
- management/README.md — команды и процедуры
- infrastructure/SERVER.md — детали сервера

Статус: ✅ Производственная система
Дата создания: 2025-10-26
Последнее обновление: 2025-12-01