Системные требования PanDev Metrics on-prem
PanDev Metrics on-prem ставится на два Linux-хоста: application-хост для backend и frontend, плюс отдельный database-хост для PostgreSQL 17. На этой странице — минимальные и рекомендуемые параметры железа, поддерживаемые ОС и обязательные версии ПО.
Кратко
| Параметр | Значение |
|---|---|
| Топология | Два хоста: application + database |
| Варианты deployment | Docker Compose или Kubernetes |
| Семейство ОС | Linux (x86_64) |
| База данных | PostgreSQL 17 |
| Порт backend по умолчанию | 8080 |
| Порт actuator | 9090 |
Железо
PanDev Metrics on-prem выигрывает от вынесения базы на отдельную машину. Application-хост остаётся небольшим и stateless; database-хост несёт основную нагрузку по CPU, памяти и диску.
Application-хост (backend + frontend)
| Компонент | Минимум | Рекомендуется |
|---|---|---|
| CPU | 4 ядра | 8 ядер |
| RAM | 8 GB | 16 GB |
| Диск | 30 GB | 50 GB SSD |
Database-хост (PostgreSQL 17)
| Компонент | Минимум | Рекомендуется |
|---|---|---|
| CPU | 8 ядер | 16 ядер |
| RAM | 12 GB | 24 GB |
| Диск | 50 GB | 100 GB SSD |
Рост диска зависит от количества инженеров, интеграций и срока хранения. Закладывайте запас, если планируете подключить Jira, несколько Git-провайдеров и большой парк IDE-плагинов.
Требования к инструкциям CPU
PanDev Metrics требует современные x86_64-инструкции. CPU хоста (и любой слой виртуализации перед ним) должен предоставлять:
CX8, CMOV, FXSR, MMX, SSE, SSE2, SSE3, SSSE3,
SSE4_1, SSE4_2, POPCNT, LZCNT, AVX, AVX2, BMI1, BMI2, FMA
Проверить на кандидате-хосте:
lscpu | grep -E "avx|avx2|fma|sse4"
ARM-процессоры (включая Apple Silicon) не поддерживаются. Application-хост запускайте на x86_64-железе или x86_64-виртуальной машине.
Настройки виртуализации
Если PanDev Metrics не стартует на виртуальной машине — гипервизор скорее всего скрывает нужные CPU-инструкции. Сопоставьте платформу с настройкой ниже.
| Платформа | Настройка |
|---|---|
| Proxmox VE | cpu: host в конфиге VM |
| VMware ESXi | VM compatibility 7.0+, CPU passthrough |
| VirtualBox | Включите VT-x, Nested VT-x, PAE/NX. Команда: VBoxManage modifyvm "VM" --cpu-profile host |
| Hyper-V | VM generation 2, отключите CPU compatibility mode |
| XCP-ng / XenServer | CPU mode host-passthrough |
| QEMU / KVM | -cpu host или явные флаги +avx2,+fma,+bmi2 |
Операционная система
PanDev Metrics on-prem работает на любом современном Linux-дистрибутиве, в котором есть поддерживаемая версия Docker Engine.
| Дистрибутив | Тестируемые версии |
|---|---|
| Ubuntu Server | 22.04 LTS, 24.04 LTS |
| Debian | 11 (bullseye), 12 (bookworm) |
| RHEL / Rocky / AlmaLinux | 8, 9 |
| SUSE Linux Enterprise Server | 15 SP4+ |
Другие Linux-дистрибутивы, удовлетворяющие требованиям по ядру и Docker, также работают. Windows Server и macOS не поддерживаются.
ПО
| Компонент | Требуется |
|---|---|
| PostgreSQL | 17 |
| Docker Engine | ≥ 20.10 |
| Docker Compose | ≥ v2.0 (рекомендуется v2.20+) |
| Kubernetes | ≥ 1.28 |
PostgreSQL 17 — единственная поддерживаемая мажорная версия. Более ранние мажоры не тестируем. Redis 7 опционален: в режиме single-node on-prem он не нужен — backend кеширует сессии и rate-limit во внутренней памяти. Подключайте Redis, если хочется горизонтально масштабировать сессии или вынести rate-limit за пределы инстанса.
Сеть
Входящие и исходящие требования к сети документированы отдельно в Сеть и порты. Кратко:
- Публичный вход на 8080 (или 443 за reverse proxy)
- Внутренний вход на 9090 для actuator (health и метрики)
- Внутренний PostgreSQL на 5432 (Redis на 6379 — только если он подключён)
- Исходящий HTTPS до подключённых Git-провайдеров и таск-трекеров (egress минимальный и отключить нельзя)
Браузеры
Frontend PanDev Metrics — современный React single-page application. Поддерживаются актуальные версии Chrome, Edge, Firefox и Safari. Целимся в последние две мажорные версии каждого браузера.
Ограничения и edge-кейсы
- Одна организация на инсталляцию. В on-prem multi-tenant разделения нет. Одна установка = одна организация.
- Air-gapped развёртывания не поддерживаются. Для интеграций нужен минимальный исходящий доступ.
- Горизонтальное масштабирование backend не входит в on-prem-дистрибутив. Один backend-инстанс на инсталляцию; путь — вертикальное масштабирование через более мощные хосты.
Связанные материалы
- How-to: Установка PanDev Metrics on-prem
- Reference: Сеть и порты
- Концепция: Архитектура on-prem