Using Ansible to automate Cisco ACI in Windows

Some instructions on how to get started with using the ansible to automate Cisco ACI specifically by using ansible playbooks to accomplish basic tasks. Using the Cisco ACI GUI can be time-consuming and error prone, a more efficient could be to automate the process using ansible playbooks. Ansible is essentially an automation tool that uses playbooks consisting of Yaml files to automate the process of network configuration via connection to the APIC REST interface and push the config API commands. Really useful link for how to get your Windows environment set up for using ansible, including Cygwin and Linux virtual machines: https://phoenixnap.com/kb/install-ansible-on-windows#htoc-method-1-using-cygwin I have found the Cygwin approach to work perfectly fine for running ansible. In fact, I recommend Cygwin as the way to go in running ansible in your Windows environment, given that all my attempts to install via 'pip install' commands failed. The number of Stack Overflow posts reporting similar problems will testify to this. To cd to a C:\ drive using Cygwin use this: [code language="trext" 1="/cygdrive/c" 2="[/code"] For this post I installed ansible via enabling Ubuntu on Windows as yet another alternative approach. This is adequately described on the previous link, but summarised as follows. To install, first type in- and search for 'Turn Windows features on or off' in your Start menu, select the 'Windows Subsystem for Linux' checkbox option, click OK and restart your machine for the change to take effect. Then open Microsoft Store via the Start menu , type in 'Ubuntu' and install. Once installed, use the following command line instructions to install ansible: [code language="xml"] $ sudo apt-get update $ sudo apt-get install software-properties-common $ sudo apt-add-repository ppa:ansible/ansible $ sudo apt-get update $ sudo apt-get install ansible -y [/code] Some example inventory and Yaml files here: inventory.txt [code language="xml"] [apic] sandboxapicdc.cisco.com username=admin password=!v3G@!4@Y [/code] tenants.yml Some Yaml playbook code to list all of the tenant information contained in the example Cisco ACI sandbox: [code language="xml"] - name: Query all tenants hosts: apic connection: local gather_facts: no tasks: - name: TASK 1 - GATHER TENANTS aci_tenant: hostname: "{{ inventory_hostname }}" username: "{{ username }}" password: "{{ password }}" validate_certs: no state: query [/code] To run this ansible playbook, launch the Ubuntu terminal and navigate to the Windows directory to where your inventory and .yml files are stored. An easy way to navigate to the folder is to open the contents of the Windows folder in File Explorer and type 'bash' in the address bar: Then hit Enter. This will provide the address you need to cd to: Now run the following ansible command: [code language="xml"] ansible-playbook -i inventory.txt tenants.yml -v [/code] This returns the Tenants as a set of JSON objects as shown: As viewed in json-prettified format in Notepad++: More ansible examples. specificTenant.yml A task to return just the data about the tenant called infra. [code language="xml"] - name: Query a specific tenant hosts: apic connection: local gather_facts: no tasks: - name: TASK 1 - SPECIFIC TENANTS aci_tenant: hostname: "{{ inventory_hostname }}" username: "{{ username }}" password: "{{ password }}" validate_certs: no state: query tenant: infra [/code] JSON Output: [code language="xml"] ok: [sandboxapicdc.cisco.com] => { "ansible_facts": { "discovered_interpreter_python": "/usr/bin/python3" }, "changed": false, "current": [{ "fvTenant": { "attributes": { "annotation": "", "childAction": "", "descr": "", "dn": "uni/tn-infra", "extMngdBy": "", "lcOwn": "local", "modTs": "2022-04-04T10:29:55.139+00:00", "monPolDn": "uni/tn-common/monepg-default", "name": "infra", "nameAlias": "", "ownerKey": "", "ownerTag": "", "status": "", "uid": "0", "userdom": "all" } } } ] } [/code] epgs.yml A task to return all EPG information from an existing ACI fabric. [code language="xml"] - name: Query all EPGs hosts: apic connection: local gather_facts: no tasks: - name: TASK 1 - GATHER EPGs aci_epg: hostname: "{{ inventory_hostname }}" username: "{{ username }}" password: "{{ password }}" validate_certs: no state: query [/code] JSON Output: [code language="xml"] ok: [sandboxapicdc.cisco.com] => { "ansible_facts": { "discovered_interpreter_python": "/usr/bin/python3" }, "changed": false, "current": [{ "fvAEPg": { "attributes": { "annotation": "", "childAction": "", "configIssues": "", "configSt": "applied", "descr": "", "dn": "uni/tn-infra/ap-ave-ctrl/epg-ave-ctrl", "exceptionTag": "", "extMngdBy": "", "floodOnEncap": "disabled", "fwdCtrl": "", "hasMcastSource": "no", "isAttrBasedEPg": "no", "isSharedSrvMsiteEPg": "no", "lcOwn": "local", "matchT": "AtleastOne", "modTs": "2022-04-04T10:30:32.198+00:00", "monPolDn": "uni/tn-common/monepg-default", "name": "ave-ctrl", "nameAlias": "", "pcEnfPref": "unenforced", "pcTag": "32771", "pcTagAllocSrc": "idmanager", "prefGrMemb": "exclude", "prio": "unspecified", "scope": "2523136", "shutdown": "no", "status": "", "triggerSt": "triggerable", "txId": "5764607523034234882", "uid": "0", "userdom": "all" }, "children": [{ "fvRsBd": { "attributes": { "annotation": "", "childAction": "", "extMngdBy": "", "forceResolve": "yes", "lcOwn": "local", "modTs": "2022-04-04T10:29:55.139+00:00", "monPolDn": "uni/tn-common/monepg-default", "rType": "mo", "rn": "rsbd", "state": "formed", "stateQual": "none", "status": "", "tCl": "fvBD", "tContextDn": "", "tDn": "uni/tn-infra/BD-ave-ctrl", "tRn": "BD-ave-ctrl", "tType": "name", "tnFvBDName": "ave-ctrl", "uid": "0", "userdom": "all" }, "children": [{ "fvSubnetBDDefCont": { "attributes": { "bddefDn": "uni/bd-[uni/tn-infra/BD-ave-ctrl]-isSvc-no", "childAction": "deleteNonPresent", "lcOwn": "local", "modTs": "2022-04-04T10:29:49.718+00:00", "monPolDn": "", "name": "", "nameAlias": "", "rn": "subnetBddefDn-[uni/bd-[uni/tn-infra/BD-ave-ctrl]-isSvc-no]", "status": "" } } } ] } }, { "fvRsCustQosPol": { "attributes": { "annotation": "", "childAction": "", "extMngdBy": "", "forceResolve": "yes", "lcOwn": "local", "modTs": "2022-04-04T10:29:55.139+00:00", "monPolDn": "uni/tn-common/monepg-default", "rType": "mo", "rn": "rscustQosPol", "state": "formed", "stateQual": "default-target", "status": "", "tCl": "qosCustomPol", "tContextDn": "", "tDn": "uni/tn-common/qoscustom-default", "tRn": "qoscustom-default", "tType": "name", "tnQosCustomPolName": "", "uid": "0", "userdom": "all" } } } ] } }, { "fvAEPg": { "attributes": { "annotation": "", "childAction": "", "configIssues": "", "configSt": "applied", "descr": "", "dn": "uni/tn-infra/ap-access/epg-default", "exceptionTag": "", "extMngdBy": "", "floodOnEncap": "disabled", "fwdCtrl": "", "hasMcastSource": "no", "isAttrBasedEPg": "no", "isSharedSrvMsiteEPg": "no", "lcOwn": "local", "matchT": "AtleastOne", "modTs": "2022-04-04T10:30:31.824+00:00", "monPolDn": "uni/tn-common/monepg-default", "name": "default", "nameAlias": "", "pcEnfPref": "unenforced", "pcTag": "16387", "pcTagAllocSrc": "idmanager", "prefGrMemb": "exclude", "prio": "unspecified", "scope": "16777199", "shutdown": "no", "status": "", "triggerSt": "triggerable", "txId": "5764607523034234882", "uid": "0", "userdom": "all" }, "children": [{ "fvRsBd": { "attributes": { "annotation": "", "childAction": "", "extMngdBy": "", "forceResolve": "yes", "lcOwn": "local", "modTs": "2022-04-04T10:29:55.139+00:00", "monPolDn": "uni/tn-common/monepg-default", "rType": "mo", "rn": "rsbd", "state": "formed", "stateQual": "none", "status": "", "tCl": "fvBD", "tContextDn": "", "tDn": "uni/tn-infra/BD-default", "tRn": "BD-default", "tType": "name", "tnFvBDName": "default", "uid": "0", "userdom": "all" }, "children": [{ "fvSubnetBDDefCont": { "attributes": { "bddefDn": "uni/bd-[uni/tn-infra/BD-default]-isSvc-no", "childAction": "deleteNonPresent", "lcOwn": "local", "modTs": "2022-04-04T10:29:49.718+00:00", "monPolDn": "", "name": "", "nameAlias": "", "rn": "subnetBddefDn-[uni/bd-[uni/tn-infra/BD-default]-isSvc-no]", "status": "" } } } ] } }, { "fvRsCustQosPol": { "attributes": { "annotation": "", "childAction": "", "extMngdBy": "", "forceResolve": "yes", "lcOwn": "local", "modTs": "2022-04-04T10:29:55.139+00:00", "monPolDn": "uni/tn-common/monepg-default", "rType": "mo", "rn": "rscustQosPol", "state": "formed", "stateQual": "default-target", "status": "", "tCl": "qosCustomPol", "tContextDn": "", "tDn": "uni/tn-common/qoscustom-default", "tRn": "qoscustom-default", "tType": "name", "tnQosCustomPolName": "", "uid": "0", "userdom": "all" } } } ] } } ] } [/code]

Comments

Post a Comment

Popular posts from this blog

Using the Supervisor Controller Pattern to access View controls in MVVM

Image
As discussed on a StackOverflow post , this is considered bad practice, so only use this when necessary. Step 1: Create a new WPF project Step 2: Add event handling code A number of classes are needed for doing command bindings in MVVM. Create the following classes and add to your Visual Studio project: RelayCommand.cs [code language="csharp"] using System; using System.Windows.Input; namespace SupervisorControllingPattern { public class RelayCommand<T> : ICommand { private readonly Predicate<T> _canExecute; private readonly Action<T> _execute; public RelayCommand(Action<T> execute) : this(execute, null) { _execute = execute; } public RelayCommand(Action<T> execute, Predicate<T> canExecute) { if (execute == null) throw new ArgumentNullException(nameof(execute)); _execute = execute; _canExecute = canExecute; ...
Read more

Getting started with client-server applications in C++

Image
A demonstration of simple Internet client-server applications in C++ (Linux-based). The client application tries to connect to the remote server application using the IP address of the remote server ('localhost' or 127.0.0.1) and the server port number which defaulted to 1234. The server application listens to port number 1234 for a connection request. When the server application receives the connection request it sends the text message "Hello!\r\n" to the client.
Read more

How to send an e-mail via Google SMTP using C#

Image
First things first, some useful StackOverflow links: https://stackoverflow.com/questions/9201239/send-e-mail-via-smtp-using-c-sharp https://stackoverflow.com/questions/17462628/the-server-response-was-5-7-0-must-issue-a-starttls-command-first-i16sm1806350 To demonstrate how this is done I first create a new Visual Studio project: Some example code for sending an email via a Google email account (smtp.goolgle.com) - obviously replace this with email / credentials of your own... I put the code within a try-catch block in order to capture any errors that may occur while attempting this. [code language="csharp"] using System; using System.Net; using System.Net.Mail; namespace EmailSmtp { class Program { static void Main(string[] args) { try { // Credentials var credentials = new NetworkCredential("someEmail@gmail.com", "somePassword"); // Mail message var ...
Read more