Fully L3 & Automated BGP fabric

Introduction

This repository provides Ansible playbook and templates to deploy a fully L3 fabric based on BGP (using FreeRangeRouting) on the free test Lab "Cumulus In The Cloud" platform.

Of course, you can re-use this project in any Linux based platform/topology by customizing the hosts and host_vars files.

The topology

Assuming you are playing with "Cumulus In The Cloud/CITC" platform, you'll maybe have a hard time finding the actual interfaces used on the spines/leafs (I had to look into the deployment source code of CITC). To save you some time, here is the detailed physical topology:, you'll find the following diagram (provided by Cumulus) when launching the simulation (This is new since the beginning of 2020) :

Note that servers are using Ubuntu 18.04.3 LTS & spine/leaf are using Cumulus Linux 3.7.8 at this moment [02/02/2020]

How-to

From the oob-mgmt-server :

git clone https://github.com/jpmondet/FullyAutomatedBGPfabric.git

cd FullyAutomatedBGPfabric

ansible-playbook deploy_network.yml 

And Voilà, you can start to play with BGP and your new network ! :-)

UPDATE 09/2020: As of now, CITC doesn't provide directly an easy way to ssh from your computer to the oob-mgmt-server.
If you still prefer ssh from your computer instead of using (horrible) browser consoles, you have to:

• Connect first with the browser console to the oob-mgmt-server
• It prompts you to change the password.
• Then, 2 options :
  • On your computer, generate a public key and paste the public part in the .ssh/id_rsa.pub file on the oob-mgmt-server
  • Or edit the /etc/sshd_config of the oob-mgmt-server and allow the PasswordAuthentication
• After that, on your CITC dashboard, you have to add a new ssh service to oob-mgmt-server:eth0 to get a generated remote port you can connect to from your computer.
• Finally, from your computer, ssh -p GENERATED_REMOTE_PORT [email protected]

Options

• Fully IPv4

  By default, the playbook assigns IPv4 addresses on interfaces and negociates IPv4 Address Family during BGP sessions establishment.

• Fully IPv6

  By using the option IPv6, the playbook will activate Link-Local IPv6 addresses on interfaces and will negociate IPv6 Address Family during BGP sessions establishment.

ansible-playbook deploy_network.yml -e "option=ipv6"

• RFC 5549

  By using the option RFC5549, the playbook will activate Link-Local IPv6 addresses on interfaces and will negociate IPv4 Address Family during BGP sessions establishment.

`ansible-playbook deploy_network.yml -e "option=5549"`