From 04defc33888190b02584affdaf39c702b9c16d57 Mon Sep 17 00:00:00 2001
From: tss24 <tss24@inf.ufpr.br>
Date: Wed, 12 Mar 2025 14:21:33 -0300
Subject: [PATCH] =?UTF-8?q?Adiciona=20guia=20de=20cria=C3=A7=C3=A3o=20de?=
 =?UTF-8?q?=20devices?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 source/pages/guides/como-criar-um-device.md | 92 +++++++++++++++++++++
 1 file changed, 92 insertions(+)
 create mode 100644 source/pages/guides/como-criar-um-device.md

diff --git a/source/pages/guides/como-criar-um-device.md b/source/pages/guides/como-criar-um-device.md
new file mode 100644
index 0000000..257c2b4
--- /dev/null
+++ b/source/pages/guides/como-criar-um-device.md
@@ -0,0 +1,92 @@
+# Como criar um novo device no netbox
+
+Primeiro de tudo tenha certeza que o device não existe!
+
+Cheque o MAC e o nome. Caso já exista, utilize esse tutorial mas faça modificações
+e não re-crie as coisas...
+
+## Passos
+
+1. Criar o device propriamente
+2. Criar a(s) interface(s) de rede respectiva(s)
+3. Atribuir o ip corretamente à interface
+4. Gerar o merge-request e rodar a pipeline
+
+## 1. Criar o device
+
+Para criar o device entre no netbox, e em "Devices" --> "Devices" clique em "Add" 
+no topo superior direito.
+
+Preencha:
+
+1. Name
+2. Device Role
+3. Description (recomendado)
+4. Device Type ("1U" p PCs)
+5. Site
+6. Status ("Active", normalmente)
+
+Crie.
+
+## 2. Criar a(s) inteface(s) de rede
+
+Para criar a interface e linka-la, entre em Devices --> Interfaces clique em "Add" 
+e preencha: 
+
+1. Device 
+
+use o botão ao lado do campo para procurar pelo device que você acabou de criar
+
+2. Name (Unnamed para PCs)
+3. Type (1000BASE-T para PCs)
+4. MAC-Address
+5. Enabled
+
+Crie. Se você procurar pelo device, uma aba de interfaces deve ter aparecido.
+
+## 3. Atribuir o ip à interface
+
+Escolha um ip para a máquina no prefixo e VLAN corretos que não esteja alocado, 
+
+ou 
+
+entre em IPAM --> VLANs para ver todas, ao clicar em uma, você pode ver os 
+prefixos (fim da página), ao escolher um escolha a aba "Endereços IP" e lá
+pode escolher um ip não atribuído.
+
+Ao clicar em criar, preencha:
+
+1. Status (*ATENÇÃO*: utilize DHCP!)
+2. DNS name (normalmente [nome-device].c3local)
+3. Interface
+
+use o botão ao lado do campo para pesquisar pelo device
+
+4. Make this the primary IP for the device (se único)
+
+Crie. Se você entrar e olhar a interface do device, o IP escolhido deve aparecer
+de uma cor verde! se não houver cor verde (status DHCP), 
+atualizar o dhcp não fará nada :/
+
+## 4. Criar o merge-request e rodar a pipeline
+
+Entre na vm netbox:
+
+```sh
+ssh root@netbox
+```
+
+Gere os merge-requests:
+
+```sh
+~/netboxadm/netboxadm.py update dhcp
+~/netboxadm/netboxadm.py update dns
+```
+
+Acesse os links retornados pelos comandos e cheque as configs. 
+
+Se tudo está ok, renomeie os commits de acordo e escolha para deletar a branch. 
+
+Merge.
+
+Observe se algo deu errado com as pipelines.
-- 
GitLab