# VXLAN-EVPN Lab with ContainerLab

## Sources

- [ContainerLab](https://containerlab.dev)
- [Virtual Data Center Network](https://medium.com/@aifakhri/bgp-evpn-and-vxlan-configuration-with-arista-veos-b1046c24d046)

## Overview

This project provides a hands-on lab environment for understanding and experimenting with VXLAN-EVPN (Ethernet VPN) technology. Using ContainerLab, the lab sets up a VXLAN topology featuring 1 spine and 2 leaves nodes. The lab can be deployed directly on a PC with ContainerLab installed or through a DevContainer environment.

## Project Structure

The project directory is structured as follows:

- `hosts`: Directory containing host configuration files for the lab.
- `network_images/ceos-lab-4.32.0.1F.tar.xz`: Container image used for the lab nodes.
- `lab_vxlan.yml`: YAML file describing the VXLAN lab topology.

## Prerequisites

- Docker and Docker Compose (for DevContainer setup).
- ContainerLab installed either on the host or within the DevContainer.
- Basic understanding of networking and VXLAN-EVPN concepts.

## Setup and Deployment

1. **DevContainer Setup (Optional):**  
   If using DevContainer, ensure Docker and Docker Compose are installed on your machine.  
   Open the project in a compatible IDE (like Visual Studio Code) and start the DevContainer environment.

2. **ContainerLab Setup:**
   - Direct Installation: Install ContainerLab on your host machine.
   - Via Terraform, documentation avalaible [here](https://github.com/MasqAs/AWS-ContainerLab-Deployment)

3. **Start the Lab:**
   - Navigate to the project directory.
   - Add Arista image to Docker `docker import network_images/cEOS64-lab-4.32.0.1F.tar.xz ceos:4.32.0.1F`
   - Run `sudo containerlab deploy -t lab_vxlan.yml` to deploy the lab topology.

## Usage

- Once the lab is deployed, you can access the individual nodes (spines and leaves) via CLI or SSH to configure and test VXLAN-EVPN functionalities.
- Use the `hosts` directory to modify or apply specific configurations.

## Known Issues

On Alpine Linux hosts 1 and 2, it is necessary to install the vlan package:

```bash
apk add vlan
```