Requisitos¶
Caminho recomendado
O instalador (./install.sh) confere estes requisitos automaticamente
(preflight) antes de alterar o servidor.
Software¶
| Item | Versão |
|---|---|
| Sistema operacional (host) | Linux x86-64. Ansible suporta RHEL/Rocky/Alma/Oracle Linux 8/9, Ubuntu 22.04/24.04 e SLES/openSUSE Leap 15 |
| Docker Engine + Compose v2 | Compose com suporte a !override e extends (Docker Compose 2.24+) |
| Kubernetes (opcional) | ≥ 1.25, Helm 3 |
| Navegador | Chrome, Edge ou Firefox atuais |
| Imagens | quantix/quantix-vision-backend:8.3.0 (e -lab), quantix/quantix-vision-web:8.3.0, postgres:16, clickhouse/clickhouse-server:24.8, clickhouse/clickhouse-keeper:24.8 (cluster), nats:2.10-alpine; opcionais: ollama/ollama:0.5.4 (IA local), edoburu/pgbouncer:v1.23.1-p3, boky/postfix:v4.1.0 (e-mail interno) |
As imagens da plataforma são construídas com make build / make build-lab (Dockerfiles em
backend/ e frontend/) e publicadas no seu registro (QV_REGISTRY). Ambientes sem internet
podem espelhar as imagens de infraestrutura em um registro interno (QV_POSTGRES_IMAGE,
QV_CLICKHOUSE_IMAGE, QV_NATS_IMAGE).
Imagens
As imagens 8.3.0 do backend e da interface são construídas pelo instalador (image_source: build)
ou vêm no pacote offline. Para construir no seu próprio pipeline, use make build e make lint.
Hardware¶
| Porte | Referência | Host único (total) |
|---|---|---|
| Laboratório | simulador, até 2 arrays | 2 vCPU, 8 GB, 20 GB |
| Pequeno | ≤ 10 arrays, 2 mil portas, 2 mil VMs | 8 vCPU, 32 GB, 0,6 TB SSD |
| Médio | ≤ 40 arrays, 10 mil portas, 10 mil VMs | 32 vCPU, 96 GB, 2,2 TB NVMe |
| Grande | 100 arrays / 150 PB, 30 mil portas, 25 mil VMs | 64–80 vCPU, 256 GB, 5,5 TB NVMe (ou ClickHouse dedicado/cluster) |
Detalhamento por componente, medições e premissas: Escalabilidade e sizing.
Ajustes de kernel recomendados (aplicados pela role Ansible docker): vm.max_map_count=262144,
vm.swappiness=1, nofile=262144, Transparent Huge Pages em madvise.
Rede¶
- Usuários → servidor: 443/TCP (e 80, que redireciona).
- Coletor → dispositivos: portas de gerência de cada plataforma (443, 8443, 8080, 8088, 8452, 9440, 22…). Veja Portas e firewall.
- Coletor remoto → servidor: 443/TCP (transporte HTTPS).
- Servidor → saída (opcional): provedor de IA, SMTP, Teams/Slack/ServiceNow, LDAP/AD. Use
QV_HTTPS_PROXY/QV_NO_PROXYquando houver proxy corporativo. - DNS e certificado TLS para o nome público (ou certificado autoassinado gerado por
make certs).
Contas nos dispositivos¶
Uma conta somente leitura por plataforma, conforme Plataformas suportadas.