An automated solution to deploy a Cisco MP-BGP fabric integrated with a Kubernetes cluster. This project leverages Terraform for infrastructure provisioning, NetBox as the source of truth, Ansible for configuration management, and Jenkins for continuous integration and deployment.
This repository provides an end-to-end automation pipeline that:
- Provisions network infrastructure using Terraform.
- Populates NetBox with the infrastructure details.
- Utilizes NetBox as a dynamic inventory for Ansible.
- Applies configurations to Cisco switches using Ansible.
- Automates the entire workflow through Jenkins pipelines.([GitHub][1], [NetBox Labs][2], [GitHub][3])
The solution is structured into the following components:([osism.tech][4])
- Terraform Modules: Located in the
terraform-netbox/directory, these modules define the network topology and resources, interfacing with NetBox to register devices and configurations. - NetBox: Acts as the single source of truth, storing detailed information about the network infrastructure.
- Ansible Playbooks: Found in the
ansible/directory, these playbooks retrieve inventory data from NetBox and apply configurations to the network devices. - Jenkins Pipeline: Defined in the
Jenkinsfile, it orchestrates the automation process, triggering Terraform and Ansible tasks upon code changes.([GitHub][5], [Cisco DevNet][6], [Cisco Blogs][7])
Ensure the following tools are installed and configured:
- Terraform
- NetBox
- Ansible
- Jenkins
- Cisco switches supporting MP-BGP in Spine-Leaf Architecture
- K8s Servers
git clone https://github.com/devogs/fabric.git
cd fabric- Install and set up NetBox following the official documentation.
- Ensure the NetBox API is accessible and obtain an API token.
-
Navigate to the
terraform-netbox/directory. -
Initialize Terraform:([YouTube][8])
terraform init-
Configure the
terraform.tfvarsfile with your environment-specific variables. -
Apply the Terraform configuration:([Cisco Blogs][7])
terraform applyThis step provisions the network infrastructure and populates NetBox with the relevant data.([NetBox Labs][2])
-
Ensure the
ansible.cfgfile is set to use NetBox as the dynamic inventory source. -
Install the required Ansible collections:([NetBox Labs][2], [Ansible Documentation][9])
ansible-galaxy collection install netbox.netbox- Navigate to the
ansible/directory and run the playbooks:([Reddit][10])
ansible-playbook site.ymlThis applies the necessary configurations to the Cisco switches based on the data from NetBox.
- Install Jenkins and the necessary plugins (e.g., Pipeline, Git, Ansible).
- Configure Jenkins credentials and environment variables as needed.
- Create a new Jenkins pipeline job and point it to this repository.
- Use the provided
Jenkinsfileto define the pipeline stages.
Upon committing changes to the repository, Jenkins will automatically trigger the pipeline, executing Terraform and Ansible tasks accordingly.([GitHub][1])
fabric/
├── ansible/
│ ├── inventory/
│ ├── playbooks/
│ └── ansible.cfg
├── terraform-netbox/
│ ├── main.tf
│ ├── variables.tf
│ └── terraform.tfvars
├── Jenkinsfile
├── requirements.txt
└── README.md
Contributions are welcome! Please fork the repository and submit a pull request with your enhancements.
This project is licensed under the MIT License. See the LICENSE file for details.