Code ExchangeSearchRepository

Automation webinar (cisco aci, nxos, vmware with more)

published

webinar_part_1

video: https://www.miradot.se/post/automation-webinar-del-1

Ansible

Prerequisites

  • Ansible installed on local machine
  • Cisco ACI
  • One or more target machines

Use Case Description

aci.yml

  • Creates ACI Tenant
  • Creates ACI VRF
  • Creates ACI Bridge Domain
  • Creates ACI Subnet on Bridge Domain
  • Creates ACI Application Profile
  • Creates ACI Endpoint Group(s)
  • Creates ACI Contract(s), Subject(s), Filter(s)
  • Creates ACI Contract(s) to EPG binding(s)

server.yml

  • Runs apt-update
  • Installs apache2
  • Removes old index.html
  • Copies new index.html from roles/webserver/files to target machine(s)

Installation

These installation instructions assumes you have a python environment with python-pip installed.

pip3 install -r requirements.txt
(OPTION 1) python3 setup_aci.py 
(OPTION 2) python3 setup_server.py

Usage

(OPTION 1) ansible-playbook aci.yml -i hosts 
(OPTION 2) ansible-playbook server.yml -i hosts

Terraform

Prerequisites

  • Terraform installed on local machine
  • Cisco ACI
  • VMware
  • VMware template (Ubuntu, called ubuntu_template)
  • Cisco ACI to VMware VMM integration

Use Case Description

  • Creates ACI Tenant
  • Creates ACI VRF
  • Creates ACI Bridge Domains
  • Creates ACI Subnet on Bridge Domains
  • Creates ACI Application Profile
  • Creates ACI Endpoint Groups
  • Creates ACI Contracts, Subjects, Filters
  • Creates ACI Contracts to EPG bindings
  • Clones VMware ubuntu_template and spins up two VMs

Installation

python3 setup_tf.py

Usage

Make changes to aci.tf and vmware.tf to your choosing (or use examples).

terraform init
terraform plan
terraform apply ; yes
(OPTIONAL, USE WITH CARE) terraform destroy ; yes

Infrastructure-as-code using Ansible, Terraform and Gitlab CI/CD

Prerequisites

  • Self-hosted Gitlab
  • Cisco ACI
  • VMware
  • VMware template (Ubuntu, called ubuntu_template)
  • Cisco ACI to VMware VMM integration

Use Case Description

  • Creates ACI Tenant
  • Creates ACI VRF
  • Creates ACI Bridge Domains
  • Creates ACI Subnet on Bridge Domains
  • Creates ACI Application Profile
  • Creates ACI Endpoint Groups
  • Creates ACI Contracts, Subjects, Filters
  • Creates ACI Contracts to EPG bindings
  • Clones VMware template and spins up two VMs (web and db)
  • Runs two ansible-playbooks
    • web: will install apache2 and copy demo website
    • db: will install mariadb and inject demo data

Installation

These installation instructions assumes you have a python environment with python-pip installed.

pip3 install -r requirements.txt
python3 setup_iac.py

Usage

Make changes to aci.tf and vmware.tf to your choosing (or use examples).  

Create a project in gitlab  
  CI/CD variables needed:  
    - ANSIBLE_VAULT_PASSWORD ; Password chosen in setup_iac.py (-pv) 
    - CI_PUSH_TOKEN ; User settings > Access Tokens > Choose a Name and check "write_repository"
    - CI_PUSH_USER ; <gitlab user>
    - CI_PUSH_URL ; <gitlab_fqdn>
    - CI_PROJECT_NAME ; <project name>
    - TF_ACI_PASS ; ACI Password
    - TF_VC_PASS ; vCenter Password

git clone <project url>
cp -r 3.0_iac/ <folder in step above>
cd <folder in step above>
git add .
git commit -m "my awesome iac"
git push

webinar_part_2

video: https://www.miradot.se/post/automation-webinar-del-2

NXOS with ansible and Gitlab CD/CD

Prerequisites:

  • Ansible installed on local machine
  • Cisco Nexus (VM or Hardware)
  • Self-hosted Gitlab

Use Case Description

Will gather information from specified NXOS devices and parse the configuration. After the configuration and files
has been pushed to gitlab it's possible to manage the device(s) with git.

Installation

These installation instructions assumes you have a python environment with python-pip installed.

pip3 install -r requirements.txt
python3 setup.py

Create a project in gitlab
  CI/CD variables needed:
      ANSIBLE_VAULT_PASSWORD ; Password chosen in setup_iac.py (-pv) 

git clone <url to git project>
cp -r 1.0_nxos_existing_no_netbox/ <folder in step above>
cd <folder in step above>/ansible

Usage

ansible-playbook init.yml -i hosts --ask-vault-pass ; Password chosen in setup.py (-pv)
cd ..
git add .
git commit -m "[skip ci] new host_vars"
git push

Make changes to the ansible/host_vars files according to preferences.

git add .
git commit -m "changes"
git push

NXOS with Ansible, Netbox and Gitlab CI/CD

Prerequisites:

  • Ansible installed on local machine
  • Cisco Nexus (VM or Hardware)
  • Self-hosted Gitlab
  • Self-hosted Netbox

Use Case Description

Will gather information from specified NXOS devices and parse the configuration. After the configuration and files
has been pushed to gitlab it's possible to manage the device(s) with git and Netbox.

Netbox support:

  • Name change
  • Description change
  • Access vlan change

Installation

these installation instructions assumes you have a python environment with python-pip installed.

pip3 install -r requirements.txt
python3 setup.py
scp netbox_tools/webhook_proxy_svc.py <netbox>

ssh <netbox>
    screen
    gunicorn -b :5000 --access-logfile - --error-logfile - webhook_proxy_svc:app
    ctrl + a + d
    exit

https://<netbox>/admin/extras/webhook/
    Name: interfaces_update
    Object types: dcim > interface
    Enabled checked
    Type create checked
    Type update checked
    URL: http://localhost:5000/netbox_webhook/
    HTTP method: POST
    HTTP content type: application/json
    Body template: {"msg": "interfaces updated"}

Create a project in gitlab
    CI/CD variables needed:
      ANSIBLE_VAULT_PASSWORD ; Password chosen in setup_iac.py (-pv) 
    Create a pipeline trigger    

git clone <project url>
cp -r 2.0_nxos_existing_with_netbox/ <folder in step above>
cd <folder in step above>/ansible

Usage

ansible-playbook init.yml -i hosts --ask-vault-pass ; Password chosen in setup.py (-pv)
cd ..
git add .
git commit -m "[skip ci] new host_vars"
git push

Make changes to the ansible/host_vars files according to preferences. 

git add .
git commit -m "changes"
git push

OR make Name/Interface changes in Netbox according to preferences

OR make changes with sommerjobber tool: python3 netbox_tools/tool.py

Getting help

If you have questions, concerns, bug reports, etc., please create an issue against this repository.

Getting involved

This project is supposed to work as examples to get started with automation in several areas. If you have any suggestions on what else to include, feel free to reach ut by creating an issue.

Licensing info

Copyright (c) 2020, Miradot AB

This code is licensed under the MIT License. See LICENSE for details.

View code on GitHub
Related code repos

    Code Exchange Community

    Get help, share code, and collaborate with other developers in the Code Exchange community.View Community
    Disclaimer:
    Cisco provides Code Exchange for convenience and informational purposes only, with no support of any kind. This page contains information and links from third-party websites that are governed by their own separate terms. Reference to a project or contributor on this page does not imply any affiliation with or endorsement by Cisco.