Pular para conteúdo

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).