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 0000000000000000000000000000000000000000..257c2b49b8b2cd6dd9c0b4edcc3de5d6cb947b56 --- /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.