Update documentations
This commit is contained in:
40
README.md
40
README.md
@@ -9,6 +9,10 @@
|
|||||||
|
|
||||||
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.
|
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.
|
||||||
|
|
||||||
|
Here is a schema of the topology:
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
## Project Structure
|
## Project Structure
|
||||||
|
|
||||||
The project directory is structured as follows:
|
The project directory is structured as follows:
|
||||||
@@ -30,22 +34,44 @@ The project directory is structured as follows:
|
|||||||
Open the project in a compatible IDE (like Visual Studio Code) and start the DevContainer environment.
|
Open the project in a compatible IDE (like Visual Studio Code) and start the DevContainer environment.
|
||||||
|
|
||||||
2. **ContainerLab Setup:**
|
2. **ContainerLab Setup:**
|
||||||
- Direct Installation: Install ContainerLab on your host machine.
|
- Direct Installation: Install ContainerLab on your host machine. Follow the [official installation guide](https://containerlab.dev/install/).
|
||||||
- Via Terraform, documentation avalaible [here](https://github.com/MasqAs/AWS-ContainerLab-Deployment)
|
- Via Terraform: Documentation available [here](https://github.com/MasqAs/AWS-ContainerLab-Deployment).
|
||||||
|
|
||||||
3. **Start the Lab:**
|
3. **Start the Lab:**
|
||||||
- Navigate to the project directory.
|
1. 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`
|
2. Add the Arista image to Docker:
|
||||||
- Run `sudo containerlab deploy -t lab_vxlan.yml` to deploy the lab topology.
|
|
||||||
|
```bash
|
||||||
|
docker import network_images/cEOS64-lab-4.32.0.1F.tar.xz ceos:4.32.0.1F
|
||||||
|
```
|
||||||
|
|
||||||
|
3. Deploy the lab topology:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo containerlab deploy -t lab_vxlan.yml
|
||||||
|
```
|
||||||
|
|
||||||
## Usage
|
## 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.
|
- 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.
|
- Use the `hosts` directory to modify or apply specific configurations for end user hosts
|
||||||
|
- To list the nodes deployed via the `lab_vxlan.yml`:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
containerlab inspect --name vxlan-evpn-irb
|
||||||
|
````
|
||||||
|
|
||||||
|
- Example command to configure a VXLAN interface:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
show bgp summary
|
||||||
|
```
|
||||||
|
|
||||||
|
The configurations to apply on each node are listed [here](documentation/eos_configuration).
|
||||||
|
|
||||||
## Known Issues
|
## Known Issues
|
||||||
|
|
||||||
On Alpine Linux hosts 1 and 2, it is necessary to install the vlan package:
|
To install the VLAN package on Alpine Linux hosts 1 and 2, follow these steps:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
apk add vlan
|
apk add vlan
|
||||||
|
|||||||
1
documentation/assets/images/VXLAN.svg
Normal file
1
documentation/assets/images/VXLAN.svg
Normal file
File diff suppressed because one or more lines are too long
|
After Width: | Height: | Size: 30 KiB |
@@ -1,4 +1,4 @@
|
|||||||
name: vxlan-evpn-l2
|
name: vxlan-evpn-irb
|
||||||
topology:
|
topology:
|
||||||
nodes:
|
nodes:
|
||||||
spine1:
|
spine1:
|
||||||
|
|||||||
Reference in New Issue
Block a user