Curso - WTR POP RR - NIC.br

Este repositório contém os arquivos e instruções para o laboratório do curso de Automacao - WTR - POP RR

Pré-requisitos   •   Instalação das Dependências   •   NetBox (IPAM/DCIM)   •   Laboratório com Containerlab   •   Ambiente para executar os exercícios   •   Exercícios de Automação de Rede   •   Projeto Final   •   Referências

---

📋 Pré-requisitos

Antes de começar, certifique-se de que o sistema possui:

• Linux (Debian 12.10.0 netinst instalação limpa) - 1 host [16G RAM(ou mais), 50G Disco, 8vcpu (ou mais)] https://drive.google.com/file/d/14A_xpEiPQka0bGYG-7IHVqxnipWEXinb/view?usp=drive_link
• Acesso a Internet para download de arquivos
• IDE para visualizar arquivos .py, compose.yml, Dockerfile. (VS Code, Pycharm)

🚀 Instalação das Dependências

Instalac̨ão do GIT

apt install git -y

Git clone do Repositorio

cd /opt
git clone https://github.com/wsdoprado/wtr-pop-rr-2025.git

Execute o script abaixo para instalar as dependências necessárias:

cd /opt/wtr-pop-rr-2025/
./install_dependencies.sh

📦 NetBox (IPAM/DCIM)

O NetBox será utilizado como fonte da verdade - NSOT

cd /opt
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

alterar o docker-compose.yml (depende de cada cenario)

start_period: 500s
timeout: 30s
interval: 30s
retries: 5

Para subir

docker compose up

ou

docker compose up -d

Definir ou alterar o usuário de acesso

docker compose exec netbox /opt/netbox/netbox/manage.py createsuperuser

O NetBox estará disponível em: 👉 http://localhost:8000

🧪 Laboratório com Containerlab

Baixe as imagens de Arista cEOS: 📂 Google Drive - Imagens de Laboratório

• https://drive.google.com/drive/folders/1uLDcgJuoxOE7c4ZD3WsPwLmvPrJKqeLE

OBS: cEOS-lab-4.34.2F.tar.xz precisa estar no host do laboratório. Dica: Transferir por SCP

Dados de acesso aos equipamento

• user: admin
• password: admin

Criando o container para Arista cEOS

Importe a imagem do Arista cEOS:

docker import cEOS-lab-4.34.2F.tar.xz ceos:4.34.2F

Criando o laboratório do curso

Suba o laboratório de exemplo:

containerlab deploy -t wtr.yml

Destrua um laboratório específico:

containerlab destroy -t wtr.yml --cleanup

Liste e inspecione laboratórios ativos:

containerlab inspect --all

Ambiente para executar os exercícios

🐍 Ambiente Python para execução dos scripts

Para executar os scripts em python é necessário criar um ambiente virtual e instalar as dependências.

Por padrão, o uv é instalado em ~/.local/bin. Para poder usá-lo de qualquer lugar no terminal, é necessário adicionar esse diretório ao PATH.

export PATH=$PATH:/root/.local/bin

Criar o ambiente virtual

uv venv

Ativar o ambiente virtual

source .venv/bin/activate

Instalar ou atualizar as dependências dentro do ambiente virtual

uv sync

Sair do ambiente virtual

deactivate

🖥️ Iniciando os Exercícios de Automação de Rede

Criar um arquivo .env.dev na raiz do projeto. E modificar os dados de acordo

cp .env.dev.example .env.dev

Esse arquivo será utilizado tanto nos exercícios quanto no projeto completo para fornecer os dados de acesso entre os serviços.

📚 Referências

• Slides apresentação no Drive
• Documentação Pyeapi
• Documentação Netbox