Feat/cookbook (#12)

* feat(cookbook) : Complete CookBook

documentation/CookBook.md

@@ -1,21 +1,26 @@
-# CookBook
+# 🌟 NetBox & cEOS VXLAN Fabric Cookbook 🌟
 
 >[!WARNING]
->
 > Work in progress
->
 
-## Prepare data
+## 📚 Introduction
 
-### Popule data in Netbox
+This cookbook guides you through setting up a VXLAN fabric using NetBox for configuration management and cEOS for network virtualization. Perfect for demonstrating NetBox's capabilities with RenderConfig to generate a complete fabric configuration.
 
-Generate a Netbox token via webui and execute the python script, and on utilities folder start population :
+## 🛠️ Prepare Data
+
+### 📋 Populate NetBox
+
+1. Generate a NetBox token via the web UI
+2. Execute the Python script to import your device models:
 
 ```bash
 uv run import.py http://localhost:8080 YOUR_TOKEN Devices/devices_model.yml
 ```
 
-## Create Fabric
+## 🏗️ Create Fabric
+
+Run the fabric creation script:
 
 ```bash
 uv run Create_Fabric/main.py
@@ -30,3 +35,230 @@ Existing Sites:
   1. Paris (slug=paris)
 Choose site number or 'new': 1
 ```
+
+### 🔍 View Topology
+
+Using the Topology View plugin:
+
+1. Navigate to Topology View > Topology
+2. Click on 'filter' and enable:
+   - ✅ Show Circuit Terminations
+   - ✅ Show Cables
+   - ✅ Group Sites
+   - ✅ Group Locations
+   - ✅ Node Label Item: Device Name
+
+![Fabric Topology](assets/images/cookbook/fabric_topology.png)
+
+## 👥 Add Customer
+
+```bash
+❯ uv run Create_Fabric/add_customers.py
+Enter NetBox URL: http://localhost:8080
+Enter NetBox API Token: 4e58e40e6b19d7f6cc53ae5665ca7ddd00558e71
+Enter Customer Name: Orange
+Enter VLAN ID (1-4094): 10
+Enter VNI ID: 10010
+
+Available Locations:
+0: PA1
+1: PA2
+2: PA3
+3: PA4
+Select locations (comma-separated indices): 0,2
+
+❯ uv run Create_Fabric/add_customers.py
+Enter NetBox URL: http://localhost:8080
+Enter NetBox API Token: 4e58e40e6b19d7f6cc53ae5665ca7ddd00558e71
+Enter Customer Name: Purple
+Enter VLAN ID (1-4094): 10
+Enter VNI ID: 10010
+
+Available Locations:
+0: PA1
+1: PA2
+2: PA3
+3: PA4
+Select locations (comma-separated indices): 1,3
+```
+
+## 📝 Apply Templates
+
+### 📤 Import Templates to NetBox
+
+1. Go to Operation > Data Sources > +Add
+2. Configure:
+   - Name: Templates
+   - Type: Local
+   - URL: /tmp/templates
+3. Click on Sync
+
+![Templates Files](assets/images/cookbook/templates_files.png)
+
+### 📋 Create Config Templates
+
+Create 3 templates in Provisioning > Config Templates:
+
+1. Name: Spine
+   - Data Source: Templates
+   - File: spine.j2
+2. Name: Leaf
+   - Data Source: Templates
+   - File: leaf.j2
+3. Name: Access
+   - Data Source: Templates
+   - File: access.j2
+
+![Config Template Example](assets/images/cookbook/config%20template.png)
+
+When complete, you should see:
+
+![All Templates](assets/images/cookbook/all_templates.png)
+
+### 🔄 Reconfigure Devices
+
+1. Go to Devices > Devices
+2. Filter by role:
+   ![Role Filter](assets/images/cookbook/role_filter.png)
+3. Select all and Edit Selected:
+   ![Edit Selected](assets/images/cookbook/edit_selected.png)
+4. In the configuration part, select the matching Config Template for the device role:
+   ![Spine Template](assets/images/cookbook/spine_template.png)
+5. Repeat for all three roles: Spine, Leaf, and Access
+
+Now you can view configurations via Render Config:
+Devices > Devices > Render Config
+
+![Leaf1 Render Config](assets/images/cookbook/leaf1_render_config.png)
+
+## 🚀 Deploy NetLab
+
+Deploy a containerlab environment to validate your configuration:
+
+```bash
+cd containerlab
+❯ clab deploy -t fabric_vxlan.yml
+```
+
+You should see output showing all your devices running:
+
+```bash
+╭───────────────────────────────┬───────────────┬─────────┬────────────────╮
+│              Name             │   Kind/Image  │  State  │ IPv4/6 Address │
+├───────────────────────────────┼───────────────┼─────────┼────────────────┤
+│ clab-vxlan_fabric-host1       │ linux         │ running │ 172.20.20.21   │
+│                               │ alpine:latest │         │ N/A            │
+...
+│ clab-vxlan_fabric-padc_sp2_00 │ ceos          │ running │ 172.20.20.11   │
+│                               │ ceos:4.33.2F  │         │ N/A            │
+╰───────────────────────────────┴───────────────┴─────────┴────────────────╯
+```
+
+### 📊 View Lab Topology
+
+Using the VSCode Containerlab extension:
+
+1. Open Containerlab panel
+2. Right-click and select "Graph Lab (TopoViewer)"
+
+![Containerlab TopoViewer](assets/images/cookbook/clab_topoviewer.png)
+
+## ⚙️ Deploy Configuration
+
+Currently, you need to manually apply configurations:
+
+1. Use the VSCode extension to "Connect to SSH" for each device  
+   ![SSH Access](assets/images/cookbook/clab_ssh_access.png)
+
+2. Login credentials:
+   - **Username:** admin
+   - **Password:** admin
+   - Remember to enter "**en**" for enable mode and "**conf t**" for configuration mode
+
+3. Copy/paste the rendered configuration from NetBox
+
+### 🔍 Validate Configuration
+
+Check BGP, EVPN, and VXLAN configuration:
+
+```bash
+pa01_lf1_00(config)#show bgp summary
+BGP summary information for VRF default
+Router identifier 192.168.100.2, local AS number 65101
+Neighbor               AS Session State AFI/SAFI                AFI/SAFI State   NLRI Rcd   NLRI Acc
+------------- ----------- ------------- ----------------------- -------------- ---------- ----------
+172.16.0.1          65001 Established   IPv4 Unicast            Negotiated              3          3
+...
+
+pa01_lf1_00(config)#show bgp evpn
+BGP routing table information for VRF default
+...
+```
+
+### 🔌 Enable Host Interfaces
+
+Connect to each host and enable eth1:
+
+```bash
+ifup eth1
+```
+
+Check VXLAN address table on leaf devices:
+
+```bash
+pa01_lf1_00#show vxlan address-table
+          Vxlan Mac Address Table
+----------------------------------------------------------------------
+VLAN  Mac Address     Type      Prt  VTEP             Moves   Last Move
+----  -----------     ----      ---  ----             -----   ---------
+  10  aac1.ab60.2c6b  EVPN      Vx1  192.168.100.4    1       0:04:23 ago
+Total Remote Mac Addresses for this criterion: 1
+```
+
+## ✅ Validate Connectivity
+
+Two customers should be configured:
+
+1. 🟠 **Orange**
+   - Subnet: 10.0.0.0/24
+   - Hosts:
+     - PA1: 10.0.0.10
+     - PA3: 10.0.0.20
+
+2. 🟣 **Purple**
+   - Subnet: 10.0.1.0/24
+   - Hosts:
+     - PA2: 10.0.1.10
+     - PA4: 10.0.1.20
+
+Test connectivity with ping:
+
+```bash
+/ # ifconfig eth1
+eth1      Link encap:Ethernet  HWaddr AA:C1:AB:49:55:B6  
+          inet addr:10.0.0.10  Bcast:0.0.0.0  Mask:255.255.255.0
+...
+
+/ # ping 10.0.0.20
+PING 10.0.0.20 (10.0.0.20): 56 data bytes
+64 bytes from 10.0.0.20: seq=0 ttl=64 time=15.378 ms
+64 bytes from 10.0.0.20: seq=1 ttl=64 time=4.349 ms
+...
+```
+
+## 🔍 Packet Capture
+
+Edgeshark is available for packet analysis:
+
+```bash
+❯ cd /opt/edgeshark 
+❯ docker compose up -d
+```
+
+Using the VSCode extension, start Wireshark by clicking on **Capture Interface**:
+
+![Leaf1 Capture](assets/images/cookbook/leaf1_capture_eth1.png)
+
+![Wireshark Interface](assets/images/cookbook/wireshark_eth2_leaf1.png)
+
+---