Pular para conteúdo

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_PROXY quando 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.