Ansible¶
O diretório deploy/ansible/ instala e opera a plataforma de forma repetível em RHEL/Rocky/Alma/Oracle Linux 8/9, SLES/openSUSE Leap 15
e Ubuntu 22.04/24.04.
O instalador gera o inventário e chama estes playbooks; use-os diretamente quando quiser integrar a implantação ao seu próprio inventário ou pipeline.
| Playbook | Função |
|---|---|
site.yml |
verificações (role preflight) → Docker + tuning de kernel (role docker) → plataforma (role quantix) → agenda de backup (role backup; não em cluster ClickHouse) |
preflight.yml |
somente as verificações (sistema, recursos, portas, DNS, NTP, Docker, acesso de saída); não altera o servidor |
status.yml |
containers, /api/health e HTTPS local |
setup-link.yml |
endereço e token do assistente de primeira execução |
collector.yml |
coletores remotos (role docker sem tuning + role collector) |
backup.yml |
backup sob demanda (opcionalmente copiado para o controlador) |
restore.yml |
restauração (exige -e quantix_restore_confirm=sim) |
upgrade.yml |
backup + troca de versão + reinício em ondas com verificação de saúde |
Variáveis da instalação guiada (role quantix): quantix_image_source (registry, build ou
bundle), quantix_bundle_file, quantix_first_run_wizard (deixa QV_ADMIN_PASSWORD vazio na
primeira geração do .env para o assistente criar o administrador), quantix_cpu_limits (limites de
CPU ajustados ao total do servidor) e quantix_result_file. Role docker: docker_install_mode
(auto, always ou never) e docker_manage (false quando o Docker é administrado por outra equipe).
Inventário¶
inventory/hosts.yml (exemplo):
all:
vars:
ansible_user: ansible
children:
quantix_server:
hosts:
quantix01.empresa.local:
ansible_host: 10.10.0.20
quantix_public_url: https://quantix.empresa.local
quantix_size: medium # small | medium | large
quantix_collectors:
hosts:
coletor-sp.empresa.local:
ansible_host: 10.20.0.15
collector_token: "{{ vault_collector_token_sp }}"
collector_name: coletor-sp
collector_transport: https
Variáveis principais (inventory/group_vars/):
| Variável | Padrão | Descrição |
|---|---|---|
quantix_version, quantix_registry |
8.3.0, quantix |
imagens |
quantix_install_dir |
/opt/quantix |
compose, .env (0600), certificados |
quantix_size |
medium |
perfil de recursos. large usa docker-compose.scale.yml |
quantix_clickhouse_cluster |
false |
usa docker-compose.cluster.yml |
quantix_tls_mode |
self-signed |
ou provided com quantix_tls_cert_src/quantix_tls_key_src |
quantix_secrets.* |
vazios | vazio = gerado no servidor no 1º deploy e preservado depois. Para definir, use ansible-vault |
quantix_env_extra |
{} |
variáveis adicionais no .env |
quantix_backup_dir, quantix_backup_retention_days, quantix_backup_cron |
/var/backups/quantix, 14, 02:30 |
backup local |
docker_data_root, docker_http(s)_proxy, docker_repo_base_url |
— | Docker, proxy, espelho do repositório |
collector_api_url, collector_transport, collector_ca_bundle_src, collector_concurrency, collector_cpus, collector_memory |
— | coletores remotos |
Uso¶
cd deploy/ansible
ansible-playbook site.yml # servidor(es)
ansible-playbook collector.yml --ask-vault-pass # coletores remotos
ansible-playbook backup.yml -e quantix_backup_fetch_dir=./backups
ansible-playbook restore.yml -e quantix_restore_confirm=sim -e quantix_restore_from=20261014-023000
ansible-playbook upgrade.yml -e quantix_version=1.1.0
O resumo final do site.yml mostra a URL e onde ler a senha inicial. Os segredos gerados ficam
somente no .env do servidor: copie QV_MASTER_KEY para um cofre.
Validação: make lint-ansible (ansible-playbook --syntax-check em todos os playbooks e
ansible-lint se instalado).