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 |