Add comprehensive README

2025-11-16 15:34:18 +00:00
parent 240f5493ed
commit 0ea0e8c740
1 changed files with 220 additions and 0 deletions
--- a/README.md
+++ b/README.md
@@ -0,0 +1,220 @@
+# Arista EVPN-VXLAN ContainerLab
+
+A production-ready Arista BGP EVPN-VXLAN data center fabric topology using ContainerLab and cEOS.
+
+## 🎯 Overview
+
+This lab demonstrates a complete EVPN-VXLAN data center fabric with:
+- **2 Spine switches** (BGP Route Reflectors)
+- **8 Leaf switches** forming 4 VTEPs (MLAG pairs)
+- **BGP EVPN overlay** with L2/L3 VXLAN
+- **MLAG configuration** for high availability
+- **Test hosts** for validation
+
+## 📐 Topology
+
+```
+                    ┌─────────┐  ┌─────────┐
+                    │ Spine1  │  │ Spine2  │
+                    │ AS65000 │  │ AS65000 │
+                    └────┬────┘  └────┬────┘
+                         │            │
+         ┌───────────────┼────────────┼───────────────┐
+         │               │            │               │
+    ┌────┴────┐     ┌────┴────┐ ┌────┴────┐     ┌────┴────┐
+    │ Leaf1/2 │     │ Leaf3/4 │ │ Leaf5/6 │     │ Leaf7/8 │
+    │ AS65001 │     │ AS65002 │ │ AS65003 │     │ AS65004 │
+    │  VTEP1  │     │  VTEP2  │ │  VTEP3  │     │  VTEP4  │
+    └────┬────┘     └────┬────┘ └────┬────┘     └────┬────┘
+         │               │            │               │
+      Host1           Host2        Host3           Host4
+```
+
+## 🚀 Quick Start
+
+### Prerequisites
+
+- ContainerLab installed
+- Docker installed
+- Arista cEOS image: `ceos:4.35.0`
+
+### Deploy the Lab
+
+```bash
+# Clone the repository
+git clone https://gitea.arnodo.fr/Damien/arista-evpn-vxlan-clab.git
+cd arista-evpn-vxlan-clab
+
+# Deploy the topology
+sudo containerlab deploy -t evpn-lab.clab.yml
+
+# Check status
+sudo containerlab inspect -t evpn-lab.clab.yml
+```
+
+### Access Devices
+
+```bash
+# SSH to any device (password: admin)
+ssh admin@clab-arista-evpn-fabric-leaf1
+
+# Or use docker exec
+docker exec -it clab-arista-evpn-fabric-leaf1 Cli
+```
+
+## 📋 Configuration Details
+
+### AS Numbers
+- **Spine**: AS 65000
+- **VTEP1 (Leaf1/2)**: AS 65001
+- **VTEP2 (Leaf3/4)**: AS 65002
+- **VTEP3 (Leaf5/6)**: AS 65003
+- **VTEP4 (Leaf7/8)**: AS 65004
+
+### IP Addressing
+
+#### Management Network
+- Subnet: `172.16.0.0/24`
+- Spine1: `172.16.0.1`
+- Spine2: `172.16.0.2`
+- Leaf1-8: `172.16.0.25-32`
+
+#### Loopback Interfaces
+- **Router-ID Loopbacks (Lo0)**: `10.0.250.0/24`
+  - Spine1: `10.0.250.1/32`
+  - Spine2: `10.0.250.2/32`
+  - Leaf1-8: `10.0.250.11-18/32`
+
+- **VTEP Loopbacks (Lo1)**: `10.0.255.0/24`
+  - VTEP1: `10.0.255.11/32`
+  - VTEP2: `10.0.255.12/32`
+  - VTEP3: `10.0.255.13/32`
+  - VTEP4: `10.0.255.14/32`
+
+#### Underlay P2P Links
+- Spine1 to Leafs: `10.0.1.0/31`, `10.0.1.2/31`, ... `10.0.1.14/31`
+- Spine2 to Leafs: `10.0.2.0/31`, `10.0.2.2/31`, ... `10.0.2.14/31`
+- MLAG iBGP peering: `10.0.3.0/31`, `10.0.3.2/31`, `10.0.3.4/31`, `10.0.3.6/31`
+
+### Features Implemented
+
+✅ **Underlay**
+- BGP IPv4 Unicast
+- ECMP with 4 paths
+- eBGP between Spine-Leaf
+- iBGP between MLAG pairs
+
+✅ **Overlay**
+- BGP EVPN address family
+- VXLAN data plane
+- EVPN Type-2 (MAC/IP routes)
+- EVPN Type-5 (IP Prefix routes)
+
+✅ **High Availability**
+- MLAG dual-homing
+- Dual-active detection
+- Anycast VTEP gateway
+
+## 🧪 Testing & Validation
+
+### Verify BGP EVPN Neighbors
+
+```bash
+# On any spine
+show bgp evpn summary
+
+# On any leaf
+show bgp evpn summary
+```
+
+### Verify VXLAN
+
+```bash
+# Check VXLAN interface
+show interface vxlan1
+
+# Check remote VTEPs
+show vxlan vtep
+
+# Check VXLAN address table
+show vxlan address-table
+```
+
+### Verify MLAG
+
+```bash
+# Check MLAG status
+show mlag
+
+# Check MLAG interfaces
+show mlag interfaces
+```
+
+### Test Connectivity
+
+```bash
+# From host1 to host3 (L2 VXLAN - VLAN 40)
+docker exec -it clab-arista-evpn-fabric-host1 ping 10.40.40.3
+
+# Check BGP EVPN routes
+show bgp evpn route-type mac-ip
+show bgp evpn route-type ip-prefix ipv4
+```
+
+## 📁 Repository Structure
+
+```
+arista-evpn-vxlan-clab/
+├── README.md                    # This file
+├── evpn-lab.clab.yml           # ContainerLab topology
+├── configs/                     # Device configurations
+│   ├── spine1.cfg
+│   ├── spine2.cfg
+│   ├── leaf1.cfg
+│   ├── leaf2.cfg
+│   ├── leaf3.cfg
+│   ├── leaf4.cfg
+│   ├── leaf5.cfg
+│   ├── leaf6.cfg
+│   ├── leaf7.cfg
+│   └── leaf8.cfg
+├── docs/                        # Documentation
+│   ├── configuration-guide.md
+│   ├── validation-commands.md
+│   └── topology-diagram.png
+└── scripts/                     # Helper scripts
+    ├── deploy.sh
+    ├── test-connectivity.sh
+    └── cleanup.sh
+```
+
+## 🔧 Cleanup
+
+```bash
+# Destroy the lab
+sudo containerlab destroy -t evpn-lab.clab.yml
+
+# Remove all related containers and networks
+sudo containerlab destroy --cleanup
+```
+
+## 📚 References
+
+- [Original Configuration Guide](https://overlaid.net/2019/01/27/arista-bgp-evpn-configuration-example/)
+- [Arista EOS Documentation](https://www.arista.com/en/support/product-documentation)
+- [ContainerLab Documentation](https://containerlab.dev/)
+- [RFC 7432 - BGP MPLS-Based Ethernet VPN](https://tools.ietf.org/html/rfc7432)
+- [RFC 8365 - A Network Virtualization Overlay Solution Using EVPN](https://tools.ietf.org/html/rfc8365)
+
+## 📝 License
+
+This project is provided as-is for educational and testing purposes.
+
+## 👤 Author
+
+**Damien Arnodo**
+- Email: damien@arnodo.fr
+
+---
+
+⭐ If you find this lab useful, please star the repository!