Documentação de Infraestrutura
Rede que só o fundador conhece é risco operacional. Técnico novo leva semanas pra entender; incidente de madrugada vira caos; cliente que cresce vende e o comprador pede documentação que não existe.
O que é documentação de infraestrutura
Documentação de rede cobre três camadas: IPAM (gestão de endereçamento IP e VLANs), inventário físico/lógico (equipamentos, cabos, topologia) e procedimentos operacionais (runbooks, checklists de manutenção, planos de contingência). Documentação que fica no Visio do fundador não conta — tem que estar acessível e atualizada.
O que a RASYS faz
- phpIPAM como source of truth — prefixos, VLANs, dispositivos, RIRs, ASN, localizações.
- IPAM estruturado — hierarquia de prefixos, pools de IP por serviço, alocação rastreável.
- Diagramas de topologia com Draw.io (exportável/editável) ou Mermaid (versionável em Git).
- Runbooks de operação — substituição de equipamento, failover manual, troubleshooting step-by-step.
- Checklists de manutenção — janelas planejadas com passos de validação antes e depois.
- Procedimentos de NOC — escalonamento, quem chama quem, quando acionar plantão, como abrir ticket com operadora.
- Plano de DR documentado — RTO/RPO definidos, cenários cobertos, runbook de restauração documentado.
- Levantamento da infraestrutura existente quando não há documentação de partida — entrevistamos a equipe, inspecionamos remotamente e montamos o baseline.
Ferramentas com que trabalhamos
phpIPAM (IPAM e inventário), Draw.io, Mermaid, Markdown em Git (documentação versionável), Confluence/Notion quando o cliente já usa.
Quando faz sentido falar com a gente
Nenhum membro da equipe consegue fazer onboarding de técnico novo em menos de uma semana; incidente recente expôs falta de runbook; vai abrir PoP ou expandir e a documentação está defasada; comprador ou auditor pediu documentação da rede; quer reduzir dependência de pessoa chave.
Fale com a gente — conversa inicial sem compromisso. Veja também: Backup de Configurações, Monitoramento.
PERGUNTAS FREQUENTES
Quanto tempo leva o levantamento inicial de uma rede sem documentação?
Depende do tamanho e da complexidade. Uma rede com 5-10 equipamentos de borda e 2-3 PoPs: 2-4 semanas pra chegar em documentação funcional. Redes maiores ou com muito legado sem registro: avaliamos após um primeiro acesso de inspeção remota. Começamos pelo que impacta mais operação e vamos cobrindo o resto em iterações.
phpIPAM é obrigatório ou usam outras ferramentas?
phpIPAM é o que usamos pra IPAM — é open source, tem API, e é simples de operar pra equipe de provedor. Pra inventário físico/lógico (equipamentos, racks, cabos, localizações), trabalhamos em cima de markdown versionado em Git. Se o cliente já tem NetBox, Nautobot ou outra ferramenta funcionando, trabalhamos em cima do que existe. O que evitamos é planilha Excel como fonte única de verdade — não tem versionamento, não tem API, e fica desatualizada em semanas.
A documentação fica viva no dia a dia?
Sim. Trabalhamos com plano mensal — clientes ficam anos com a gente, não é projeto avulso que tem fim. A documentação é mantida junto com o resto da operação: toda mudança de config gera ticket que inclui a atualização correspondente, e os diagramas Mermaid moram no mesmo repositório da infra, então mudança de infra passa pela atualização do diagrama. Documentação que ninguém mantém é inútil.
Fazem apenas a documentação ou também corrigem o que encontrarem?
Durante o levantamento, apontamos tudo que encontramos de inconsistente ou problemático. Corrigi o que encontrarmos é escopo separado — documentamos os achados, você decide o que quer atacar primeiro. Muitos clientes usam o levantamento como entrada pra priorizar o backlog técnico do trimestre seguinte.