Kubernetes (Helm)¶
Chart em deploy/helm/quantix-vision (Kubernetes ≥ 1.25).
helm install qv deploy/helm/quantix-vision -n quantix --create-namespace \
--set global.publicUrl=https://quantix.empresa.local \
--set ingress.hosts[0]=quantix.empresa.local \
--set ingress.tls.secretName=quantix-tls
As instruções pós-instalação (NOTES.txt) mostram como ler a senha inicial e a chave mestra:
kubectl -n quantix get secret qv-quantix-vision-secrets -o jsonpath="{.data.QV_ADMIN_PASSWORD}" | base64 -d
kubectl -n quantix get secret qv-quantix-vision-secrets -o jsonpath="{.data.QV_MASTER_KEY}" | base64 -d
O nome é <release>-quantix-vision-secrets (para o release qv: qv-quantix-vision-secrets) ou o de secrets.existingSecret. O Secret tem helm.sh/resource-policy: keep e
sobrevive ao helm uninstall.
Componentes¶
| Recurso | Valores |
|---|---|
| API (Deployment) | api.replicas: 2, api.workers: 4, PDB minAvailable: 1 |
| Ingestor | ingestor.replicas: 2, PDB, HPA opcional (ingestor.autoscaling.enabled, 2–8 réplicas, CPU 70 %) |
| Engine | engine.replicas: 1, estratégia Recreate (veja HA) |
| Automação | automation.enabled, PVC de 10 Gi |
| Coletores | lista collectors[] (o primeiro usa o token padrão do Secret) |
| Web | web.replicas: 2, certificado interno (o Ingress fala HTTPS com o nginx) |
| Ingress | ingress.className: nginx, backend-protocol: HTTPS, proxy-body-size: 200m |
| PostgreSQL / ClickHouse / NATS | *.mode: bundled (StatefulSet do chart) ou external |
| Rede e monitoramento | networkPolicy.enabled: true (ingress controller e Prometheus autorizados; egressCIDRs), serviceMonitor.enabled (prometheus-operator) |
| Segurança | runAsNonRoot (UID 10001), readOnlyRootFilesystem, seccompProfile: RuntimeDefault, capabilities.drop: [ALL] |
Segredos¶
Por padrão, o chart gera senhas e chaves na primeira instalação e as preserva nos upgrades
(lookup do Secret existente). Para GitOps, crie o Secret antes e informe
secrets.existingSecret, com as chaves QV_MASTER_KEY, QV_JWT_SECRET, QV_ADMIN_PASSWORD,
QV_COLLECTOR_TOKEN, POSTGRES_PASSWORD, CLICKHOUSE_PASSWORD, NATS_PASSWORD e opcionalmente QV_PG_DSN.
Bancos externos (recomendado em produção)¶
postgresql:
mode: external
external: { host: pg.empresa.local, port: 5432, dsn: "postgresql+asyncpg://quantix:senha@pg.empresa.local:5432/quantix?ssl=require" }
clickhouse:
mode: external
external: { host: "ch-s1r1,ch-s1r2,ch-s2r1,ch-s2r2", port: 8123, secure: false, cluster: qv_cluster }
nats:
mode: external
external: { url: "nats://nats-1:4222,nats://nats-2:4222,nats://nats-3:4222" }
Validação: make lint-helm (helm lint e helm template).