Pular para conteúdo

Linha de comando (quantix)

Um único executável (entrada quantix = quantix.cli:main) atende todos os serviços. Na imagem, é o ENTRYPOINT (tini -g -- quantix) e o subcomando é o command do container.

Subcomando Opções Função
quantix api --host (0.0.0.0), --port (8000), --workers (QV_API_WORKERS, padrão 2) API REST (uvicorn, proxy_headers) + bootstrap. Com QV_EMBEDDED_WORKERS=true, também ingestor e engine
quantix collector — coletor (usa QV_API_URL, QV_COLLECTOR_TOKEN, QV_COLLECTOR_NAME, QV_COLLECTOR_TRANSPORT)
quantix ingestor — consumidores do JetStream (métricas e inventário)
quantix engine — engine de análise, alertas e resumo diário
quantix automation — executor de runbooks Ansible aprovados
quantix demo-seed --days (14), --arrays (2), --hosts (40), --step (900 s) cria dispositivos simulados e grava histórico. No chdb, exige a API parada
quantix reset-admin --username (admin) redefine a senha (temporária, impressa), torna a conta local e ativa, desbloqueia e exige troca

Exemplos:

docker compose exec api quantix reset-admin --username admin
docker compose run --rm --no-deps api demo-seed --days 30      # produção (ClickHouse servidor)
quantix api --port 8000 --workers 1                             # desenvolvimento

Os processos usam uvloop quando instalado. O log segue QV_LOG_LEVEL/QV_LOG_JSON.

Instalador

Comando Uso
./install.sh [install] [-a respostas.yml] [-y] [-K] [--force] [-v] instala ou reaplica (Instalador)
./install.sh preflight · status · setup-link · upgrade verificações, estado, link do assistente, atualização
./install.sh bundle [-o dir] pacote offline (imagens + instalador + pacotes do Ansible)
./install.sh answers [-o arquivo] arquivo de respostas de exemplo

Scripts auxiliares

Script Uso
deploy/scripts/gen-env.py [-t .env.example] [-o .env] [--set CHAVE=valor] gera/atualiza o .env
deploy/scripts/quantix-backup.sh [-d dir] [-o destino] [-r dias] [-m native\|freeze] [-f arquivos compose] backup
deploy/scripts/quantix-restore.sh -b <backup> [-d dir] [-f arquivos compose] [-y] restauração
backend/tools/benchmark/scale_benchmark.py [--rows N] [--pg-dsn DSN] [--skip-ch] benchmark de escala
docs/gen_reference.py, docs/gen_api.py [--refresh] páginas de referência da documentação