Laboratório: Implantação do NetBox para Inventário FTTx em Ambiente Virtualizado

Duração estimada

90 min

Passos

12

Validações

5

Versões da documentação consultada

NetBox 3.6 · Docker a versão estável atual · Docker Compose a versão estável atual · PostgreSQL a versão estável atual · Python 3.10+

Topologia

Uma VM executa o NetBox em Docker. O NetBox modela uma rede FTTx simples: OLT (10.0.0.2) conectada a dois switches ópticos (10.0.0.10 e 10.0.0.11), cada um ligado a uma ONT (10.0.1.10 e 10.0.1.11). Toda a comunicação é simulada, sem equipamentos físicos.

         [ VM NetBox ]
              |
           Docker
              |
          [NetBox]
              |
           (modela)
              |
      [OLT]---[SW1]---[ONT1]
         |       |
        ---    [SW2]---[ONT2]

Equipamentos e software

Roteiro

1. Preparar o ambiente Linux

   Atualize o sistema e instale dependências básicas. Isso garante que o ambiente está limpo e pronto para containers.

   sudo apt update && sudo apt upgrade -y
   sudo apt install -y git curlCopiar

   O que você deve ver: Sistema atualizado sem erros; comandos executam normalmente.

2. Instalar Docker e Docker Compose

   O NetBox será executado em containers. Docker simplifica a implantação e isola dependências.

   curl -fsSL https://get.docker.com | sudo sh
   sudo usermod -aG docker $USER
   sudo apt install -y docker-composeCopiar

   O que você deve ver: Docker e Docker Compose instalados. 'docker --version' e 'docker-compose --version' retornam versões.

3. Clonar o repositório oficial do NetBox Docker

   O repositório traz arquivos prontos para subir o NetBox com PostgreSQL.

   git clone https://github.com/netbox-community/netbox-docker.git
   cd netbox-dockerCopiar

   O que você deve ver: Diretório 'netbox-docker' criado com arquivos docker-compose.yml e README.

4. Configurar variáveis de ambiente do NetBox

   Edite o arquivo .env para definir senha e parâmetros mínimos. Isso protege o acesso e define o ambiente.

   cp .env.example .env
   nano .env
   # Edite NETBOX_ADMIN_PASSWORD e DB_PASSWORD (consulte a documentação para detalhes de variáveis).Copiar

   O que você deve ver: Arquivo .env com senhas definidas. Não use valores padrão em produção.

5. Subir o ambiente NetBox

   Inicie os containers do NetBox, PostgreSQL e Redis. Aguarde a inicialização completa.

   docker-compose pull
   docker-compose up -dCopiar

   O que você deve ver: Containers 'netbox', 'netbox-postgres', 'netbox-redis' em execução. 'docker ps' mostra todos ativos.

6. Acessar a interface web do NetBox

   Abra o navegador em http://<IP_da_VM>:8000. O acesso web permite operar o inventário.

   O que você deve ver: Tela de login do NetBox. Use admin e a senha definida.

7. Configurar site e rack

   Crie um 'Site' (ex: 'Central') e um 'Rack' para organizar os equipamentos.

   O que você deve ver: Site e rack aparecem listados na interface.

8. Cadastrar dispositivos: OLT, switches ópticos e ONTs

   Adicione os equipamentos modelando a topologia FTTx. Use tipos 'Chassis', 'Switch', 'ONT' conforme necessário.

   O que você deve ver: Dispositivos listados em Devices, cada um com nome e tipo.

9. Adicionar interfaces e conexões ópticas

   Crie interfaces (ex: GPON, Ethernet) e conecte os dispositivos simulando fibras.

   O que você deve ver: Conexões aparecem na visualização de cabos e interfaces.

10. Cadastrar prefixos e endereços IP

    Adicione prefixos (ex: 10.0.0.0/24) e associe IPs aos dispositivos. Isso integra o inventário lógico.

    O que você deve ver: Endereços IP visíveis em cada dispositivo cadastrado.

11. Visualizar a topologia no NetBox

    Use a visualização de conexões para enxergar a topologia FTTx modelada.

    O que você deve ver: Mapa de conexões entre OLT, switches e ONTs, conforme modelado.

12. Exportar documentação do inventário

    Utilize a exportação CSV ou API para gerar relatórios do inventário cadastrado.

    O que você deve ver: Arquivo CSV ou resposta JSON com dados dos dispositivos e conexões.

Como saber que funcionou

Troubleshooting

Segurança e hardening

• Nunca use senhas padrão em ambientes reais
• Restrinja acesso à porta 8000 apenas à rede de gestão
• Atualize containers e dependências regularmente
• Desabilite cadastro de novos usuários se não for necessário
• Consulte a documentação para hardening adicional

Checklist final

• VM Linux operacional e atualizada
• Docker e Docker Compose instalados
• NetBox executando em container
• Acesso web ao NetBox disponível
• Site, rack e dispositivos cadastrados
• Conexões ópticas modeladas
• Inventário exportado com sucesso