Rede sem documentação: como operar o que você não construiu
Herdei uma rede corporativa sem diagrama, sem inventário, com configurações que ninguém sabia de onde vinham. O que aprendi sobre operar sistemas legados sem história documentada.
Meu predecessor não havia documentado nada.
Nenhum diagrama de rede. Nenhum inventário de equipamentos. Nenhuma lista de VLANs, subnets, ou quais IPs estáticos haviam sido atribuídos. Configurações nos switches e roteadores que ninguém sabia por que existiam — só existiam.
Minha primeira semana foi basicamente arqueologia.
Como você opera algo que não entende?
Com muito cuidado, e construindo entendimento aos poucos antes de fazer qualquer mudança.
Primeiro passo foi descoberta passiva: sem tocar em nada, apenas observar. Rodei scan de rede para listar os dispositivos ativos. Documentei cada endereço IP que aparecia, o MAC address correspondente, o hostname quando disponível. Comecei a construir o inventário que não existia.
Segundo passo foi correlação: confrontar o que estava ativo com o que eu conseguia encontrar fisicamente. Cada equipamento rack, cada cabo, cada switch. Documentando o que encontrava.
Terceiro passo foi entender as configurações antes de julgá-las. Algumas configurações que pareciam estranhíssimas tinham razão — eram workarounds para problemas de hardware específicos, ou compatibilidade com equipamentos legados. Só descobre quando entende o contexto.
A regra que estabeleci para mim mesmo: nunca remover configuração que não entendo.
Parece óbvio. Não é quando você está olhando para configuração que parece errada e está com pressa.
Algumas das configurações legadas que preservei até entender por que existiam eram exatamente os casos onde se eu tivesse removido por parecer desnecessária, teria causado problema. A configuração existia por razão que não estava documentada — e preservei tempo para descobrir a razão antes de agir.
Esse princípio — entender antes de remover, mesmo que pareça inútil — é o mesmo princípio por trás de "antes de deletar código, entende por que foi escrito." Código legado sem comentário não é necessariamente código ruim. É código cujo contexto foi perdido.
O que aquela herança sem documentação me ensinou é que documentação não é para você. É para quem vier depois.
Quando construo algo, estou no contexto. Sei por que tomei cada decisão. A documentação parece redundante — "eu já sei isso, por que escrever?"
Seis meses depois, quando fui trabalhar em outro projeto e voltei para revisar algo que havia configurado, já não lembrava de metade do contexto. A documentação que havia criado durante a fase de arqueologia foi o que me salvou.
Quem não documenta está otimizando para agora e penalizando o futuro — o próprio futuro incluso.
Essa semana: tem algo que você opera hoje que seria inoperável se você sumisse amanhã sem avisar?