anubisg1 / cisco-vxlan-evpn-ansible

Ansible automation for deployment and management of VXLAN-EVPN Fabric on Cat9k or Nexus9k using validated design and an high degreed of abstraction

Cisco VXLAN-EVPN Ansible Playbooks

Disclaimer

This project is based on https://github.com/Cat9kEVPN/cat9k-evpn-ansible but with the goal to provide a much simpler abstraction for the end user

Prerequisites

To run those ansibles playbook, you will require:

Hardware:

• A linux server (Fedora, Ubuntu, RedHat, etc)
• Supported hardware:
  • Catalayst 9000 (Tested with 9300 and 9500 series)
    • network-advantage license
    • IOS-XE version >= 17.03 for leafs or >= 17.11 for the spines ( required by the dynamic peering configuration )

Network-Expertise:

• Basic network knowledge (network design, bring up of cat9k switches)
• Basic understanding of YAML
• Basic understanding of Python
• Basic linux command line use

General description

Installation

It is recommended to run the project in the virtual environment.

Below you can find installation steps for Linux (ubuntu) server

• Install python3

    sudo apt install python3 python3.10-venv

• Create the python virtual environment. In this example the virtual environment will be created in the folder virtual-env/ansible

    python3 -m venv ansible

More details could be found here

• Activate virtual environment.

    source ansible/bin/activate

• Clone the repository

    git clone https://github.com/anubisg1/cisco-vxlan-evpn-ansible.git

• Go to project directory

    cd cisco-vxlan-evpn-ansible

• Install pip if it is not already installed

    sudo apt install pip

• Install all necessary packages

    pip install -r requirements.txt

• Next step ...

    cd cat9k-playbooks
    ansible-playbook -i ../inventory playbook_xxx.yaml
    ansible-playbook -i ../inventory -e ansible_ssh_pass=xxx playbook_xxx.yaml