Requisitos do Sistema
Para executar o NetBox com Docker, você precisará de:
-
Sistema Operacional: Ubuntu (VM, bare metal ou WSL no Windows)
-
Recursos Mínimos: 4 vCPUs e 8 GB de RAM
-
Conexão: Acesso à internet
Opções de Implantação
Para começar a explorar e testar o Netbox, atualmente temos 2 opções:
-
Docker
-
Netbox Cloud (Gratuito) -- A vantagem é que ele pode vir com informações pré-preenchidas, então você não precisa gastar tanto tempo.
Como quero testar diferentes versões, ter acesso root e mais flexibilidade para experimentar, vamos optar pela opção Docker.
No meu ambiente, estou usando Windows, então, para rodar o Docker, primeiro precisamos configurar o WSL.
Obtendo e Executando a Imagem
Podemos encontrar instruções sobre como construir e executar o Netbox como um contêiner Docker no GitHub no seguinte link: netbox-docker
git clone -b release https://github.com/netbox-community/netbox-docker.git
cd netbox-docker
tee docker-compose.override.yml <<EOF
services:
netbox:
ports:
- 8000:8080
EOF
docker compose pull
docker compose up -d
Imagens Docker após o pull:
Contêineres Docker após iniciar:
É bastante simples; toda a aplicação estará disponível após alguns minutos. Abra a URL http://0.0.0.0:8000/
em um navegador web. Você deverá ver a página inicial do NetBox.
Após iniciar os contêineres, devemos ver algo assim:
Configuração Inicial
Para o login, podemos prosseguir de duas maneiras:
Opção 1: Via Comando Docker
- Podemos abrir uma nova janela de terminal e executar o comando conforme mostrado no GitHub:
docker compose exec netbox /opt/netbox/netbox/manage.py createsuperuser
Opção 2: Acessando o Contêiner
- Podemos entrar no contêiner Netbox como ROOT e executar o script a partir daí. É assim que eventualmente modificaremos os arquivos do Netbox para adicionar plugins, scripts e configurações específicas.
docker exec -it --user=root netbox-docker-netbox-1 bash
./manage.py createsuperuser
Após criar o usuário, agora podemos fazer login via WebUI e configurar nosso token de API para começar a automatizar:
Extendendo Funcionalidades com Plugins
O NetBox suporta plugins para expandir suas funcionalidades, como netbox-topology-views (visualização de topologia) e netbox-qrcode (geração de QR codes). Consulte a lista completa de plugins em netboxlabs.com/plugins.
Exemplo de Configuração de Plugins
Para instalar um plugin, acesse o contêiner e modifique os arquivos de configuração conforme necessário.
Conclusão
Com o NetBox configurado, você pode modelar sua infraestrutura de rede, adicionar dispositivos, cabos, IPs e integrar com ferramentas de automação. Nos próximos passos, explore a criação de topologias de rede e scripts para interagir com o NetBox via API.