Necromante Absoluto

Como configurar o necromante absoluto no seu projeto

Você vai precisar baixar o pacote e extraí-lo na pasta raiz do seu servidor antes de qualquer coisa. Eu tentei rodar sem isso na primeira vez e o serviço simplesmente não iniciava, sem erro nenhum no log. Gastei uns 40 minutos pra descobrir que o diretório de configuração tava vazio porque o instalador tinha falhado silenciosamente. O download fica disponível no repositório oficial. A versão atual é a 3.2.1 e exige Java 17 mínimo. Se você tiver Java 11 instalado, a instalação passa mas o processo trava na inicialização dos workers. Copiei o arquivo pro diretório /opt/necromante, dei permissão de execução no script start.sh e rodei. O primeiro problema que eu encontrei foi com a conexão ao banco. O padrão é PostgreSQL 14, mas meu ambiente usava 13. A migracao automatica falhava na terceira tabela porque o tipo JSONB tinha comportamento diferente na versao mais velha. A solucao foi subir o DB pro 14 antes de rodar o setup, ou aplicar os DDLs manualmente um por um se quiser manter a versao antiga.

Outro ponto que as docs nao mencionam: o processo consome cerca de 800MB de memoria so pra iniciar. Se voce estiver em um container com limite de 1GB, ele vai ser killing pelo OOM killer sem aviso. Coloquei o flag -Xmx512m no startup e funcou, mas ai o tempo de resposta dobrava em queries mais pesadas. O ideal é dar pelo menos 2GB reservados. Para configurações avançadas, edite o arquivo necromante.yml na pasta config. A seção workers controla paralelismo. Mudei de 4 para 8 threads e o throughput subiu de 120 requisições por segundo para cerca de 210, mas o uso de CPU ficou em 95% constante. Para produção, recomendo deixar no padrão e escalar horizontalmente em vez de estocar threads. O sistema tem um endpoint de health check em localhost:8080/health. Rode isso apos o inicio pra confirmar que ta tudo ok. Se retornar {status: "degraded"}, verifica o log em /var/log/necromante/app.log. A maioria dos problemas iniciais aparece ali nos primeiros 30 segundos depois do boot.

Se voce precisar de suporte, o repositório tem issues abertas com workarounds para os cenários mais comuns. A comunidade é pequena mas ativa, e respuestas geralmente chegam em até 48 horas. Evita postar questions genéricas como "nao funciona" — inclui versao, log relevante e passos pra reproduzir.