Netbox - Setup

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

graph TD A[Ubuntu 24.04] --> B[Docker] B --> C[NetBox Container]

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:

imagens docker

imagens docker

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

graph TD A[NetBox] --> B[netbox-topology-views] A --> C[netbox-qrcode] B --> D[Visualização de Topologia] C --> E[Geração de QR Codes]

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.

Seu Progresso

Faça login para salvar seu progresso.

Progresso do Capítulo