// design

Inventário de infraestrutura e portal de CMDB

Um portal web interno com visibilidade sobre a frota de VMs Linux: inventário, saúde das aplicações, validade de certificados, versões de software e status de patches. Complementa o monitoramento existente e sincroniza com o ServiceNow.

Papel
Engenheiro
Status
Em produção

Python · FastAPI · Jinja2 · SQLite · ServiceNow

1.000+ VMs
Escopo

Problema

Uma frota de mais de 1.000 VMs Linux precisa de um lugar só para ver inventário, saúde das aplicações, validade de certificados, versões de software e status de patches.

Arquitetura

EXTERNAL

Linux VM fleet

1,000+ VMs

SERVICE

Data collection

SSH and rsync

SERVICE

Health checks

Every 30 min, with retries

DATASTORE

SQLite

Inventory and check history

SERVICE

Inventory portal

FastAPI and Jinja2

EXTERNAL

ServiceNow

CMDB sync

SERVICE

AI dependency mapping

In progress

DATASTORE

Service definitions

YAML

SERVICE

Architecture diagrams

Rendered from YAML

Infrastructure inventory and CMDB portal (illustrative)Arraste os nós para explorar · Ilustrativo e simplificado. Não é uma topologia real.
Dependências (texto)
  • collector -> fleet [SSH]
  • health -> fleet [HTTP and service registry]
  • collector -> db [writes inventory]
  • health -> db [HEALTHY, UNHEALTHY, STALE]
  • portal -> db [reads]
  • portal -> servicenow [syncs]
  • mapper -> portal [reads context]
  • mapper -> depyaml [generates]
  • renderer -> depyaml [renders]

Python e FastAPI com páginas renderizadas no servidor e SQLite, coletando dados por SSH.

O que faz

  • Health checks a cada 30 minutos nos hosts de aplicação, com retry e estados claros de HEALTHY, UNHEALTHY e STALE.
  • Visões de inventário, certificados, status de patches e hosts em fim de vida, portas esperadas versus abertas, inventário de software e um mapa de serviços.
  • Uma área de admin para renovar certificados sob demanda.
  • Sincronização com o ServiceNow.
  • Em andamento: mapeamento de dependências entre aplicações assistido por IA, que gera definições de serviço em YAML e as renderiza automaticamente como diagramas de arquitetura.

Decisões

  • Complementar o monitoramento, não substituí-lo.
  • YAML como contrato das dependências: legível, revisável e versionado.
  • Seguro por padrão. Configuração por variáveis de ambiente e modo dry-run no batch de health checks.

Resultado

  • Cobre mais de 1.000 VMs.
  • Estendido durante o meu co-op e reconstruído como engenheiro em tempo integral.

← Projetos selecionados