Como funciona implantação de NetBox: fases para provedores
Como funciona implantação de NetBox: primeiro a equipe combina o padrão de nomes, depois o sistema é instalado com cópia automática e os dados entram numa ordem fixa, dos POPs aos endereços. A implantação termina com uma integração lendo o inventário pela API e com a regra de que nada muda na rede sem mudar no NetBox.
Resumo
- O NetBox guarda a rede em objetos ligados entre si, e um endereço IP só existe dentro de um prefixo cadastrado antes.
- [object Object]
- A equipe do provedor participa do padrão de nomes e da decisão de cada conflito entre planilhas, que ninguém de fora decide.
- O registro de alterações mostra, semanas depois, se a equipe continua cadastrando ou se o inventário parou no tempo.
Como o NetBox organiza a rede por dentro
O NetBox organiza a rede em objetos que dependem uns dos outros, como peças encaixadas. Um equipamento pertence a um POP, uma interface pertence a um equipamento e um endereço pertence a um prefixo.
Por baixo, o NetBox é um sistema web feito em Python, com banco de dados PostgreSQL e cache em Redis. Tudo o que aparece na tela também sai pela API, e cada alteração fica registrada com autor, data e o valor anterior.
- Lado físico: POP, que o NetBox chama de site, depois rack, equipamento, interface e o cabo que liga duas interfaces.
- Lado lógico: bloco recebido do registro, prefixos dentro dele, endereços dentro dos prefixos e VLANs agrupadas por POP.
- Circuitos: operadora, circuito com identificador e a interface do equipamento onde ele termina.
- Campos próprios: informações que só o provedor usa, como a OLT de origem ou o contrato de um link.
A Táquion Tech configura esse modelo com os nomes da sua rede na implantação de NetBox e carrega os dados na ordem que ele exige, para que cada endereço já nasça ligado ao POP e ao equipamento certos.
Por que a ordem de cadastro importa tanto?
Porque o NetBox recusa um objeto que aponta para outro que ainda não existe. Um equipamento importado antes do POP ou do tipo de equipamento volta com erro, e a planilha inteira para.
Essa exigência é o que dá valor ao inventário. Na planilha, um endereço pode apontar para um POP que fechou; no NetBox, essa ligação quebrada aparece na hora.
Onde entram o IPv6 e a faixa do CGNAT
Os blocos IPv6 entram como agregados e são divididos em prefixos por POP e por uso, seguindo o plano de endereços do provedor. O guia sobre como funciona o endereçamento IPv6 mostra como esse plano costuma ser desenhado.
A faixa compartilhada do CGNAT, 100.64.0.0/10, fica separada dos blocos públicos, com papel próprio. Assim, a busca por endereço livre nunca devolve um IP interno no lugar de um público.
Como funciona implantação de NetBox, fase a fase
A implantação passa por cinco fases, e cada uma termina com um critério claro de pronto. A equipe do provedor participa de todas, em proporções diferentes.
Origem
Planilhas e equipamentos
Todas as versões de planilhas de IP e VLAN, mais o que é lido direto dos roteadores, switches e OLTs.
Padrão
Limpeza e nomes combinados
Conflitos apontados, decididos pela equipe e corrigidos; nomes ajustados ao padrão escrito.
Importação
Carga na ordem das dependências
POPs, tipos de equipamento, equipamentos, VLANs, prefixos e endereços, nessa sequência.
NetBox
Fonte de verdade
Cada objeto ligado aos outros, com histórico de quem mudou o quê e quando.
API
Ferramentas que leem dali
Monitoramento, scripts de configuração e relatórios consultam o inventário em vez da planilha.
A seta de volta, das ferramentas para o NetBox, só existe com a rotina de cadastro. Sem ela, o inventário envelhece e as ferramentas passam a ler dados errados.
| Fase | Quem da sua equipe participa | Peso no calendário | Termina quando |
|---|---|---|---|
| 1. Padrão de nomes | Quem opera a rede e quem vai cadastrar | Curto, mas pede reuniões | O documento de padrão está aprovado |
| 2. Instalação | Quem cuida dos servidores | Curto | O acesso por HTTPS funciona e a restauração da cópia foi testada |
| 3. Importação | Quem decide os conflitos entre planilhas | O mais longo, cresce com a sujeira dos dados | Os relatórios de conflito estão zerados ou decididos |
| 4. Integração inicial | Quem cuida do monitoramento ou dos scripts | Médio | A ferramenta escolhida lê o NetBox e o resultado foi conferido |
| 5. Treinamento e entrega | Todos que vão cadastrar | Curto | A equipe cadastra uma mudança real sozinha |
Os prazos em dias saem na proposta, depois de ver as planilhas: [PREENCHER prazo típico por fase]. A importação domina o calendário porque cada conflito precisa de uma resposta de quem conhece a rede.
O que o provedor separa antes da primeira reunião?
O provedor separa as planilhas, uma máquina virtual, acesso de leitura aos equipamentos e duas ou três pessoas da equipe. O resto é trabalho de quem implanta.
- Planilhas: todas as versões de IPs, VLANs e equipamentos, inclusive as velhas, porque a diferença entre elas mostra os conflitos.
- Lista de POPs: nome, cidade e o que cada um atende, para virar a base do cadastro físico.
- Máquina virtual: com os requisitos da versão escolhida [CONFIRMAR na documentação do fornecedor] e espaço para cópia fora dela.
- Acesso de leitura: aos roteadores, switches e OLTs, para conferir interfaces e endereços com o que está configurado de fato.
- Quem decide: uma pessoa com autoridade para dizer qual planilha vale quando duas discordam.
- Quem vai cadastrar: os nomes de quem mantém o inventário depois, que participam desde a fase do padrão.
O que muda o tamanho do projeto, como o estado das planilhas e o cadastro de cabos, está no guia sobre quanto custa implantação de NetBox. Para o funcionamento, o item que mais pesa é a pessoa que decide os conflitos: sem ela, a importação para.
Na prática: arquivos de importação e chamadas à API
A carga em massa usa arquivos CSV, um por tipo de objeto, e as integrações usam a API REST. O exemplo mostra os dois com endereços de documentação.
# 1. sites.csv (importado primeiro)
name,slug,status
POP-CENTRO,pop-centro,active
POP-PRAIA,pop-praia,active
# 2. prefixes.csv (importado depois dos POPs e das VLANs)
prefix,status,description
203.0.113.0/24,active,Clientes PPPoE POP-CENTRO
100.64.0.0/22,active,CGNAT POP-CENTRO
2001:db8:100::/40,container,Bloco IPv6 de clientes
# 3. API: reservar o próximo endereço livre do prefixo de id 12
curl -s -X POST \
-H "Authorization: Token $NETBOX_TOKEN" \
-H "Content-Type: application/json" \
https://netbox.exemplo.com.br/api/ipam/prefixes/12/available-ips/ \
-d '{"description": "Loopback BNG-02", "status": "active"}'
A terceira parte é a que mais muda o dia a dia: o endereço livre deixa de ser descoberto perguntando no grupo e passa a ser reservado por quem vai usá-lo, com nome e data. O guia de rede como código mostra como scripts de configuração usam esse mesmo caminho.
Quer o NetBox carregado na ordem certa, sem planilha quebrada no meio?
Um Especialista monta o padrão com a sua equipe, reconcilia as planilhas e importa os dados em sequência, com cada conflito decidido por quem conhece a rede.
Erros de cada fase e o sinal que aparece primeiro
Os erros de implantação raramente aparecem no dia em que acontecem; eles dão sinal semanas depois. Os sinais abaixo servem para conferir uma implantação em andamento ou uma que já terminou.
Marque os sinais que você já vê no seu NetBox
- Padrão: o mesmo tipo de equipamento aparece com dois ou três jeitos de nome na busca.
- Instalação: ninguém sabe dizer quando foi a última restauração de cópia testada.
- Importação: endereços sem prefixo ou equipamentos sem POP aparecem nos relatórios.
- Integração: o monitoramento mostra equipamentos que já saíram da rede, ou deixa de mostrar os novos.
- Treinamento: o registro de alterações não tem mudança nenhuma nas últimas semanas, embora a rede tenha mudado.
- Rotina: alguém da equipe voltou a manter uma planilha paralela, por garantia.
Um sinal isolado se corrige em uma tarde. Três ou mais indicam que o inventário está perdendo a confiança da equipe, e o ponto de partida é rever o padrão e a regra de cadastro antes de qualquer nova integração.
O último sinal é o mais sério, porque mostra que o mapa voltou para a cabeça de uma pessoa. O guia sobre o técnico de rede que saiu mostra o que esse tipo de dependência custa quando ela vai embora.
Exemplo: três POPs, duas planilhas e o monitoramento lendo o inventário
Um provedor hipotético com três POPs, duas planilhas de IP que não batem e o Zabbix montado à mão mostra o caminho completo. A meta era o monitoramento passar a ler o inventário.
- Padrão: em duas reuniões, a equipe decide nomes como POP-CENTRO e BNG-01 e escreve como VLANs e prefixos serão descritos.
- Instalação: o NetBox sobe numa máquina virtual do provedor, com HTTPS, um usuário por pessoa e cópia diária enviada a outro servidor, restaurada em teste.
- Importação: a comparação entre as planilhas aponta endereços repetidos; o responsável decide cada um, e a leitura dos roteadores confirma o que está em uso.
- Integração: um script lê os equipamentos ativos pela API e cria ou desativa os hosts no Zabbix; a primeira rodada encontra equipamentos que nunca tinham sido monitorados.
- Entrega: cada técnico cadastra sozinho uma mudança real, e a regra combinada passa a valer: endereço novo só é usado depois de reservado no NetBox.
O ganho visível veio na quarta etapa, quando o monitoramento passou a refletir a rede real. O guia de como fazer monitoramento de rede ajuda a decidir o que mais o inventário deve alimentar.
Como funciona implantação de NetBox depois da entrega
Depois da entrega, o NetBox vira parte da rotina: toda mudança na rede começa por ele. O provedor recebe o sistema, os documentos e a equipe treinada para manter essa regra.
- Sistema no ar: NetBox com HTTPS, usuários por pessoa, permissões por função e cópia restaurada em teste.
- Documento de padrão: como nomear POPs, equipamentos, VLANs e prefixos, para quem chegar depois.
- Relatório da importação: os conflitos encontrados, quem decidiu cada um e o que ficou para conferir em campo.
- Integração funcionando: a ferramenta escolhida lendo o inventário, com o passo a passo de como ela foi ligada.
A implantação de NetBox exige uma regra simples para dar certo: reservar no inventário antes de configurar no equipamento. Quando a ordem se inverte, o NetBox passa a contar a história com atraso.
Qual integração deve vir primeiro?
Quase sempre o monitoramento, porque o resultado aparece rápido e mostra à equipe que o inventário serve para alguma coisa. Scripts de configuração vêm depois, quando os dados já provaram que estão certos.
Quem já coleta métricas com outras ferramentas pode seguir o mesmo caminho; o guia de implantação de Prometheus mostra uma coleta que também pode partir da lista de equipamentos do NetBox.
Perguntas frequentes
O NetBox descobre os equipamentos da rede sozinho?
Não por conta própria, porque ele foi feito para registrar o que a rede deve ser. A leitura dos equipamentos é feita por scripts ou plugins à parte [CONFIRMAR na documentação do fornecedor], usados na importação para conferir as planilhas.
Dá para importar só uma parte da rede no começo?
Dá, desde que a ordem das dependências seja respeitada dentro dessa parte. Muitos provedores começam por endereços e VLANs e deixam racks e cabos para depois.
Quem pode alterar dados no NetBox depois da implantação?
Quem a equipe definir, com permissões por função: alguns só consultam, outros cadastram, e poucos administram. Como cada alteração fica registrada com autor, fica fácil saber quem mudou um dado errado.
O que acontece com as planilhas antigas depois da importação?
Elas são guardadas como arquivo, mas deixam de ser editadas. Manter uma planilha paralela "por garantia" é o primeiro passo para o inventário perder a confiança da equipe.
Atualizar a versão do NetBox apaga os dados cadastrados?
Não deveria, porque a atualização migra o banco de dados para a versão nova. Mesmo assim, ela começa sempre por uma cópia recente e por conferir se os plugins em uso são compatíveis [CONFIRMAR na documentação do fornecedor].
Responsável técnico da Táquion Tech · Registro profissional [PREENCHER]
Mais de 15 anos em operações de rede, com gestão de infraestruturas de TI, administração de data centers e condução de equipes em migrações de TI e telecomunicações, com foco em alta disponibilidade e segurança.
A Táquion Tech é uma empresa de engenharia de redes de Balneário Camboriú (SC) que projeta, opera e dá suporte a redes de provedores de internet e de empresas.
Fontes
- NetBox (repositório oficial): código, documentação, modelo de dados e notas de versão do NetBox, edição comunitária
- Documentação oficial do NetBox: importação em massa, API REST e registro de alterações
