architect/_archive/2025-11-26-cleanup/projects-infra-dev-pro/CLAUDE.md

@infra-dev-pro — Документация для Claude Code

Роль: 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
Проект: /opt/claude-workspace/projects/@infra-dev-prod-rf/


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

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

cd /opt/claude-workspace/projects/@infra-dev-pro/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 /opt/claude-workspace/projects/@infra-dev-pro/solution/scripts/
./connect-to-dev-prod-rf.sh

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

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

cd /opt/claude-workspace/projects/@infra-dev-pro/solution/scripts/
./backup.sh

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

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


📁 Важные пути

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

/opt/claude-workspace/        # Claude Code workspace
├── platform/                 # Ядро системы
├── templates/                # Шаблоны
├── projects/
   ├── @infra-dev-pro/      # Этот проект
   ├── @infra-dev-prod-rf/  # Управляемый сервер
   └── marketplace/
└── archive/

/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

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

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


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


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

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


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