This repo contains a set of tools to automate workflows and build CI/CD pipelines for Cisco SDWAN.
Note: The tools in this repo only work from a Unix environment with Docker (e.g. Linux, MacOS, etc.) due to issues with Ansible and file permissions mapping between Windows and the Linux container used in play.sh. WSL2 may fix this issue and we will revisit when WSL2 is released.
All operations are run out of the sdwan-devops directory: cd sdwan-devops
The folder sdwan-edge allows the deployment of C8000v in AWS, Azure, GCP. Openstack and VMware.
The folder sdwan-terraform allows the deployment of SDWAN Controllers in AWS, Azure and VMware.
A video demonstration of the use of this repository is available on Vidcast.
Clone the sdwan-devops repo using the main branch (default: origin/main):
git clone --single-branch --recursive https://github.com/ciscodevnet/sdwan-devops.gitMake sure you use --recursive to also clone folders sdwan-edge and terraform-sdwan.
If you are on a Mac: we need openssl version3, while on mac this is LibreSSL.
Upgrade openssl:
brew install openssl@3All software dependencies have been rolled into a Docker container. Ansible playbooks are launched via the container using the play.sh shell script.
All you need is a valid installation of docker on your system.
Note: The Dockerfile included in this repo is used to automatically build the sdwan-devops container image and publish it to the GitHub Container Registry. For a detailed list of the dependencies required to run the playbooks, refer to the Dockerfile.
To run playbooks in this repo, use the play.sh shell script as shown below:
./play.sh <playbook> <options>
This will start the docker container published in the GitHub Container Registry, run the playbooks inside the container and remove it once finished.
The sdwan-devops can be used to instantiates controllers on AWS.
- Deploy vBond, vSmart and vManage controllers in a VPC
- Provides bootstrap configuration
C8000v can be deployed in a transit VPC/VNET in AWS, Azure and GCP, and can also be deployed on VMware and Openstack.
- Generates bootstrap configuration (cloud-init format)
- Creates transit VPC if required
- Deploy C8000v
Simulation can be used for developing new deployments as well as testing changes to current deployments. Simulation capabilities are provided by CML^2 or VMware. The Ansible CML^2 Modules are used to automate deployments in CML^2. The Terraform Modules are used to automate deployments in VMware.