Системные требования PanDev Metrics on-prem
PanDev Metrics on-prem поставляется как самодостаточный стек — backend, workspace и PostgreSQL 16, — который вы запускаете из архива дистрибутива через Docker Compose или встроенный Helm-чарт. По умолчанию всё работает на одном хосте; для крупных установок базу можно вынести на отдельный хост или managed-сервис. На этой странице — параметры железа, поддерживаемые ОС, базовый набор CPU-инструкций и обязательные версии ПО.
Кратко
| Параметр | Значение |
|---|---|
| Топология | По умолчанию один хост (база в комплекте); внешняя/managed-база — опционально |
| Варианты deployment | Docker Compose или Kubernetes 1.28+ |
| Семейство ОС | Linux — x86_64 или arm64 |
| База данных | PostgreSQL 16 (в комплекте); поддерживается и 17 |
| Порт API backend | 8080 |
| Порт workspace UI | 8090 |
| Порт actuator (внутренний) | 9090 |
Железо
Поставляемый Docker Compose-стек запускает backend, workspace и PostgreSQL на одном хосте, поэтому закладывайтесь на суммарную нагрузку. Два профиля ниже позволяют отдельно оценить требования приложения и базы — это полезно, когда вы выносите базу на отдельный хост или managed-инстанс для продакшена.
Компоненты приложения (server + workspace)
| Компонент | Минимум | Рекомендуется |
|---|---|---|
| CPU | 4 ядра | 8 ядер |
| RAM | 8 GB | 16 GB |
| Диск | 30 GB | 50 GB SSD |
PostgreSQL
| Компонент | Минимум | Рекомендуется |
|---|---|---|
| CPU | 8 ядер | 16 ядер |
| RAM | 12 GB | 24 GB |
| Диск | 50 GB | 100 GB SSD |
Рост диска зависит от количества инженеров, интеграций и срока хранения. Закладывайте запас, если планируете подключить Jira, несколько Git-провайдеров и большой парк IDE-плагинов.
CPU и архитектура
Backend публикуется как нативный образ GraalVM, скомпилированный заранее под конкретную архитектуру CPU. Поэтому дистрибутив поставляет два варианта образа — выбирайте тот, что подходит вашему хосту:
| Архитектура | Тег образа | Примечания |
|---|---|---|
| x86_64 / amd64 | по умолчанию (например, :5.8.0) | Требует базовый набор инструкций ниже |
| arm64 | суффикс -arm (например, :5.8.0-arm) | Нативная arm64-сборка, включая Apple Silicon |
На x86_64 нативный backend требует современный набор инструкций. CPU хоста (и любой слой виртуализации перед ним) должен предоставлять:
CX8, CMOV, FXSR, MMX, SSE, SSE2, SSE3, SSSE3,
SSE4_1, SSE4_2, POPCNT, LZCNT, AVX, AVX2, BMI1, BMI2, FMA
Проверить на кандидате-хосте x86_64:
lscpu | grep -E "avx|avx2|fma|sse4"
Если этих инструкций нет — обычно потому, что их маскирует гипервизор, — нативный backend падает на старте с Illegal instruction. На хостах arm64 используйте теги образов -arm; список x86_64-инструкций выше к ним не применяется.
Настройки виртуализации
Если x86_64-backend не стартует на виртуальной машине, гипервизор скорее всего маскирует нужные нативному образу GraalVM CPU-инструкции. Пробросьте 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, также работают — как на x86_64, так и на arm64. Windows Server не поддерживается.
ПО
| Компонент | Требуется |
|---|---|
| PostgreSQL | 16 (в комплекте); поддерживается и 17 |
| Docker Engine | ≥ 20.10 |
| Docker Compose | ≥ v2.0 (рекомендуется v2.20+) |
| Kubernetes | ≥ 1.28 (путь Helm) |
| Helm | 3.x (путь Helm) |
PostgreSQL 16 входит в дистрибутив, поэтому отдельно его устанавливать не нужно — кроме случая, когда вы выбираете внешнюю базу. Backend совместим и с PostgreSQL 16, и с 17 — используйте 17, если на этой версии работает ваша внешняя или managed-база. Внешний кэш (например, Redis) не входит в дистрибутив и не требуется — backend кеширует сессии и rate-limit во внутренней памяти.
Сеть
Входящие и исходящие требования к сети документированы отдельно в Сеть и порты. Кратко:
- Публичный вход на 8080 (API backend) и 8090 (workspace UI) — или 443 за reverse proxy
- Внутренний вход на 9090 для actuator (health и метрики)
- PostgreSQL на 5432 — публикуется на хост поставляемым Compose-файлом; для не-локальных установок забиндите на localhost или закройте на firewall
- Исходящий 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