Pular para conteúdo

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